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

Amazon API Gateway 限制和重要提示

API Gateway 限制

除非另有说明,否则可根据请求提高限制。要申请提高限制,请联系 AWS 支持中心

为某个方法启用授权后,该方法的 ARN (例如,arn:aws:execute-api:{region-id}:{account-id}:{api-id}/{stage-id}/{method}/{resource}/{path}) 的最大长度为 1600 字节。路径参数值 (其大小在运行时确定) 可能导致 ARN 长度超过限制。出现这种情况是时,API 客户端将收到 414 Request URI too long 响应。

标头值限制在 10240 个字节。

API Gateway 账户级别限制

以下限制适用于 Amazon API Gateway 中的账户级别。

资源或操作 默认限制 能否放宽
跨 REST API、WebSocket API 和 WebSocket 回调 API 的每区域限制 每秒 10000 个请求 (RPS),额外的突增容量由令牌存储桶算法提供,使用的最大存储桶容量为 5000 个请求。

注意

突发限制由 API Gateway 服务团队根据账户的总体 RPS 限制确定。它不是客户可以控制或请求更改的限制。

区域 API 600
边缘优化的 API 120

配置和运行 WebSocket API 的 API Gateway 限制

在 Amazon API Gateway 中配置和运行 WebSocket API 时适用以下限制。

资源或操作 默认限制 能否放宽
每区域每账户(跨所有 WebSocket API)的每秒新连接数 500
每个 API 的 AWS Lambda 授权方 10
每 API 的路由数 300
每 API 的集成数 300
每个 API 的阶段 10
WebSocket 帧大小 32 KB
消息负载大小 128 KB

注意

由于 WebSocket 帧大小限制为 32 KB,因此必须将大于 32 KB 的消息拆分为多个帧,每个帧大小为 32 KB 或更小。如果接收到更大的消息(或更大的帧大小),则连接会关闭并显示代码 1009。

WebSocket API 的连接持续时间 2 小时
空闲连接超时 10 分钟

配置和运行 REST API 的 API Gateway 限制

在 Amazon API Gateway 中配置和运行 REST API 时适用以下限制。

资源或操作 默认限制 能否放宽
每个区域每个账户的自定义域名数 30
每个区域每个账户的私有 API 数 600
API Gateway 资源策略的字符长度 8092
每区域每账户的 API 密钥 500
每区域每账户的客户端证书 60
每个 API 的授权方数(AWS Lambda 和 Amazon Cognito) 10
每个 API 的文档部分 2000
每个 API 的资源 300
每个 API 的阶段 10
每区域每账户的使用计划 300
每个 API 密钥的使用计划 10
每个 API 阶段的每方法限制设置 20
每个区域每个账户的 VPC 链接数 20
API 缓存 TTL 默认情况下为 300 秒,可由 API 所有者配置为 0 到 3600 秒之间。 上限 (3600) 处不可增加
缓存响应大小 1048576 字节。缓存数据加密可能会增加正在缓存的项目的大小。
集成超时 50 毫秒 - 所有集成类型(包括 Lambda、Lambda 代理、HTTP、HTTP 代理和 AWS 集成)均为 29 秒。 不适用于下限或上限。
标头值大小 10240 字节
负载大小 10 MB
每阶段的标签数 50
映射模板的 #foreach ... #end 循环中迭代的数量 1000
带授权方法的 ARN 长度 1600 字节

对于 restapi:importrestapi:put,API 定义文件的最大大小为 2MB。

只能对特定 API 提高所有的每 API 限制。

API Gateway 在创建、部署和管理 API 方面的限制

以下固定限制适用于使用 AWS CLI、API Gateway 控制台或 API Gateway REST API 及其软件开发工具包在 API Gateway 中创建、部署和管理 API。这些限制不能放宽。

行动 默认限制 能否放宽
CreateApiKey 每账户每秒 5 个请求
CreateDeployment 每账户每 5 秒 1 个请求
CreateDocumentationVersion 每账户每 20 秒 1 个请求
CreateDomainName 每账户每 30 秒 1 个请求
CreateResource 每账户每秒 5 个请求
CreateRestApi

区域或私有 API

  • 每账户每 3 秒 1 个请求

边缘优化的 API

  • 每账户每 30 秒 1 个请求

DeleteApiKey 每账户每秒 5 个请求
DeleteResource 每账户每秒 5 个请求
DeleteRestApi 每账户每 30 秒 1 个请求
GetResources 每账户每 2 秒 5 个请求
ImportDocumentationParts 每账户每 30 秒 1 个请求
ImportRestApi

区域或私有 API

  • 每账户每 3 秒 1 个请求

边缘优化的 API

  • 每账户每 30 秒 1 个请求

PutRestApi 每账户每秒 1 个请求
UpdateAccount 每账户每 20 秒 1 个请求
UpdateUsagePlan 每账户每 20 秒 1 个请求
其他操作 总账户限制没有上限。
总操作 每秒 10 个请求,突增限制为每秒 40 个请求。

本页内容: