Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Lanzar un esquema en la consola AWS AppSync
<a name="schema-launch-start"></a>

En este ejemplo, crearás una `Todo` API que permitirá a los usuarios crear `Todo` elementos para recordar las tareas diarias, como *Finish task* o. *Pick up groceries* Esta API muestra cómo utilizar las operaciones de GraphQL cuando el estado persiste en una tabla de DynamoDB.

A nivel teórico, hay tres pasos principales para crear su primera API de GraphQL. Debe definir el esquema (tipos y campos), asociar los orígenes de datos a los campos y, a continuación, escribir el solucionador que gestiona la lógica empresarial. Sin embargo, la experiencia con la consola sugiere que es mejor cambiar este orden. Empezaremos por definir cómo queremos que nuestro origen de datos interactúe con nuestro esquema y, más adelante, definiremos el esquema y el solucionador.

**Para crear su API de GraphQL**

1. [Inicia sesión en la consola Consola de administración de AWS y ábrelaAppSync .](https://console.aws.amazon.com/appsync/) 

1. En el **Panel**, elija **Crear API**.

1. Con **GraphQL APIs** seleccionado, elige **Diseñar desde cero**. A continuación, elija **Siguiente**.

1. En el **Nombre de la API**, cambie el nombre rellenado previamente a **Todo API**. Después, seleccione **Siguiente**.
**nota**  
Hay más opciones presentes aquí, pero no las usaremos en este ejemplo.

1. En la sección **Especificar recursos de GraphQL**, haga lo siguiente:

   1. Seleccione **Crear tipo respaldado por una tabla de DynamoDB ahora**.
**nota**  
Esto significa que vamos a crear una nueva tabla de DynamoDB para asociarla como origen de datos.

   1. En el campo **Nombre del modelo**, escriba **Todo**.
**nota**  
Nuestro primer requisito es definir nuestro esquema. Este **Nombre del modelo** será el nombre del tipo, de modo que lo que realmente está haciendo es crear un `type` llamado `Todo` que existirá en el esquema:  

      ```
      type Todo {}
      ```

   1. En **Campos**, haga lo siguiente:

      1. Cree un campo llamado **id**, con el tipo `ID` y el valor obligatorio establecido en `Yes`.
**nota**  
Estos son los campos que existirán dentro del ámbito de su tipo `Todo`. Aquí, el nombre de su campo se llamará `id` con un tipo de `ID!`:  

         ```
         type Todo {
         	id: ID!
         }
         ```
AWS AppSync admite varios valores escalares para diferentes casos de uso. 

      1. Con **Agregar nuevo campo**, cree cuatro campos adicionales con los valores `Name` definidos como **name**, **when**, **where** y **description**. Sus valores `Type` serán `String`, y los valores `Array` y `Required` se establecerán en `No`. Tendrá un aspecto similar al siguiente:  
![\[Model information form showing fields for a Todo model with ID, name, when, where, and description.\]](http://docs.aws.amazon.com/es_es/appsync/latest/devguide/images/model-information-tutorial.png)
**nota**  
El tipo completo y sus campos tendrán un aspecto similar al siguiente:  

         ```
         type Todo {
         	id: ID!
         	name: String
         	when: String
         	where: String
         	description: String
         }
         ```
Como vamos a crear un esquema con este modelo predefinido, también se rellenará con varias mutaciones reutilizables basadas en el tipo (por ejemplo, `create`, `delete` y `update`) para ayudarle a rellenar el origen de datos fácilmente.

   1. En **Configurar la tabla del modelo**, introduzca un nombre de tabla, como **TodoAPITable**. Establezca la **clave principal** en `id`.
**nota**  
Básicamente, estamos creando una nueva tabla de DynamoDB *TodoAPITable* llamada que se adjuntará a la API como fuente de datos principal. Nuestra clave principal se establece en el campo obligatorio `id` que definimos anteriormente. Tenga en cuenta que esta nueva tabla está en blanco y no contiene nada excepto la clave de partición.

   1. Elija **Siguiente**.

1. Revise los cambios y seleccione **Crear API**. Espere un momento para que el AWS AppSync servicio termine de crear su API.

Ha creado correctamente una API de GraphQL con su esquema y su origen de datos de DynamoDB. Para resumir los pasos anteriores, hemos creado una API de GraphQL completamente nueva. Hemos definido el nombre de la API y, a continuación, hemos agregado nuestra definición de esquema agregando nuestro primer tipo. Hemos definido el tipo y sus campos y, a continuación, hemos optado por asociar un origen de datos a uno de los campos creando una nueva tabla de DynamoDB sin datos.