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

Amazon API Gateway

Amazon API Gateway 是一种完全托管服务,使开发人员能够轻松地创建、发布、维护、监控和保护任何规模的 API。只需在 AWS 管理控制台 中轻点几次鼠标,您就能创建用作应用程序“前门”的 API,以便访问数据、业务逻辑或后端服务的功能,例如在 Amazon Elastic Compute Cloud (Amazon EC2) 上运行的工作负载、在 AWS Lambda 上运行的代码或任何 Web 应用程序。

Amazon API Gateway 负责管理所有任务,涉及接受和处理成千上万个并发 API 调用,包括流量管理、授权和访问控制、监控以及 API 版本管理。Amazon API Gateway 没有最低费用或启动成本。您只需为收到的 API 调用以及传出的数据量付费。

请注意以下 Amazon AWS 实施详情,它们可能与 北京和宁夏区域中的所有服务有关。

  • 要使用 北京和宁夏区域中的服务,您需要特定于 北京和宁夏区域的账户和凭证。其他 AWS 区域的账户和凭证不适用于 北京和宁夏区域中运营的服务。同样,北京和宁夏区域的账户和凭证也不适用于其他 AWS 区域。

  • 北京区域中有两个可用区。

  • 宁夏区域中有三个可用区。

  • 在 AWS Identity and Access Management (IAM) 中,您可使用 Principal 策略元素授予或拒绝授予针对资源的服务访问权限。服务委托人值因区域而异。

  • 北京和宁夏区域的域名是www.amazonaws.cn

  • 在中国(北京)区域和中国 (宁夏) 区域中服务终端节点与其他全局终端节点不同。

    • 北京和宁夏区域 的端点域是 amazonaws.com.cn

    • 对于中国(北京)区域,的终端节点,区域值应是 cn-north-1

    • 对于中国 (宁夏) 区域,的终端节点,区域值应是 cn-northwest-1

    • 例如,北京区域的 Elastic Load Balancing 终端节点是 elasticloadbalancing.cn-north-1.amazonaws.com.cn

    终端节点语法因服务而异。有关更多信息,请参阅中国(北京)中国 (宁夏)和特定于服务的文档。

  • 在中国区域中,Amazon 资源名称 (ARN) 语法包含 cn

    例如:arn:aws-cn:iam::123456789012:user/division_abc/subdivision_xyz/Bob

  • EC2-Classic 平台不受支持。

  • AWS Marketplace 不受支持。

  • 中国区域不提供免费使用套餐。

注意

AWS 文档可能会显示端点和 ARN 的代码示例,这些代码不是特定于 北京和宁夏区域。使用示例时,请确认您正在您所在的区域中使用正确的端点和ARN。

语言选项

中文是 Amazon AWS 文档的默认语言。要切换到页面的英文版,请使用页面顶部的语言选择下拉列表。注意:选择其他语言将会更新语言 cookie,使其成为默认语言。

中文 URL 语法:
http://docs.amazonaws.cn/aws/latest/userguide/introduction.html
英文 URL 语法:
http://docs.amazonaws.cn/en_us/aws/latest/userguide/introduction.html

功能可用性和实施区别

Amazon API Gateway 的 Amazon AWS 实施在以下方面独一无二:

  • 由于 Amazon CloudFront 不适用于 北京和宁夏区域,因此要在 北京和宁夏区域 中调用 API 网关 API,您必须使用特定于 北京区域 或特定于 宁夏区域 的终端节点。

  • 由于 Amazon CloudFront 不适用于 北京和宁夏区域,因此不支持边缘优化 API 或边缘优化自定义域名。

  • 由于 AWS Certificate Manager 不适用于 北京和宁夏区域,因此必须将证书内容上传至 API 网关。

  • 申请 Internet Content Provider (ICP) 备案—如果您想在 北京区域 提供无需身份验证即可访问的 API 请求,则必须获得 ICP 许可证。有关申请 ICP 备案的信息,请参阅 账单与付款。您可能还需要在 宁夏区域 中为 API 网关 申请 ICP 白名单,即使已在 北京区域 中申请也是如此。

  • 以下 API 网关 功能在 北京和宁夏区域 中不可用或需要 ICP 许可证:

    • API 网关 仅在 API 所有者的 Amazon AWS 账户与有效的 ICP 许可证关联时才提供未经身份验证的 API 请求。因此,使用 Lambda 授权方或不使用授权方创建 API 时需要 ICP 许可证。

    • 您可以使用自定义授权方或不使用授权方配置 API,但只有 Amazon AWS 账户与 ICP 许可证关联时才能访问该 API。

    • 无法为自定义域名使用别名 A 记录。必须创建指向区域自定义域终端节点的 CNAME。

  • 以下 API 网关 功能在 北京和宁夏区域 中不可用:

    • API 网关 私有集成

    • API 网关 私有 API

用户指南

Amazon AWS 用户指南以 HTML 和 PDF 格式提供,并有中文和英文两种版本。API 指南以 HTML 和 PDF 格式提供,只有英语版本。目前,北京和宁夏区域不提供 API 指南。API 指南的链接会使您进入全球 AWS 站点。请注意,这些指南中所述的部分功能在当前的 Amazon AWS 版本中可能未提供。