API Gateway 中用于配置和运行 REST API 的配额
在 Amazon API Gateway 中配置和运行 REST API 时适用以下配额。如果配额是按 API 分配的，则只能对特定的 API 增加配额，而不能对账户中的所有 API 增加配额。
有关账户级别配额的信息，请参阅Amazon API Gateway 配额。
| 资源或操作 | 默认配额 | 能否增加 |
|---|---|---|
| 每个区域每个账户的公共自定义域名数 | 120 | 是 |
| 每个区域每个账户的私有自定义域名数 | 50 | 是 |
| 每区域的区域 API | 600 | 否 |
| 每区域的边缘优化 API | 120 | 否 |
| 每个区域每个账户的私有 API 数 | 600 | 否 |
| 每个账户的域名访问关联数 | 100 | 是 |
| 每个域的多级 API 映射 | 200 | 否 |
| 以字符数表示的边缘优化 API 的 URL 长度 | 8192 | 否 |
| 以字符数表示的区域 API 的 URL 长度 | 10240 | 否 |
| API Gateway 资源策略的字符长度 | 8192 | 是 |
| 每区域每账户的 API 密钥数 | 10000 | 否 |
| 每区域每账户的客户端证书数 | 60 | 是 |
| 每个 API 的授权方（Amazon Lambda 和 Amazon Cognito） | 10 |
是 要提高该配额，请联系 Amazon Support Center |
| 每个 API 的文档部分 | 2000 |
是 要提高该配额，请联系 Amazon Support Center |
| 每个 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 字节。如果您的方法包含路径参数，而客户端使用的值超过 ARN 长度，则 API 将返回 414 Request URI too long 响应。 |
否 |
| 使用计划中某个阶段方法一级的节流设置 | 20 |
是 要提高该配额，请联系 Amazon Support Center |
| 每个 API 的模型大小 | 400KB | 否 |
| 信任存储中的证书数量 | 1000 个证书，对象总大小不超过 1 MB。 | 否 |
| 空闲连接超时 | 310 秒 | 否 |
| 使用 restapi:import 或 restapi:put 时的最大 API 定义文件大小 | 6 MB | 否 |
* 您不能将集成超时设置为小于 50 毫秒。可以将区域 API 和私有 API 的集成超时提高到 29 秒以上，但这可能需要降低账户的区域级节流配额。
减少配额的最佳实践
以下最佳实践可能有助于减少您当前的资源数量，从而避免增加配额。请确保这些建议适用于您的 API 架构。
- 每区域的 API 数
-
要减少每区域的 API 数量，请导出所有未使用的 API，然后将其从 API Gateway 中删除。有关更多信息，请参阅 从 API Gateway 导出 REST API。
- 每个 API 的阶段
-
要减少每个 API 的阶段数，请将您的 API 拆分为多个 API。
- 每个 API 的资源
-
使用
{proxy+}路径来减少资源数。有关更多信息，请参阅 设置具有代理资源的代理集成。 - API 映射
-
要减少自定义域名的 API 映射数量，请使用具有单个级别的 API 映射，例如
/prod。具有单个级别的 API 映射不计入 API 映射配额。 - 每个 API 的授权方
要减少每个 API 的授权方数量，请跨 API 方法重用授权方。
- 每个 API 的文档部分
-
要减少每个 API 的文档部分数量，请在导入 API 时使用
ignore=documentation。有关更多信息，请参阅导入 API 文档。还可以使用内容继承，来支持某些文档部分从更通用规范的 API 实体继承内容。有关更多信息，请参阅 API 文档在 API Gateway 中的表示形式。
- API Gateway 资源策略的字符长度
-
要减少资源策略的长度，请使用 Amazon WAFV2 来保护您的 API。有关更多信息，请参阅 在 API Gateway 中使用 Amazon WAF 保护 REST API。
如果您的策略包含 IP 地址，也可以使用范围而不是特定值来定义 IP 地址。
- 每个 API 密钥的使用计划
-
要减少每个 API 密钥的使用计划数量，请为每个使用计划使用一个 API 密钥，并将使用计划与多个 API 关联。建议不要在多个使用计划间共享一个 API 密钥。