Amazon API Gateway - 中国亚马逊 Web Services 入门
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

Amazon API Gateway

Amazon API Gateway 是一项完全托管的服务,使开发人员可以轻松创建、发布、维护、监控和保护任何规模的 API。只需点击几下 Amazon Web Services Management Console,您就可以创建一个 API,作为应用程序访问后端服务的数据、业务逻辑或功能的 “前门”,例如在亚马逊弹性计算云 (Amazon EC2) Elastic Compute Cloud 上运行的工作负载、 Amazon Lambda在上面运行的代码或任何 Web 应用程序。

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

区域可用性

Amazon API Gateway 已在中国以下地区推出:

  • 北京区域

  • 宁夏区域

功能可用性和实现差异

亚马逊 Web Services 在中国实施的 Amazon API Gateway 在以下方面具有独特性:

  • 要在北京和宁夏区域调用 API Gateway API,必须使用北京区域特定或宁夏区域特定的终端节点。

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

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

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

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

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

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

  • 不支持亚马逊 Cognito 授权者。

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

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

指南和参考

中国亚马逊 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 域名

Amazon Web Services 在中国的域名是www.amazonaws.cn

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

有关中国亚马逊 Web Services 中的终端节点和 ARN 的信息,请参阅终端节点和ARNs适用于中国的 Amazon Web Services

中国区域的可用区

  • 在北京区域,有三个可用区。

  • 在宁夏区域,有三个可用区。

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

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

  • Amazon Identity and Access Management (IAM)

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

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

  • EC2-Classic 平台

    • 不支持 EC2-Classic 平台。

  • 免费使用套餐

    • 宁夏区域支持免费使用套餐。

    • 北京地区不支持免费使用套餐。

亚马逊 Web Services 控制台

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

代码示例

Amazon Web Services 文档可能在非北京和宁夏区域特有的代码示例中包含终端节点和 ARN。使用示例时,请确认您使用的是适用于您的区域的终端节点和 ARN。