View a markdown version of this page

Amazon API Gateway - 中国亚马逊 Web Services 入门
区域可用性功能可用性和实现差异指南和参考关于中国亚马逊 Web Services 的一般信息
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

Amazon API Gateway

Amazon API Gateway 是一项完全托管的服务，让开发人员可以轻松地 APIs 在任何规模上创建、发布、维护、监控和保护。只需在 Amazon Web Services 管理控制台中单击几下，即可创建一个 API，该API充当应用程序访问后端服务的数据、业务逻辑或功能的 “前门”，例如在 Amazon Elastic Compute Cloud (Amazon EC2) 上运行的工作负载、在亚马逊 Lambda上运行的代码或任何 Web 应用程序。

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

区域可用性

Amazon API Gateway 在中国的以下区域中可用：

  • 北京区域

  • 宁夏区域

功能可用性和实现差异

Amazon Web Services 在中国实施 Amazon API Gateway 的独特之处在于：

  • 不支持门户。

  • 要 API Gateway APIs 在北京和宁夏区域拨打电话，必须使用北京地区特定或宁夏区域特定的终端节点。

  • 不支持边缘优化 APIs 和边缘优化的自定义域名。

  • 申请互联网内容提供商 (ICP) 备案-如果您想为北京地区无需身份验证即可访问的 API 请求提供服务，则必须获得 ICP 许可证。有关申请 ICP 备案的信息，请参阅 。即使您已经 API Gateway 在北京地区申请了 ICP 白名单，您也可能需要重新申请宁夏区域的 ICP 白名单。

  • 以下 API Gateway 功能要么在北京和宁夏区域不可用，要么需要 ICP 许可证：

    • API Gateway 仅当 API 所有者的亚马逊 Web Services 账户与有效的 ICP 许可证关联时，才会处理未经身份验证的 API 请求。因此，使用授权方或不使用 Lambda 授权方创建 API 需要 ICP 许可证。

    • 您可以使用自定义授权机构配置 API，也可以不使用授权机构来配置 API，但只有在您的中国亚马逊 Web Services 账户与 ICP 许可证关联时，才能访问该 API。

    • 所有自定义域名都需要 ICP 许可证。

  • Amazon Cognito 不支持授权者。

  • 不支持 Java 和 Ruby 开发工具包的生成。

  • 不支持与 Amazon Cloud Map 的 HTTP API 私有集成。

指南和参考

中国的 Amazon Web Services 用户指南有 HTML 和 PDF 版本，有中文和英文两种版本。API 参考以 HTML 和 PDF 格式提供。有些 API 参考可能仅提供英文版。目前，并非所有 API 参考在北京和宁夏区域都可用。某些 API 参考文献的链接将带您进入全球亚马逊 Web Services 网站。请注意，指南和参考资料中描述的某些特性和功能可能无法在当前的 Amazon Web Services 中国版本中提供。

关于中国亚马逊 Web Services 的一般信息

以下信息适用于在中国地区提供的所有 Amazon Web Services。

中国地区的亚马逊 Web Services 账户

要在北京和宁夏区域使用服务，您需要一个账户和每个区域的专属证书。

  • 其他 Amazon 地区的账户和凭证不适用于在北京和宁夏地区运营的服务。

  • 北京和宁夏区域的账户和资格不适用于其他 Amazon 区域。

  • 有关更多信息，请参阅注册、账户和证书。

中国亚马逊 Web Services 的域名

中国亚马逊 Web Services 的域名是 www.amazonaws.cn。

终端节点和 Amazon 资源名称 (ARNs)

有关终端节点和 ARNs 中国亚马逊云科技服务的信息，请参阅终端节点 ARNs 和中国亚马逊云科技服务的终端节点。

可用区 适用于中国地区

  • 在北京地区，有三个 可用区。

  • 在宁夏地区，有三个 可用区。

中国亚马逊 Web Services 的一般信息

以下内容适用于在中国地区提供的所有 Amazon Web Services。有关特定 Amazon Web Services 的详细信息，请参阅本指南中的特定服务主题。

  • Amazon Identity and Access Management (IAM)

    • 您可以使用 Principal 策略元素授予或拒绝服务对资源的访问。

    • 服务委托人值因区域而异。

  • 免费使用套餐

亚马逊 Web Services 控制台

中国 Amazon Web Services 的主机是中国独有的。Amazon Web Services 指南中的屏幕截图可能与您在主机上看到的屏幕截图不同。有关服务功能差别的信息，请参阅本指南中针对各项服务的主题。

代码示例

Amazon Web Services 文档可能包括非北京和 ARNs 宁夏区域特有的终端节点和代码示例。使用示例时，请确认您使用的是您所在地区的终端节点和 ARNs 终端节点。