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 Elastic Compute Cloud (Amazon EC2) 上运行的工作负载、运行的代码)访问数据、业务逻辑或功能Amazon Lambda,或任何 Web 应用程序。

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

区域可用性

亚马逊 API 网关在中国以下地区可用:

  • 北京地区

  • 宁夏区域

功能可用性和实现差异

亚马逊网络服务在中国实施的亚马逊 API Gateway 在以下方面是独一无二的:

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

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

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

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

    • 仅当 API 所有者的亚马逊网络服务账户与有效的 ICP 许可证关联时,API Gateway 才会提供未经身份验证的 API 请求。因此,使用 Lambda 授权者或不使用授权者创建 API 需要 ICP 许可证。

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

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

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

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

指南和参考

中国亚马逊网络服务用户指南有 HTML 和 PDF 版本,有中文和英文两种版本。API 参考以 HTML 和 PDF 格式提供。有些 API 参考可能仅提供英文版。目前,并非所有 API 参考都适用于北京和宁夏区域。指向某些 API 参考的链接将带您进入亚马逊网络服务全球网站。请注意,指南和参考中描述的某些特性和功能可能在当前的亚马逊网络服务中国版本中不可用。

关于中国亚马逊网络服务的一般信息

以下信息适用于中国地区提供的所有亚马逊网络服务。

中国地区的亚马逊网络服务账户

要在北京和宁夏区域使用服务,您需要一个特定于每个区域的账户和证书。

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

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

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

中国亚马逊网络服务域名

亚马逊网络服务在中国的域名是www.amazonaws.cn

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

有关中国亚马逊网络服务中的终端节点和 ARN 的信息,请参阅中国亚马逊 Web Services 的终端节点和 ARN

中国区域的可用区

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

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

中国亚马逊网络服务的一般信息

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

  • Amazon Identity and Access Management (IAM)

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

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

  • EC2-Classic 平台

    • 不支持 EC2-Classic 平台。

  • 免费使用套餐

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

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

亚马逊 Web 服务控制台

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

代码示例

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