本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 AWS AppSync 主控台中啟動結構描述
<a name="schema-launch-start"></a>

在此範例中，您將建立 `Todo` API，允許使用者建立每日家務提醒`Todo`的項目，例如*完成任務*或*挑選雜貨*。此 API 將示範如何使用 GraphQL 操作，其中狀態會保留在 DynamoDB 資料表中。

實際上，建立第一個 GraphQL API 有三個主要步驟。您必須定義結構描述 （類型和欄位）、將資料來源連接至 欄位 （然後），然後寫入處理商業邏輯的解析程式。不過，主控台體驗會變更此項目的順序。我們將從定義資料來源與結構描述互動的方式開始，稍後再定義結構描述和解析程式。

**建立 GraphQL API**

1. 登入 AWS 管理主控台 並開啟 [AppSync 主控台](https://console.aws.amazon.com/appsync/)。

1. 在**儀表板**上，選擇 **Create API (建立 API)**。

1. 選取 **GraphQL APIs**時，選擇**從頭開始設計**。然後選擇**下一步**。

1. 針對 **API 名稱**，將預先填入的名稱變更為 **Todo API**，然後選擇**下一步**。
**注意**  
這裡也有其他選項，但我們在此範例中不會使用這些選項。

1. 在**指定 GraphQL 資源**區段中，執行下列動作：

   1. 選擇 **DynamoDB 資料表支援的建立類型**。
**注意**  
這表示我們將建立新的 DynamoDB 資料表，以做為資料來源連接。

   1. 在**模型名稱**欄位中，輸入 **Todo**。
**注意**  
我們的第一個需求是定義我們的結構描述。此**模型名稱**將是類型名稱，因此您實際執行的操作是建立`Todo`將存在於結構描述中的`type`稱為 ：  

      ```
      type Todo {}
      ```

   1. 在**欄位**下，執行下列動作：

      1. 建立名為 的欄位**id**，類型為 `ID`，必要設定為 `Yes`。
**注意**  
這些是將存在於您`Todo`類型範圍內的欄位。系統會呼叫您這裡的欄位名稱`id`，類型為 `ID!`：  

         ```
         type Todo {
         	id: ID!
         }
         ```
AWS AppSync 支援不同使用案例的多個純量值。

      1. 使用**新增欄位**，建立四個額外的欄位，並將`Name`值設定為 **name**、**when**、 **where**和 **description**。其`Type`值將是 `String`，而 `Array`和 `Required`值都會設定為 `No`。其會如下所示：  
![\[Model information form showing fields for a Todo model with ID, name, when, where, and description.\]](http://docs.aws.amazon.com/zh_tw/appsync/latest/devguide/images/model-information-tutorial.png)
**注意**  
完整類型及其欄位如下所示：  

         ```
         type Todo {
         	id: ID!
         	name: String
         	when: String
         	where: String
         	description: String
         }
         ```
由於我們使用這個預先定義的模型建立結構描述，因此它也會根據 `create`、 `delete`和 等類型填入數個樣板變動`update`，以協助您輕鬆填入資料來源。

   1. 在**設定模型資料表**下，輸入資料表名稱，例如 **TodoAPITable**。將**主索引鍵**設定為 `id`。
**注意**  
我們基本上正在建立一個名為 *TodoAPITable* 的新 DynamoDB 資料表，該資料表將連接到 API 作為我們的主要資料來源。我們的主索引鍵設定為我們在此之前定義的必要`id`欄位。請注意，這個新資料表是空白的，除了分割區索引鍵之外，不包含任何內容。

   1. 選擇**下一步**。

1. 檢閱您的變更，然後選擇**建立 API**。等待片刻，讓 AWS AppSync 服務完成建立您的 API。

您已成功建立 GraphQL API 及其結構描述和 DynamoDB 資料來源。為了總結上述步驟，我們選擇建立全新的 GraphQL API。我們定義了 API 的名稱，然後新增第一個類型的結構描述定義。我們定義了類型及其欄位，然後選擇透過建立新的 DynamoDB 資料表來將資料來源連接到其中一個欄位，其中沒有資料。