本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 AWS AppSync 控制台中启动架构
<a name="schema-launch-start"></a>

在此示例中，您将创建一个 `Todo` API，允许用户为诸如*Finish task*或*Pick up groceries*之类的日常琐事提醒创建`Todo`项目。该 API 将说明如何使用 GraphQL 操作，其中状态持久保留在 DynamoDB 表中。

从概念上讲，需要三个主要步骤以创建第一个 GraphQL API。您必须定义架构（类型和字段），将数据来源附加到字段，然后编写处理业务逻辑的解析器。不过，控制台体验改变了该顺序。我们先定义希望数据来源如何与架构交互，然后定义架构和解析器。

**创建您的 GraphQL API**

1. 登录 AWS 管理控制台 并打开[AppSync 控制台](https://console.aws.amazon.com/appsync/)。

1. 在**控制面板**中，选择**创建 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. 通过使用**添加新字段**，创建 4 个额外的字段，并将`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_cn/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 表，以将该数据来源附加到其中的一个字段。