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

# 入门：在中创建你的第一个 GraphQL API AWS AppSync
<a name="quickstart"></a>

您可以使用 AWS AppSync 控制台来配置和启动 GraphQL API。GraphQL APIs 通常需要三个组件：

1. **GraphQL 架构** - 您的 GraphQL 架构是 API 的蓝图。它定义您可以在执行操作时请求的类型和字段。要使用数据填充架构，您必须将数据来源连接到 GraphQL API。在该快速入门指南中，我们使用预定义的模型创建一个架构。

1. **数据来源** - 这些资源包含用于填充 GraphQL API 的数据。这可以是 DynamoDB 表、Lambda 函数等 AWS AppSync 。支持多种数据源来构建强大且可扩展的 GraphQL。 APIs数据来源链接到架构中的字段。每次对字段执行请求时，来自源的数据将填充该字段。该机制是由解析器控制的。在该快速入门指南中，我们使用预定义的模型以及架构创建一个数据来源。

1. **解析器** - 解析器负责将架构字段链接到数据来源。他们从源中检索数据，然后根据字段定义的内容返回结果。 AWS AppSync 同时支持两者 JavaScript ，还支持 VTL，用于为 GraphQL 编写解析器。 APIs在该快速入门指南中，将根据架构和数据来源自动生成解析器。我们不会在本节中深入介绍该内容。

AWS AppSync 支持创建和配置所有 GraphQL 组件。在打开控制台时，您可以使用以下方法创建您的 API：

1. 设计自定义的 GraphQL API，即通过预定义的模型生成一个 GraphQL API，然后设置新的 DynamoDB 表（数据来源）以支持该 API。

1. 使用空白架构设计 GraphQL API，没有数据来源或解析器。

1. 使用 DynamoDB 表导入数据，并生成架构的类型和字段。

1. 使用 AWS AppSync 's的 WebSocket 功能和 Pub/Sub 架构进行实时开发 APIs。

1. 使用现有的 GraphQL APIs （源代码 APIs）链接到合并的 API。

**注意**  
我们建议在使用更高级的工具之前查看[设计架构](designing-your-schema.md#aws-appsync-designing-your-schema)一节。这些指南将解释更简单的示例，您可以在概念上使用这些示例来构建更复杂的应用程序。 AWS AppSync

AWS AppSync 还支持多个非控制台选项来创建 GraphQL APIs。这些方法包括：

1. AWS Amplify

1. AWS SAM

1. CloudFormation

1. CDK

 以下示例将说明如何使用预定义的模型和 DynamoDB 创建 GraphQL API 基本组件。

**Topics**
+ [启动架构](schema-launch-start.md)
+ [浏览 AWS AppSync 控制台](console-tour.md)
+ [使用 GraphQL 变更将数据添加到 DynamoDB 表](add-data-with-graphql-mutation.md)
+ [使用 GraphQL 查询从 DynamoDB 表中检索数据](retrieve-data-with-graphql-query.md)
+ [补充章节](next-steps.md)