

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Avvio di uno schema nella console AWS AppSync
<a name="schema-launch-start"></a>

In questo esempio, creerai un'`Todo`API che consente agli utenti di creare `Todo` articoli per promemoria delle faccende quotidiane come o. *Finish task* *Pick up groceries* Questa API dimostrerà come utilizzare le operazioni GraphQL in cui lo stato persiste in una tabella DynamoDB.

Concettualmente, ci sono tre passaggi principali per creare la tua prima API GraphQL. È necessario definire lo schema (tipi e campi), collegare le fonti di dati ai campi, quindi scrivere il resolver che gestisca la logica aziendale. Tuttavia, l'esperienza della console cambia l'ordine. Inizieremo definendo come vogliamo che la nostra fonte di dati interagisca con il nostro schema, quindi definiremo lo schema e il resolver in un secondo momento.

**Per creare la tua API GraphQL**

1. Accedi a Console di gestione AWS e apri la [AppSync console](https://console.aws.amazon.com/appsync/). 

1. Nel **pannello di controllo**, scegliere **Create API (Crea API)**.

1. Mentre **GraphQL APIs** è selezionato, scegli **Design da zero**. Quindi, seleziona **Successivo**.

1. **Per **il nome dell'API**, modifica il nome precompilato in**Todo API**, quindi scegli Avanti.**
**Nota**  
Qui sono presenti anche altre opzioni, ma non le useremo per questo esempio.

1. Nella sezione **Specificare le risorse GraphQL**, procedi come segue:

   1. Scegli **ora Crea tipo supportato da una tabella DynamoDB**.
**Nota**  
Ciò significa che creeremo una nuova tabella DynamoDB da allegare come origine dati.

   1. Nel campo **Nome modello**, immettere. **Todo**
**Nota**  
Il nostro primo requisito è definire il nostro schema. Questo **nome del modello** sarà il nome del tipo, quindi quello che stai realmente facendo è creare una `type` chiamata `Todo` che esisterà nello schema:  

      ```
      type Todo {}
      ```

   1. In **Campi**, procedi come segue:

      1. Create un campo denominato**id**, con il tipo `ID` e il campo obbligatorio impostato su`Yes`.
**Nota**  
Questi sono i campi che esisteranno nell'ambito del tuo `Todo` tipo. Il nome del tuo campo qui verrà chiamato `id` con un tipo di`ID!`:  

         ```
         type Todo {
         	id: ID!
         }
         ```
AWS AppSync supporta più valori scalari per diversi casi d'uso. 

      1. Utilizzando **Aggiungi nuovo campo**, crea quattro campi aggiuntivi con i `Name` valori impostati su**name**, **when****where**, e**description**. `Type`I loro valori saranno`String`, e i `Required` valori `Array` and saranno entrambi impostati su`No`. Corrisponderà a quanto segue:  
![\[Model information form showing fields for a Todo model with ID, name, when, where, and description.\]](http://docs.aws.amazon.com/it_it/appsync/latest/devguide/images/model-information-tutorial.png)
**Nota**  
Il tipo completo e i relativi campi avranno il seguente aspetto:  

         ```
         type Todo {
         	id: ID!
         	name: String
         	when: String
         	where: String
         	description: String
         }
         ```
Poiché stiamo creando uno schema utilizzando questo modello predefinito, verrà inoltre popolato con diverse mutazioni standard basate sul tipo, ad esempio `create``delete`, e `update` per aiutarti a popolare facilmente la tua fonte di dati.

   1. In **configura la tabella del modello, inserisci un nome di tabella**, ad esempio. **TodoAPITable** Imposta la **chiave primaria** su`id`.
**Nota**  
Stiamo essenzialmente creando una nuova tabella DynamoDB *TodoAPITable* chiamata che verrà allegata all'API come fonte di dati principale. La nostra chiave primaria è impostata sul `id` campo richiesto che abbiamo definito in precedenza. Nota che questa nuova tabella è vuota e non contiene nulla tranne la chiave di partizione.

   1. Scegli **Next (Successivo)**.

1. Controlla le modifiche e scegli **Crea API**. Attendi un momento per consentire al AWS AppSync servizio di completare la creazione della tua API.

Hai creato con successo un'API GraphQL con il relativo schema e l'origine dati DynamoDB. Per riassumere i passaggi precedenti, abbiamo scelto di creare un'API GraphQL completamente nuova. Abbiamo definito il nome dell'API, quindi aggiunto la definizione dello schema aggiungendo il nostro primo tipo. Abbiamo definito il tipo e i relativi campi, quindi abbiamo scelto di allegare un'origine dati a uno dei campi creando una nuova tabella DynamoDB senza dati.