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

Amazon API Gateway

您可以通过 Amazon API Gateway 在 AWS 云中为客户创建、维护、部署以及保护 API,以访问 AWS 和其他 Web 服务。借助 API 网关,您可以在各种后端中为客户提供一致的应用程序编程接口,且能灵活地控制访问权限,包括开放或保护访问权限。此外,您还可以通过设置使用计划来计量 API 调用,同时,借由与 AWS Marketplace 的集成,您可以将 API 作为软件即服务 (SaaS) 产品进行出售,从而实现收益。API 网关 与 AWS Lambda 共同构成 AWS 无服务器应用程序框架中面向应用程序的部分。

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

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

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

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

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

  • 北京和宁夏区域的域名是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 的代码示例,这些代码不是特定于&cnall-name;。使用示例时,请确认您正在您所在的区域中使用正确的端点和ARN。

语言选项

中文是 Amazon AWS 文档的默认语言。从中文页面可以访问相应的英文页面(如果有),只需将 en_us/ 加入 URL 中即可,如下所示:

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

功能可用性和实施区别

API 网关 的 Amazon AWS 实现具有以下独特性:

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

  • 由于 AWS Certificate Manager 不适用于北京区域,因此要支持北京区域 API 的自定义域名,必须创建支持案例以请求传统证书存储的支持。

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

  • 由于 Amazon CloudFront 不适用于北京区域,因此不支持边缘 API 或边缘域名。

  • 申请 Internet Content Provider (ICP) 备案—如果您想在北京地区提供无需身份验证即可访问的 API 请求,则必须获得 ICP 许可证。有关申请 ICP 备案的信息,请参阅 账单与付款

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

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

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

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

用户指南

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