Amazon API Gateway
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

在 Amazon API Gateway 中创建 API

在 Amazon API Gateway 中,您可以使用被称为 API Gateway 资源的可编程实体集合构建 API。例如,您可以使用 RestApi 资源表示可以包含资源实体集合的 API。每个 Resource 实体又可以包含一个或多个方法资源。Method 以请求参数和正文表示,可定义客户端用于访问公开的 Resource 的应用程序编程接口,并代表客户端提交的传入请求。然后,您可以创建 Integration 资源,以通过将传入请求转发到指定的集成终端节点 URI 将 Method 与后端终端节点 (也称为集成终端节点) 进行集成。如有必要,您可以根据后端要求转换请求参数或正文。对于响应,您可以创建 MethodResponse 资源来代表客户端收到的请求响应,然后可以创建 IntegrationResponse 资源来代表后端返回的请求响应。您可以配置集成响应,以在转换后端响应数据之后将其返回给客户端,或按原样将后端响应传递给客户端。

要帮助您的客户了解 API,您还可以在创建 API 时或之后为 API 提供文档。要实现这一点,请为受支持的 API 实体添加一个 DocumentationPart 资源。

要控制客户端调用 API 的方式,可以使用 IAM 权限自定义授权方Amazon Cognito 用户池。要计量 API 的使用情况,请设置 usage plans 以限制 API 请求。您可在创建或更新 API 时启用这些选项。

您可以使用 API Gateway 控制台、API Gateway REST API、AWS CLI 或某个 AWS 开发工具包执行这些任务和其他任务。接下来,我们讨论如何执行这些任务。

选择一个终端节点类型来设置 API Gateway API

API 终端节点指 API 的主机名。API 终端节点可以是边缘优化或区域类型,具体取决于您的大部分 API 流量的源头位置。您可在创建 API 时选择特定的终端节点类型。

边缘优化的 API 终端节点通过采用 Amazon CloudFront 分配方法在地理上分配客户端来优化对 API 的访问。API 请求将路由到最近的 CloudFront 接入点 (POP)。默认将创建包含边缘优化的终端节点的 API。

区域 API 适用于同一区域中的客户端。当在 EC2 实例上运行的客户端调用同一区域中的 API,或 API 用于为具有高需求的少数客户端提供服务时,区域 API 可以降低连接开销。

对于边缘优化的 API,您可以创建适用于所有区域的自定义域名。对于区域 API,您可以创建特定于 API 托管区域的自定义域名。在不同区域中部署的区域 API 可能具有相同的自定义域名。