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

Amazon API Gateway 配额和重要说明

下一节介绍 Amazon API Gateway 的配额。除非另有说明,否则可根据请求提高配额。要申请提高配额,您可以使用 Service Quotas 或联系 Amazon Support 中心

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

注意

这将限制使用资源策略时的 URI 长度。当私有 API 中需要资源策略时,这会限制所有私有 API 的 URI 长度。

API Gateway 账户级别配额,每个区域

以下配额按 Amazon API Gateway 中的每个账户、每个区域应用。

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

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

区域 API 600
边缘优化的 API 120

* 对于以下区域,默认节流配额为 2500 RPS,而默认爆增配额为 1250 RPS:非洲(开普敦)、欧洲地区(米兰)、亚太地区(雅加达)、中东(阿联酋)、亚太地区(海得拉巴)、亚太地区(墨尔本)、欧洲(西班牙)、欧洲(苏黎世)、以色列(特拉维夫)和加拿大西部(卡尔加里)、亚太地区(马来西亚)。

HTTP API 配额

以下配额适用于在 API Gateway 中配置和运行 HTTP API。

资源或操作 默认配额 能否增加
每 API 的路由数 300
每 API 的集成数 300
最大集成超时 30 秒
每个 API 的阶段 10
每个域的多级 API 映射 200
每阶段的标签数 50
请求行和标头值的总组合大小 10240 字节
负载大小 10 MB
每个区域每个账户的自定义域数量 120
访问日志模板大小 3 KB
Amazon CloudWatch Logs 日志条目 1MB
每个 API 的授权方 10
每个授权方的受众 50
每个路由的范围 10
JSON Web 密钥集端点的超时 1500 毫秒
JSON Web 密钥集端点的响应大小 150000 字节
OpenID Connect 发现端点的超时 1500 毫秒
Lambda 授权方响应超时 10000 毫秒
每区域每账户的 VPC 链接数 10
每个 VPC 链接的子网数量 10
每个阶段的阶段变量 100
阶段变量中以字符数表示的键长度 64
阶段变量中以字符数表示的值长度 512

用于配置和运行 WebSocket API 的 API Gateway 配额

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

资源或操作 默认配额 能否增加
每区域每账户(跨所有 WebSocket API)的每秒新连接数 500
并发连接 不适用 * 不适用
Amazon Lambda每个 API 的 授权方 10
Amazon Lambda 授权方结果大小 8 KB
每 API 的路由数 300
每 API 的集成数 300
集成超时 50 毫秒 - 对于所有集成类型(包括 Lambda、Lambda 代理、HTTP、HTTP 代理和Amazon集成)均为 29 秒。
每个 API 的阶段 10
WebSocket 帧大小 32 KB
消息负载大小 128 KB **
最大映射模板大小 300KB
WebSocket API 的连接持续时间 2 小时
空闲连接超时 10 分钟
以字符数表示的 WebSocket API 的 URL 长度 4096

* API Gateway 不对并发连接强制执行配额。并发连接的最大数量取决于每秒的新连接速率和两小时的最长连接持续时间。例如,默认配额为每秒 500 个新连接,如果客户端在两小时内以最大速率连接,则 API Gateway 最多可提供 3600000 个并发连接。

** 由于 WebSocket 帧大小配额为 32 KB,因此必须将大于 32 KB 的消息拆分为多个帧,每个帧大小为 32 KB 或更小。这适用于 @connections 命令。如果接收到更大的消息(或更大的帧大小),则连接会关闭并显示代码 1009。

用于配置和运行 REST API 的 API Gateway 配额

在 Amazon API Gateway 中配置和运行 REST API 时适用以下配额。对于 restapi:importrestapi:put,API 定义文件的最大大小为 6 MB。

只能对特定 API 提高所有的每 API 配额。

资源或操作 默认配额 能否增加
每个区域每个账户的自定义域名数 120
每个域的多级 API 映射 200
以字符数表示的边缘优化 API 的 URL 长度 8192
以字符数表示的区域 API 的 URL 长度 10240
每个区域每个账户的私有 API 数 600
API Gateway 资源策略的字符长度 8192
每区域每账户的 API 密钥数 10000
每区域每账户的客户端证书数 60
每个 API 的授权方(Amazon Lambda 和 Amazon Cognito) 10
每个 API 的文档部分 2000
每个 API 的资源 300
每个 API 的阶段 10
每个阶段的阶段变量 100
阶段变量中以字符数表示的键长度 64
阶段变量中以字符数表示的值长度 512
每区域每账户的使用计划数 300
每个 API 密钥的使用计划 10
每区域每账户的 VPC 链接数 20
API 缓存 TTL 默认情况下为 300 秒,可由 API 所有者配置为 0 到 3600 秒之间。 上限 (3600) 处不可增加
缓存响应大小 1048576 字节。缓存数据加密可能会增加正在缓存的项目的大小。
集成超时 50 毫秒 - 对于所有集成类型(包括 Lambda、Lambda 代理、HTTP、HTTP 代理和Amazon集成)均为 29 秒。 是*
所有标头值的总组合大小,包括标头名称、值、任何行终止符和空格 10240 字节
私有 API 的所有标头值的总组合大小 8000 字节
负载大小 10 MB
每阶段的标签数 50
映射模板的 #foreach ... #end 循环中迭代的数量 1000
最大映射模板大小 300KB
带授权方法的 ARN 长度 1600 字节
使用计划中某个阶段方法一级的节流设置 20
每个 API 的模型大小 400KB
信任存储中的证书数量 1000 个证书,对象总大小不超过 1 MB。

* 您不能将集成超时设置为小于 50 毫秒。可以将区域 API 和私有 API 的集成超时提高到 29 秒以上,但这可能需要降低账户的区域级节流配额限制。

API Gateway 在创建、部署和管理 API 方面的配额

以下固定配额适用于使用 Amazon 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 个请求

CreateVpcLink (V2) 每账户每 15 秒 1 个请求
DeleteApiKey 每账户每秒 5 个请求
DeleteDomainName 每账户每 30 秒 1 个请求
DeleteResource 每账户每秒 5 个请求
DeleteRestApi 每账户每 30 秒 1 个请求
GetResources 每账户每 2 秒 5 个请求
DeleteVpcLink (V2) 每账户每 30 秒 1 个请求
ImportDocumentationParts 每账户每 30 秒 1 个请求
ImportRestApi
区域或私有 API
  • 每账户每 3 秒 1 个请求

边缘优化的 API
  • 每账户每 30 秒 1 个请求

PutRestApi 每账户每秒 1 个请求
UpdateAccount 每账户每 20 秒 1 个请求
UpdateDomainName 每账户每 30 秒 1 个请求
UpdateUsagePlan 每账户每 20 秒 1 个请求
其他操作 无配额到不超过账户总配额。
总操作 每秒 10 个请求,突增配额为每秒 40 个请求。