# 文档历史记录
<a name="history"></a>

下表描述了自 Amazon API Gateway 上一次发布以来对文档所做的重要更改。如需此文档更新的通知，您可以通过在顶部菜单面板中选择 RSS 按钮来订阅 RSS 源。
+ **最近文档更新时间**：2025 年 12 月 2 日

| 变更 | 说明 | 日期 | 
| --- |--- |--- |
| [添加 API Gateway REST API 作为 Amazon Bedrock AgentCore 网关的目标](#history) | API Gateway 现在支持添加 REST API 作为 Amazon Bedrock AgentCore 网关的目标。有关更多信息，请参阅[添加 API Gateway REST API 作为 Amazon Bedrock AgentCore 网关的目标](https://docs.aws.amazon.com/apigateway/latest/developerguide/mcp-server.html)。 | 2025 年 12 月 2 日 | 
| [与应用程序负载均衡器的私有集成](#history) | API Gateway 现在支持 REST API 与应用程序负载均衡器进行私有集成。有关更多信息，请参阅 [REST API 的私有集成](https://docs.aws.amazon.com/apigateway/latest/developerguide/private-integration.html)。 | 2025 年 11 月 21 日 | 
| [REST API 和自定义域名的安全策略](#history) | API Gateway 现在支持对 REST API 和自定义域名使用增强型 TLS 安全策略。有关更多信息，请参阅 [API Gateway 中的 REST API 安全策略](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-security-policies.html)。 | 2025 年 11 月 19 日 | 
| [REST API 的响应流](#history) | API Gateway REST API 现在支持在响应有效载荷就绪时向客户端逐步流式传输。有关更多信息，请参阅[流式传输代理集成的集成响应](https://docs.aws.amazon.com/apigateway/latest/developerguide/response-transfer-mode.html)。 | 2025 年 11 月 19 日 | 
| [开发人员门户](#history) | API Gateway 现在支持门户，您的客户可以在这一集中的位置发现和测试您的 API 和门户产品，也就是您要共享的某项服务或功能。有关更多信息，请参阅 [API Gateway 门户](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-portals.html)。 | 2025 年 11 月 19 日 | 
| [适用于 REST API 的 SIGv4a](#history) | API Gateway 现在支持对 REST API 使用签名版本 4a。有关更多信息，请参阅[用于调用 API 的 API Gateway 权限模型](https://docs.aws.amazon.com/apigateway/latest/developerguide/permissions.html#api-gateway-control-access-iam-permissions-model-for-calling-api)。 | 2025 年 8 月 19 日 | 
| [REST API 的路由规则](#history) | API Gateway 现在使用自定义域名支持 REST API 的路由规则。可以根据 HTTP 标头值、URL 基本路径或两者的组合来动态路由传入请求。有关更多信息，请参阅 [Send traffic to your APIs through your custom domain name](https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-routing-mode.html)。 | 2025 年 6 月 3 日 | 
| [添加了对双堆栈（IPv4 和 IPv6）端点的支持](#history) | API Gateway 现在对于 REST、HTTP 和 WebSocket API 以及自定义域名支持双堆栈端点。有关更多信息，请参阅 [IP address types](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-ip-address-type.html)。 | 2025 年 3 月 28 日 | 
| [私有 API 的自定义域名](#history) | 增加了私有 API 对自定义域名的支持。有关更多信息，请参阅[私有 API 的自定义域名](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-private-custom-domains.html)。 | 2024 年 11 月 21 日 | 
| [增加了对 TLS 1.3 的支持](#history) | API Gateway 现在可在区域 REST API、HTTP API 和 WebSocket API 上支持 TLS 1.3。有关更多信息，请参阅[在 API Gateway 中为自定义域选择安全策略](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-custom-domain-tls-version.html)。 | 2024 年 2 月 15 日 | 
| [REST API 和 WebSocket API 控制台更新](#history) | 更新了 REST API 和 WebSocket API 的控制台信息。 | 2023 年 12 月 10 日 | 
| [文档更新](#history) | 更新了概念信息，并为 API Gateway REST API 的数据转换和请求验证主题创建了新的教程。有关更多信息，请参阅[在 API Gateway 中使用请求验证](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-method-request-validation.html)和[为 REST API 设置数据转换](https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-data-transformations.html)。 | 2023 年 6 月 22 日 | 
| [为多区域 API Gateway 配置 DNS 故障转移](#history) | 添加了以下支持：使用 Amazon Route 53 运行状况检查，控制从主要 AWS 区域中的 API Gateway REST API 到辅助区域中的 API Gateway REST API 的 DNS 故障转移。有关更多信息，请参阅[为 DNS 故障转移配置自定义运行状况检查](https://docs.aws.amazon.com/apigateway/latest/developerguide/dns-failover.html)。 | 2022 年 10 月 31 日 | 
| [文档更新](#history) | 更新了 REST API 和 HTTP API 的核心功能摘要。有关更多信息，请参阅[在 REST API 和 HTTP API 之间进行选择](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-vs-rest.html)。 | 2022 年 5 月 31 日 | 
| [托管式策略更新](#history) | 添加了 `acm:GetCertificate` 支持到 `AWSServiceRoleForAPIGateway` 策略。有关更多信息，请参阅[使用 API Gateway 的服务相关角色](https://docs.aws.amazon.com/apigateway/latest/developerguide/using-service-linked-roles.html)。 | 2021 年 7 月 12 日 | 
| [HTTP API 的参数映射](#history) | 添加了对 HTTP API 参数映射的支持。有关更多信息，请参阅[转换 API 请求和响应](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-parameter-mapping.html)。 | 2021 年 1 月 7 日 | 
| [禁用 REST API 的默认端点](#history) | 添加了对禁用 REST API 的默认端点的支持。有关更多信息，请参阅[禁用 REST API 的默认端点](https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-disable-default-endpoint.html)。 | 2020 年 10 月 29 日 | 
| [双向 TLS 身份验证](#history) | 增加了对 REST API 和 HTTP API 的双向 TLS 身份验证的支持。有关更多信息，请参阅[为 REST API 配置双向 TLS 身份验证](https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-mutual-tls.html)和[为 HTTP API 配置双向 TLS 身份验证](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-mutual-tls.html)。 | 2020 年 9 月 17 日 | 
| [HTTP API AWS Lambda 授权方](#history) | 添加了对 HTTP API 的 AWS Lambda 授权方的支持。有关更多信息，请参阅[与 HTTP API AWS Lambda 授权方协同工作](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-lambda-authorizer)。 | 2020 年 9 月 9 日 | 
| [HTTP API AWS 服务集成](#history) | 添加了对适用于 HTTP API 的AWS服务集成的支持。有关更多信息，请参阅[使用适用于 HTTP API 的AWS服务集成](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations-aws-services)。 | 2020 年 8 月 20 日 | 
| [HTTP API 通配符自定义域](#history) | 添加了对 HTTP API 的通配符自定义域名的支持。有关更多信息，请参阅[通配符自定义域名](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-custom-domain-names.html)。 | 2020 年 8 月 10 日 | 
| [无服务器开发人员门户改进](#history) | 已将用户管理添加到管理员面板，并支持导出 API 定义。有关更多信息，请参阅[使用无服务器开发人员门户为 API Gateway API 编目](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-developer-portal.html)。 | 2020 年 6 月 25 日 | 
| [WebSocket API `Sec-WebSocket-Protocol` 支持](#history) | 增加了对 `Sec-WebSocket-Protocol` 字段的支持。有关更多信息，请参阅[设置需要 WebSocket 子协议的 $connect 路由](https://docs.aws.amazon.com/apigateway/latest/developerguide/websocket-connect-route-subprotocol.html)。 | 2020 年 6 月 16 日 | 
| [HTTP API 导出](#history) | 添加了对导出 HTTP API 的 OpenAPI 3.0 定义的支持。有关更多信息，请参阅[从 API Gateway 导出 HTTP API](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-export.html)。 | 2020 年 4 月 20 日 | 
| [安全性文档](#history) | 添加了安全性文档。有关更多信息，请参阅 [Amazon API Gateway 中的安全性](https://docs.aws.amazon.com/apigateway/latest/developerguide/security.html)。 | 2020 年 3 月 31 日 | 
| [重新组织了文档](#history) | 重新组织了开发人员指南。 | 2020 年 3 月 12 日 | 
| [HTTP API 正式发布](#history) | HTTP API 已正式发布。有关更多信息，请参阅[使用 HTTP API](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api.html)。 | 2020 年 3 月 12 日 | 
| [HTTP API 日志记录](#history) | 添加了对 HTTP API 日志中 `$context.integrationErrorMessage` 的支持。有关更多信息，请参阅 [HTTP API 日志记录变量](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-logging-variables.html)。 | 2020 年 2 月 26 日 | 
| [AWS用于 OpenAPI 导入的变量](#history) | 在 OpenAPI 定义中添加了对 AWS 变量的支持。有关更多信息，请参阅[适用于 OpenAPI 导入的AWS变量](https://docs.aws.amazon.com/apigateway/latest/developerguide/import-api-aws-variables.html)。 | 2020 年 2 月 17 日 | 
| [HTTP API](#history) | 在测试版中发布了 HTTP API。有关更多信息，请参阅 [HTTP API](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api.html)。 | 2019 年 12 月 4 日 | 
| [通配符自定义域名](#history) | 添加了对通配符自定义域名的支持。有关更多信息，请参阅[通配符自定义域名](https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html#wildcard-custom-domain-names)。 | 2019 年 10 月 21 日 | 
| [Amazon Data Firehose 日志记录](#history) | 添加了对将 Amazon Data Firehose 作为访问日志记录数据的目标的支持。有关更多信息，请参阅[使用 Amazon Data Firehose 作为 API Gateway 访问日志记录的目标](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-logging-to-kinesis.html)。 | 2019 年 10 月 15 日 | 
| [用于调用私有 API 的 Route53 别名](#history) | 添加了对用于调用私有 API 的其他 Route53 别名 DNS 记录的支持。有关更多信息，请参阅[使用 Route53 别名访问您的私有 API](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-private-api-test-invoke-url.html#apigateway-private-api-route53-alias)。 | 2019 年 9 月 18 日 | 
| [针对 WebSocket API 的基于标签的访问控制](#history) | 增加了对 WebSocket API 基于标签的访问控制的支持。有关更多信息，请参阅[可加标签的 API Gateway 资源](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-tagging-supported-resources.html)。 | 2019 年 6 月 27 日 | 
| [自定义域的 TLS 版本选择](#history) | 增加了相应支持，可以对部署到自定义域的 API 的传输层安全性 (TLS) 选择版本。请参阅[在 API Gateway 中为自定义域选择最小 TLS 版本](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-custom-domain-tls-version.html)中的说明。 | 2019 年 6 月 20 日 | 
| [针对私有 API 的 VPC 端点策略](#history) | 增加了对通过附加端点策略到接口 VPC 端点来改进私有 API 安全性的支持。有关更多信息，请参阅[在 API Gateway 中为私有 API 使用 VPC 端点策略](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-vpc-endpoint-policies.html)。 | 2019 年 6 月 4 日 | 
| [更新的文档](#history) | 重新编写了[开始使用 Amazon API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/getting-started.html)。已将教程移至 [Amazon API Gateway 教程](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-tutorials.html)。 | 2019 年 5 月 29 日 | 
| [针对 REST API 的基于标签的访问控制](#history) | 增加了对 REST API 基于标签的访问控制的支持。有关更多信息，请参阅[使用标签与 IAM 策略控制对 API Gateway 资源的访问](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-tagging-iam-policy.html)。 | 2019 年 5 月 23 日 | 
| [更新的文档](#history) | 重新编写了以下 6 个主题：[什么是 Amazon API Gateway？](https://docs.aws.amazon.com/apigateway/latest/developerguide/welcome.html)、[教程：使用 HTTP 代理集成构建 API](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-create-api-as-simple-proxy-for-http.html)、[教程：使用三个非代理集成创建 Calc REST API](https://docs.aws.amazon.com/apigateway/latest/developerguide/integrating-api-with-aws-services-lambda.html)、[API Gateway 映射模板和访问日志记录变量参考](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-mapping-template-reference.html)、[使用 API Gateway Lambda 授权方](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-use-lambda-authorizer.html)和[为 API Gateway REST API 资源启用 CORS](https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-cors.html)。 | 2019 年 4 月 5 日 | 
| [无服务器开发人员门户改进](#history) | 增加了管理员面板以及更方便在 Amazon API Gateway 开发人员门户中发布 API 的其他改进。有关更多信息，请参阅[使用开发人员门户为您的 API 编目](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-developer-portal.html)。 | 2019 年 3 月 28 日 | 
| [支持 AWS Config](#history) | 增加了对 AWS Config 的支持。有关更多信息，请参阅[使用 AWS Config 监控 API Gateway API 配置](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-config.html)。 | 2019 年 3 月 20 日 | 
| [支持 CloudFormation](#history) | 将 API Gateway V2 API 添加到 CloudFormation 模板参考中。有关更多信息，请参阅 [Amazon API Gateway V2 资源类型参考](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-reference-apigatewayv2.html)。 | 2019 年 2 月 7 日 | 
| [支持 WebSocket API](#history) | 添加了对 WebSocket API 的支持。有关更多信息，请参阅[在 Amazon API Gateway 中创建 WebSocket API](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-websocket-api.html)。 | 2018 年 12 月 18 日 | 
| [无服务器开发人员门户可用，通过AWS Serverless Application Repository](#history) | 现在，除 [GitHub](https://github.com/awslabs/aws-api-gateway-developer-portal) 之外，Amazon API Gateway 开发人员门户无服务器应用程序还可通过 [AWS Serverless Application Repository](https://aws.amazon.com/serverless/serverlessrepo/) 使用。有关更多信息，请参阅[使用开发人员门户为您的 API Gateway API 编目](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-developer-portal.html)。 | 2018 年 11 月 16 日 | 
| [支持 AWS WAF](#history) | 添加了对 [AWS WAF](https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html)（Web 应用程序防火墙）的支持。有关更多信息，请参阅[使用 AWS WAF 控制对 API 的访问](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-control-access-aws-waf.html)。 | 2018 年 11 月 5 日 | 
| [无服务器开发人员门户](#history) | Amazon API Gateway 现在提供了完全可定制的开发人员门户作为无服务器应用程序，您可以部署它以发布您的 API Gateway API。有关更多信息，请参阅[使用开发人员门户为您的 API Gateway API 编目](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-developer-portal.html)。 | 2018 年 10 月 29 日 | 
| [支持多值标头和查询字符串参数](#history) | Amazon API Gateway 现在支持多个具有相同名称的标头和查询字符串参数。有关更多信息，请参阅[支持多值标头和查询字符串参数](https://docs.aws.amazon.com/apigateway/latest/developerguide/set-up-lambda-proxy-integrations.html#apigateway-multivalue-headers-and-parameters)。 | 2018 年 10 月 4 日 | 
| [OpenAPI 支持](#history) | Amazon API Gateway 现在支持 OpenAPI 3.0 以及 OpenAPI (Swagger) 2.0。 | 2018 年 9 月 27 日 | 
| [更新的文档](#history) | 添加了一个新主题：[Amazon API Gateway 资源策略如何影响授权工作流程](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-authorization-flow.html)。 | 2018 年 9 月 27 日 | 
| [活动的 AWS X-Ray 集成](#history) | 现在，您可以使用 AWS X-Ray 来跟踪和分析用户请求通过您的 API 传输到基础服务时的延迟。有关更多信息，请参阅[使用 AWS X-Ray 跟踪 API Gateway API 的执行情况](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-xray.html)。 | 2018 年 9 月 6 日 | 
| [缓存改进](#history) | 只有当您为 API 阶段启用缓存时，`GET` 方法才会默认启用缓存。这有助于确保您的 API 的安全。您可以通过 覆盖方法设置 为其他方法启用缓存。有关更多信息，请参阅[启用 API 缓存以提高响应能力](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-caching.html)。 | 2018 年 8 月 20 日 | 
| [修改了服务限制](#history) | 已修改几个限制：增加了每账户 API 数。提高了创建/导入/部署 API 的 API 速率限制。已更正一些从每分钟到每秒的速率。有关更多信息，请参阅[限制](https://docs.aws.amazon.com/apigateway/latest/developerguide/limits.html)。 | 2018 年 7 月 13 日 | 
| [覆盖 API 请求和响应参数以及标头](#history) | 添加了对覆盖请求标头、查询字符串和路径以及响应标头和状态代码的支持。有关更多信息，请参阅[使用映射模板覆盖 API 的请求和响应参数以及标头](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-override-request-response-parameters.html)。 | 2018 年 7 月 12 日 | 
| [使用计划的方法级别限制](#history) | 添加了对设置默认每方法限制以及在使用计划设置中设定单个 API 方法的限制的支持。除了现有的账户级别限制和默认方法级别限制之外，还可以在阶段设置中设定这些设置。有关更多信息，请参阅[限制 API 请求以获得更高的吞吐量](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-request-throttling.html)。 | 2018 年 7 月 11 日 | 
| [现在可通过 RSS 获得《API Gateway 开发人员指南》更新通知](#history) | HTML 版本的 《API Gateway 开发人员指南》现在支持更新的 RSS 源，此类更新显示在该**文档历史记录** 页面上。RSS 源包括 2018 年 6 月 27 日及此日期之后发布的更新。在此之前发布的更新仍会显示在该页面上。使用顶部菜单面板中的 RSS 按钮，订阅此源。 | 2018 年 27 月 6 日 | 

## 早期更新
<a name="release-archive"></a>

下表描述 2018 年 6 月 27 日之前发布的每个 *API Gateway 开发人员指南* 中的重要变化。


| 更改 | 说明 | 更改日期 | 
| --- | --- | --- | 
| 私有 API | 添加了对您通过[接口 VPC 端点](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html)公开的[私有 API](apigateway-private-apis.md) 的支持。您的私有 API 的流量不会离开 Amazon 网络；它与公有 Internet 隔离开来。 | 2018 年 14 月 6 日 | 
| 跨账户 Lambda 授权方和集成以及跨账户 Amazon Cognito 用户池授权方 | 使用另一个AWS账户中的 AWS Lambda 函数作为 Lambda 授权方函数或 API 集成后端。或使用 Amazon Cognito 用户池作为授权方。另一个账户可以位于 Amazon API Gateway 可用的任何区域中。有关更多信息，请参阅[配置跨账户 API Gateway Lambda 授权方](apigateway-lambda-authorizer-cross-account-lambda-authorizer.md)、[教程：利用跨账户 Lambda 代理集成创建 REST API](apigateway-cross-account-lambda-integrations.md)和[使用 API Gateway 控制台为 REST API 配置跨账户 Amazon Cognito 授权方](apigateway-cross-account-cognito-authorizer.md)。 | 2018 年 4 月 2 日 | 
| 用于 API 的资源策略 | 使用 API Gateway 资源策略可以允许其他AWS账户的用户安全地访问您的 API，或者仅允许从指定的源 IP 地址范围或 CIDR 块调用 API。有关更多信息，请参阅 [使用 API Gateway 资源策略控制对 API 的访问](apigateway-resource-policies.md)。 | 2018 年 4 月 2 日 | 
| 为 API Gateway 资源添加标签 | 在 API Gateway 中可使用最多 50 个标签为 API 阶段添加标签，用于 API 请求的成本分配和缓存。有关更多信息，请参阅[为 API Gateway 中的 API 阶段设置标签](set-up-tags.md)。 | 2017 年 12 月 19 日 | 
| 负载压缩和解压缩 | 允许使用支持的内容编码之一调用具有压缩负载的 API。如果指定了正文映射模板，则压缩负载需要进行映射。有关更多信息，请参阅 [针对 API Gateway 中的 REST API 的负载压缩](api-gateway-gzip-compression-decompression.md)。 | 2017 年 12 月 19 日 | 
| API 密钥来自自定义授权方 | 从自定义授权方将 API 密钥返回到 API Gateway，以便为需要密钥的 API 方法应用使用计划。有关更多信息，请参阅 [在 API Gateway 中选择一个 API 密钥源](api-gateway-api-key-source.md)。 | 2017 年 12 月 19 日 | 
| 使用 OAuth 2 范围授权 | 使用 OAuth 2 范围和 COGNITO\_USER\_POOLS 授权方启用对方法调用的授权。有关更多信息，请参阅 [使用 Amazon Cognito 用户池作为授权方控制对 REST API 的访问](apigateway-integrate-with-cognito.md)。 | 2017 年 12 月 14 日 | 
| 私有集成和 VPC 链接 | 使用 API Gateway 私有集成创建 API，向位于 Amazon VPC 外部的客户端，通过 [VpcLink](https://docs.aws.amazon.com/apigateway/latest/api/API_VpcLink.html) 资源提供对此 VPC 中 HTTP/HTTPS 资源的访问。有关更多信息，请参阅[教程：利用私有集成创建 REST API](getting-started-with-private-integration.md)和[设置私有集成](set-up-private-integration.md)。 | 2017 年 11 月 30 日 | 
| 为 API 测试部署金丝雀版本 | 将金丝雀版本添加到现有 API 部署，用于测试 API 的较新版本，同时确保运营中的当前版本保持在相同的阶段。您可以为 Canary 版本设置阶段流量百分比，以及启用在单独的 CloudWatch Logs 日志中记录特定于 Canary 的执行和访问。有关更多信息，请参阅 [设置 API Gateway Canary 版本部署](canary-release.md)。 | 2017 年 11 月 28 日 | 
| 访问日志记录 | 使用您选择的格式，通过从 [$context 变量](api-gateway-mapping-template-reference.md#context-variable-reference)派生的数据记录对 API 的客户端访问。有关更多信息，请参阅 [为 API Gateway 中的 REST API 设置 CloudWatch 日志记录](set-up-logging.md)。 | 2017 年 11 月 21 日 | 
| API 的 Ruby 开发工具包 | 为您的 API 生成 Ruby 开发工具包并将其用于调用 API 方法。有关更多信息，请参阅[在 API Gateway 中生成 API 的 Ruby SDK](generate-ruby-sdk-of-an-api.md)和[使用由 API Gateway 为 REST API 生成的 Ruby 开发工具包](how-to-call-sdk-ruby.md)。 | 2017 年 11 月 20 日 | 
| 区域 API 端点 | 指定区域 API 端点来为非移动客户端创建 API。非移动客户端（例如 EC2 实例）在与部署 API 的同一AWS区域中运行。与边缘优化的 API 一样，您可为区域 API 创建自定义域名。有关更多信息，请参阅[API Gateway 中针对 REST API 的 API 端点类型](api-gateway-api-endpoint-types.md)和[在 API Gateway 中设置区域自定义域名](apigateway-regional-api-custom-domain-create.md)。 | 2017 年 11 月 2 日 | 
| 自定义请求授权方 |  使用自定义请求授权方可提供请求参数中的用户身份验证信息以授权 API 方法调用。请求参数包括标头和查询字符串参数以及阶段和上下文变量。有关更多信息，请参阅 [使用 API Gateway Lambda 授权方](apigateway-use-lambda-authorizer.md)。 | 2017 年 9 月 15 日 | 
| 自定义网关响应 |  针对无法到达集成后端的 API 请求自定义 API Gateway 生成的网关响应。自定义网关消息可以为调用方提供特定于 API 的自定义错误消息，包括返回所需的 CORS 标头，或者也可以将网关响应数据转换为外部交换的格式。有关更多信息，请参阅 [设置网关响应以自定义错误响应](api-gateway-gatewayResponse-definition.md#customize-gateway-responses)。 | 2017 年 6 月 6 日 | 
| 将 Lambda 自定义错误属性映射到方法响应标头 |  使用 integration.response.body 参数（依赖于 API Gateway 在运行时反序列化字符串化的自定义错误对象），将从 Lambda 返回的单独自定义错误属性映射到方法响应标头参数。有关更多信息，请参阅 [处理 API Gateway 中的自定义 Lambda 错误](handle-errors-in-lambda-integration.md#handle-custom-errors-in-lambda-integration)。 | 2017 年 6 月 6 日 | 
| 限制提高 |  账户级别稳态请求速率限制提高至每秒 10000 个请求 (rps)，突发限制提高至 5000 个并发请求。有关更多信息，请参阅 [在 API Gateway 中限制对 REST API 的请求以提高吞吐量](api-gateway-request-throttling.md)。 | 2017 年 6 月 6 日 | 
| 验证方法请求 | 在 API 级别或方法级别配置基本请求验证程序，以便 API Gateway 验证传入请求。API Gateway 会验证必需的参数是否已设置且未留空，并验证适用负载的格式是否符合配置的模型。有关更多信息，请参阅 [针对 API Gateway 中的 REST API 的请求验证](api-gateway-method-request-validation.md)。 | 2017 年 4 月 11 日 | 
| 与 ACM 集成 | 针对您的 API 自定义域名使用 ACM 证书。您可以在 AWS Certificate Manager 中创建一个证书，或将现有的 PEM 格式证书导入 ACM。然后，您可以在为 API 设置自定义域名时引用证书的 ARN。有关更多信息，请参阅 [API Gateway 中公共 REST API 的自定义域名](how-to-custom-domains.md)。 | 2017 年 9 月 3 日 | 
| 生成并调用 API 的 Java 开发工具包 | 让 API Gateway 为您的 API 生成 Java 开发工具包，并使用该开发工具包在 Java 客户端中调用 API。有关更多信息，请参阅 [使用由 API Gateway 为 REST API 生成的 Java 开发工具包](how-to-call-apigateway-generated-java-sdk.md)。 | 2017 年 1 月 13 日 | 
| 与 集成AWS Marketplace | 通过 ，在使用计划中将您的 API 作为 SaaS 产品进行销售AWS Marketplace 使用 AWS Marketplace 扩展您的 API 的范围。依赖 AWS Marketplace 以代表您处理客户账单。让 API Gateway 处理用户授权和使用情况计量。有关更多信息，请参阅 [将您的 API 作为 SaaS 进行销售](sell-api-as-saas-on-aws-marketplace.md)。 | 2016 年 12 月 1 日 | 
| 为您的 API 启用文档支持 | 在 API Gateway 中，为 [DocumentationPart](https://docs.aws.amazon.com/apigateway/latest/api/API_DocumentationPart.html) 资源中的 API 实体添加文档。将集合 DocumentationPart 实例的快照与 API 阶段相关联以创建 [DocumentationVersion](https://docs.aws.amazon.com/apigateway/latest/api/API_DocumentationVersion.html)。通过将文档版本导出到外部文件 (如 Swagger 文件)，发布 API 文档。有关更多信息，请参阅 [针对 API Gateway 中的 REST API 的文档](api-gateway-documenting-api.md)。 | 2016 年 12 月 1 日 | 
| 更新了自定义授权方 | 现在，客户授权方 Lambda 函数会返回调用方的委托人标识符。该函数还会将其他信息作为 context 映射和 IAM 策略的键/值对返回。有关更多信息，请参阅 [来自 API Gateway Lambda 授权方的输出](api-gateway-lambda-authorizer-output.md)。 | 2016 年 12 月 1 日 | 
| 支持二进制负载 | 设置您 API 的 [binaryMediaTypes](https://docs.aws.amazon.com/apigateway/latest/api/API_RestApi.html#apigw-Type-RestApi-binaryMediaTypes)，以支持请求或响应的二进制负载。设置 [Integration](https://docs.aws.amazon.com/apigateway/latest/api/API_Integration.html) 或 [IntegrationResponse](https://docs.aws.amazon.com/apigateway/latest/api/API_IntegrationResponse.html) 的 contentHandling 属性，以指定是将二进制负载处理为本地二进制 blob、Base64 编码字符串，还是无需修改即直接传递。有关更多信息，请参阅 [针对 API Gateway 中的 REST API 的二进制媒体类型](api-gateway-payload-encodings.md)。 | 2016 年 11 月 17 日 | 
| 通过 API 的代理资源启用与 HTTP 或 Lambda 后端的代理集成。 | 使用 {proxy\+} 形式的“贪婪”路径参数和“捕获全部”ANY 方法创建一个代理资源。代理资源分别使用 HTTP 或 Lambda 代理集成与 HTTP 或 Lambda 后端集成。有关更多信息，请参阅 [设置具有代理资源的代理集成](api-gateway-set-up-simple-proxy.md)。 | 2016 年 9 月 20 日 | 
| 通过提供一个或多个使用计划，将 API Gateway 内的选定 API 扩展为面向客户的产品服务。 | 在 API Gateway 内创建使用计划，以使选定的 API 客户端能够按照商定的请求速率和配额访问指定的 API 阶段。有关更多信息，请参阅 [API Gateway 中针对 REST API 的使用计划和 API 密钥](api-gateway-api-usage-plans.md)。 | 2016 年 8 月 11 日 | 
| 通过 Amazon Cognito 中的用户池启用方法级别授权 | 在 Amazon Cognito 内创建用户池，并将其用作您自己的身份提供商。您可以将用户池配置为方法级别授权方，以便向在用户池中注册的用户授予访问权限。有关更多信息，请参阅 [使用 Amazon Cognito 用户池作为授权方控制对 REST API 的访问](apigateway-integrate-with-cognito.md)。 | 2016 年 7 月 28 日 | 
| 在 AWS/ApiGateway 命名空间下启用 Amazon CloudWatch 指标和维度。 | API Gateway 指标现在已在 AWS/ApiGateway 的 CloudWatch 命名空间下进行了标准化。您可以在 API Gateway 控制台和 Amazon CloudWatch 控制台中查看它们。有关更多信息，请参阅 [Amazon API Gateway 维度和指标](api-gateway-metrics-and-dimensions.md)。 | 2016 年 7 月 28 日 | 
| 为自定义域名启用证书轮换 |  借助证书轮换，您可以为自定义域名上传证书和续订过期证书。有关更多信息，请参阅 [轮换 ACM 中导入的证书](how-to-edge-optimized-custom-domain-name.md#how-to-rotate-custom-domain-certificate)。 | 2016 年 4 月 27 日 | 
| 记录对更新的 Amazon API Gateway 控制台的更改。 | 了解如何使用更新的 API Gateway 控制台创建和设置 API。有关更多信息，请参阅 [教程：通过导入示例创建 REST API](api-gateway-create-api-from-example.md) 和 [教程：使用 HTTP 非代理集成创建 REST API](api-gateway-create-api-step-by-step.md)。 | 2016 年 4 月 5 日 | 
| 启用“导入 API”功能以根据外部 API 定义创建新的 API 或更新现有 API。 | 借助“导入 API”功能，您可以通过 API Gateway 扩展上传 Swagger 2.0 中表述的外部 API 定义，从而创建新 API 或更新现有 API。有关“导入 API”的更多信息，请参阅[在 API Gateway 中使用 OpenAPI 开发 REST API](api-gateway-import-api.md)。 | 2016 年 4 月 5 日 | 
|  公开 $input.body 变量以访问字符串形式的原始负载和 $util.parseJson() 函数，从而将 JSON 字符串转换为映射模板内的 JSON 对象。 |  有关 $input.body 和 $util.parseJson() 的更多信息，请参阅[API Gateway 的用于数据转换的变量](api-gateway-mapping-template-reference.md)。 | 2016 年 4 月 5 日 | 
| 启用使方法级别缓存失效的客户端请求，提高请求限制管理。 | 刷新 API 阶段级别缓存，并使各个缓存条目失效。有关更多信息，请参阅 [刷新 API Gateway 中的 API 阶段缓存](api-gateway-caching.md#flush-api-caching)和[使 API Gateway 缓存条目失效](api-gateway-caching.md#invalidate-method-caching)。改善管理 API 请求限制方面的控制台体验。有关更多信息，请参阅 [在 API Gateway 中限制对 REST API 的请求以提高吞吐量](api-gateway-request-throttling.md)。 | 2016 年 3 月 25 日 | 
| 使用自定义授权启用和调用 API Gateway API |  创建和配置 AWS Lambda 函数以实施自定义授权。该函数会返回一个 IAM 策略文档，该文档会向 API Gateway API 的客户端请求授予“允许”或“拒绝”权限。有关更多信息，请参阅 [使用 API Gateway Lambda 授权方](apigateway-use-lambda-authorizer.md)。 | 2016 年 2 月 11 日 | 
| 使用 Swagger 定义文件和扩展导入和导出 API Gateway API |  结合使用 Swagger 规范和 API Gateway 扩展来创建和更新您的 API Gateway API。使用 API Gateway 导入程序导入 Swagger 定义。使用 API Gateway 控制台或 API Gateway 导出 API 将 API Gateway API 导出到 Swagger 定义文件。有关更多信息，请参阅 [在 API Gateway 中使用 OpenAPI 开发 REST API](api-gateway-import-api.md) 和 [从 API Gateway 导出 REST API](api-gateway-export-api.md)。 | 2015 年 12 月 18 日 | 
| 将请求、响应正文或正文的 JSON 字段映射到请求或响应参数。 | 将方法请求正文或其 JSON 字段映射到集成请求的路径、查询字符串或标头。将集成响应正文或其 JSON 字段映射到请求响应的标头。有关更多信息，请参阅 [API Gateway 中 REST API 的参数映射示例](request-response-data-mappings.md)。 | 2015 年 12 月 18 日 | 
| 在 Amazon API Gateway 中使用阶段变量 | 了解如何将配置属性与 Amazon API Gateway 中 API 的部署阶段相关联。有关更多信息，请参阅 [在 API Gateway 中对 REST API 使用阶段变量](stage-variables.md)。 | 2015 年 11 月 5 日 | 
| 如何：为方法启用 CORS | 现在，您可以在 Amazon API Gateway 中更轻松地为方法启用跨源资源共享 (CORS)。有关更多信息，请参阅 [针对 API Gateway 中的 REST API 的 CORS](how-to-cors.md)。 | 2015 年 11 月 3 日 | 
| 如何：使用客户端 SSL 身份验证 | 使用 Amazon API Gateway 生成 SSL 证书，您可以用它来对 HTTP 后端调用进行身份验证。有关更多信息，请参阅 [生成和配置 SSL 证书以用于 API Gateway 中的后端身份验证](getting-started-client-side-ssl-authentication.md)。 | 2015 年 9 月 22 日 | 
| 模拟方法集成 | 了解如何[将 API 与 Amazon API Gateway 进行模拟集成](how-to-mock-integration.md)。借助此功能，开发人员可以直接从 API Gateway 生成 API 响应，而无需提前在后端进行最终集成。 | 2015 年 9 月 1 日 | 
| Amazon Cognito 身份支持 | Amazon API Gateway 扩展了 $context 变量的范围，以便在使用 Amazon Cognito 凭证对请求签名时，它现在会返回有关 Amazon Cognito 身份的信息。此外，我们添加了 $util 变量，用于对 JavaScript 中的字符串进行转义，以及对 URL 和字符串进行编码。有关更多信息，请参阅 [API Gateway 的用于数据转换的变量](api-gateway-mapping-template-reference.md)。 | 2015 年 8 月 28 日 | 
| Swagger 集成 | 使用 [GitHub 上的 Swagger 导入工具](https://github.com/awslabs/aws-apigateway-swagger-importer)将 Swagger API 定义导入 Amazon API Gateway。了解有关 [适用于 API Gateway 的 OpenAPI 扩展](api-gateway-swagger-extensions.md) 的更多信息，以使用导入工具创建和部署 API 和方法。利用 Swagger 导入程序工具，您还可以更新现有 API。 | 2015 年 7 月 21 日 | 
| 映射模板参考 | 在 `$input` 中，阅读有关 [API Gateway 的用于数据转换的变量](api-gateway-mapping-template-reference.md) 参数及其函数的信息。 | 2015 年 7 月 18 日 | 
| 第一个公开发布版 | 这是 *API Gateway 开发人员指南*的第一个公开发行版。 | 2015 年 7 月 9 日 |