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)，额外的突增容量由令牌存储桶算法注意突增配额由 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:import 或 restapi: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
边缘优化的 API
|
否 |
| 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
边缘优化的 API
|
否 |
| PutRestApi | 每账户每秒 1 个请求 | 否 |
| UpdateAccount | 每账户每 20 秒 1 个请求 | 否 |
| UpdateDomainName | 每账户每 30 秒 1 个请求 | 否 |
| UpdateUsagePlan | 每账户每 20 秒 1 个请求 | 否 |
| 其他操作 | 无配额到不超过账户总配额。 | 否 |
| 总操作 | 每秒 10 个请求，突增配额为每秒 40 个请求。 | 否 |