

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Lancement d'un schéma dans la AWS AppSync console
<a name="schema-launch-start"></a>

Dans cet exemple, vous allez créer une `Todo` API qui permet aux utilisateurs de créer des `Todo` éléments pour les rappels de corvées quotidiennes, tels que *Finish task* ou*Pick up groceries*. Cette API montre comment utiliser les opérations GraphQL lorsque l'état persiste dans une table DynamoDB.

Conceptuellement, la création de votre première API GraphQL comporte trois étapes principales. Vous devez définir le schéma (types et champs), associer vos sources de données à vos champs, puis écrire le résolveur qui gère la logique métier. Toutefois, l'expérience de la console modifie l'ordre des choses. Nous allons commencer par définir la manière dont nous voulons que notre source de données interagisse avec notre schéma, puis définirons le schéma et le résolveur ultérieurement.

**Pour créer votre API GraphQL**

1. Connectez-vous à la [AppSync console AWS Management Console et ouvrez-la](https://console.aws.amazon.com/appsync/). 

1. Dans le **Tableau de bord**, choisissez **Créer une API**.

1. Lorsque **GraphQL APIs** est sélectionné, choisissez **Design from scratch**. Ensuite, choisissez **Suivant**.

1. Pour le **nom de l'API**, remplacez le nom prérempli par**Todo API**, puis choisissez **Next**.
**Note**  
D'autres options sont également présentes ici, mais nous ne les utiliserons pas dans cet exemple.

1. Dans la section **Spécifier les ressources GraphQL**, procédez comme suit :

   1. Choisissez **maintenant Créer un type basé sur une table DynamoDB**.
**Note**  
Cela signifie que nous allons créer une nouvelle table DynamoDB à joindre en tant que source de données.

   1. Dans le champ **Nom du modèle**, entrez**Todo**.
**Note**  
Notre première exigence est de définir notre schéma. Ce **nom de modèle** sera le nom du type, donc ce que vous faites réellement est de créer un `type` appel `Todo` qui existera dans le schéma :  

      ```
      type Todo {}
      ```

   1. Sous **Champs**, procédez comme suit :

      1. Créez un champ nommé**id**, avec le type et `ID` le champ requis définis sur`Yes`.
**Note**  
Ce sont les champs qui existeront dans le cadre de votre `Todo` type. Le nom de votre champ ici sera appelé `id` avec un type de `ID!` :  

         ```
         type Todo {
         	id: ID!
         }
         ```
AWS AppSync prend en charge plusieurs valeurs scalaires pour différents cas d'utilisation. 

      1. À l'aide de l'option **Ajouter un nouveau champ**, créez quatre champs supplémentaires avec les `Name` valeurs définies sur **name** **when****where**,, et**description**. Leurs `Type` valeurs seront`String`, et les `Required` valeurs `Array` et seront toutes deux définies sur`No`. Il doit ressembler à ce qui suit :  
![\[Model information form showing fields for a Todo model with ID, name, when, where, and description.\]](http://docs.aws.amazon.com/fr_fr/appsync/latest/devguide/images/model-information-tutorial.png)
**Note**  
Le type complet et ses champs ressembleront à ceci :  

         ```
         type Todo {
         	id: ID!
         	name: String
         	when: String
         	where: String
         	description: String
         }
         ```
Comme nous créons un schéma à l'aide de ce modèle prédéfini, il sera également rempli de plusieurs mutations standard basées sur le type`create`, telles que`delete`, et `update` pour vous aider à remplir facilement votre source de données.

   1. Sous **Configurer la table du modèle**, entrez un nom de table, tel que**TodoAPITable**. Définissez la **clé primaire** sur`id`.
**Note**  
Nous créons essentiellement une nouvelle table DynamoDB *TodoAPITable* appelée qui sera attachée à l'API en tant que source de données principale. Notre clé primaire est définie sur le `id` champ obligatoire que nous avons défini auparavant. Notez que cette nouvelle table est vide et ne contient rien d'autre que la clé de partition.

   1. Choisissez **Suivant**.

1. Passez en revue vos modifications et choisissez **Create API**. Patientez un moment pour que le AWS AppSync service termine la création de votre API.

Vous avez créé avec succès une API GraphQL avec son schéma et sa source de données DynamoDB. Pour résumer les étapes ci-dessus, nous avons choisi de créer une toute nouvelle API GraphQL. Nous avons défini le nom de l'API, puis ajouté notre définition de schéma en ajoutant notre premier type. Nous avons défini le type et ses champs, puis choisi d'associer une source de données à l'un des champs en créant une nouvelle table DynamoDB ne contenant aucune donnée.