# API Gateway 中用于配置和运行 REST API 的配额
<a name="api-gateway-execution-service-limits-table"></a>

在 Amazon API Gateway 中配置和运行 REST API 时适用以下配额。如果配额是按 API 分配的，则只能对特定的 API 增加配额，而不能对账户中的所有 API 增加配额。

有关账户级别配额的信息，请参阅[Amazon API Gateway 配额](limits.md)。


| 资源或操作 | 默认配额 | 能否增加 | 
| --- | --- | --- | 
| 每个区域每个账户的公共自定义域名数 | 120 | [可以](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-A93447B8)。 | 
| 每个区域每个账户的私有自定义域名数 | 50 | [可以](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-24E7E662) | 
| 每区域的区域 API | 600 | 否 | 
| 每区域的边缘优化 API | 120 | 否 | 
| 每个区域每个账户的私有 API 数 | 600 | 否 | 
| 每个账户的域名访问关联数 | 100 | [是](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-4D98A8A5) | 
| 每个域的多级 API 映射 | 200 | 否 | 
| 每个域的路由规则数 | 50 | [可以](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-68B79FF0) | 
| 以字符数表示的边缘优化 API 的 URL 长度 | 8192 | 否 | 
| 以字符数表示的区域 API 的 URL 长度 | 10240 | 否 | 
| 以字符数表示的私有 API 的 URL 长度 | 8192 | 否 | 
| API Gateway 资源策略的字符长度 | 8192 | [可以](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-8B81B02C)。 | 
| 每区域每账户的 API 密钥数 | 10000 | 否 | 
| 每区域每账户的客户端证书数 | 60 | [可以](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-824C9E42)。 | 
| 每个 API 的授权方（AWS Lambda 和 Amazon Cognito） | 10 |  是 要提高该配额，请联系 [AWS Support Center](https://console.aws.amazon.com/support/home#/)  | 
| 每个 API 的文档部分 | 2000 |  是 要提高该配额，请联系 [AWS Support Center](https://console.aws.amazon.com/support/home#/)  | 
| 每个 API 的资源 | 300 | [可以](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-01C8A9E0)。 | 
| 每个 API 的阶段 | 10 | [是](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-379E48B0) | 
| 每个阶段的阶段变量 | 100 | 否 | 
| 阶段变量中以字符数表示的键长度 | 64 | 否 | 
| 阶段变量中以字符数表示的值长度 | 512 | 否 | 
| 每区域每账户的使用计划数 | 300 | [可以](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-E8693075)。 | 
| 每个 API 密钥的使用计划 | 10 | [是](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-985EB478) | 
| 每区域每账户的 VPC 链接数 | 20 | [是](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-A4C7274F) | 
| API 缓存 TTL | 默认情况下为 300 秒，可由 API 所有者配置为 0 到 3600 秒之间。 | 上限 (3600) 处不可增加 | 
| 缓存响应大小 | 1048576 字节。缓存数据加密可能会增加正在缓存的项目的大小。 | 否 | 
| 区域 API 的集成超时 | 50 毫秒 - 对于所有集成类型（包括 Lambda、Lambda 代理、HTTP、HTTP 代理和AWS集成）均为 29 秒。 | [是\$1](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-E5AE38E3) | 
| 边缘优化 API 的集成超时 | 50 毫秒 - 对于所有集成类型（包括 Lambda、Lambda 代理、HTTP、HTTP 代理和AWS集成）均为 29 秒。 | 否 | 
| 私有 API 的集成超时 | 50 毫秒 - 对于所有集成类型（包括 Lambda、Lambda 代理、HTTP、HTTP 代理和AWS集成）均为 29 秒。 | [是 \$1](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-E5AE38E3) | 
| 所有标头值的总组合大小，包括标头名称、值、任何行终止符和空格 | 10240 字节 | 否 | 
| 私有 API 的所有标头值的总组合大小 | 8000 字节 | 否 | 
| 负载大小 | 10 MB | 否 | 
| 每阶段的标签数 | 50 | 否 | 
| 映射模板的 \$1foreach ... \$1end 循环中迭代的数量 | 1000 | 否 | 
| 最大映射模板大小 | 300KB | 否 | 
| 访问日志模板大小 | 3 KB | 否 | 
| 方法 ARN 长度 | 1600 字节。如果您的方法包含路径参数，而客户端使用的值超过 ARN 长度，则 API 将返回 414 Request URI too long 响应。 | 否 | 
| 使用计划中某个阶段方法一级的节流设置 | 20 |  是 要提高该配额，请联系 [AWS Support Center](https://console.aws.amazon.com/support/home#/)  | 
| 每个 API 的模型大小 | 400KB | 否 | 
| 信任存储中的证书数量 | 1000 个证书，对象总大小不超过 1 MB。 | 否 | 
| 空闲连接超时 | 310 秒 | 否 | 
| 使用 [restapi:import](https://docs.aws.amazon.com/apigateway/latest/api/API_ImportRestApi.html) 或 [restapi:put](https://docs.aws.amazon.com/apigateway/latest/api/API_PutRestApi.html) 时的最大 API 定义文件大小 | 6 MB | 否 | 

\$1 您不能将集成超时设置为小于 50 毫秒。可以将集成超时提高到 29 秒以上，但这可能需要降低账户的区域级节流配额。

## 减少配额的最佳实践
<a name="api-gateway-execution-service-limits-best-practices"></a>

以下最佳实践可能有助于减少您当前的资源数量，从而避免增加配额。请确保这些建议适用于您的 API 架构。

**每区域的 API 数**  
要减少每区域的 API 数量，请导出所有未使用的 API，然后将其从 API Gateway 中删除。有关更多信息，请参阅 [从 API Gateway 导出 REST API](api-gateway-export-api.md)。

**每个 API 的阶段**  
要减少每个 API 的阶段数，请将您的 API 拆分为多个 API。

**每个 API 的资源**  
使用 `{proxy+}` 路径来减少资源数。有关更多信息，请参阅 [设置具有代理资源的代理集成](api-gateway-set-up-simple-proxy.md)。

**API 映射**  
要减少自定义域名的 API 映射数量，请使用具有单个级别的 API 映射，例如 `/prod`。具有单个级别的 API 映射不计入 API 映射配额。

**每个 API 的授权方**  
要减少每个 API 的授权方数量，请跨 API 方法重用授权方。

**每个 API 的文档部分**  
要减少每个 API 的文档部分数量，请在导入 API 时使用 `ignore=documentation`。有关更多信息，请参阅 [导入 API 文档](api-gateway-documenting-api-quick-start-import-export.md)。  
还可以使用内容继承，来支持某些文档部分从更通用规范的 API 实体继承内容。有关更多信息，请参阅 [API 文档在 API Gateway 中的表示形式](api-gateway-documenting-api-content-representation.md)。

**API Gateway 资源策略的字符长度**  
要减少资源策略的长度，请使用 AWS WAFV2 来保护您的 API。有关更多信息，请参阅 [在 API Gateway 中使用 AWS WAF 保护 REST API](apigateway-control-access-aws-waf.md)。  
如果您的策略包含 IP 地址，也可以使用范围而不是特定值来定义 IP 地址。

**每个 API 密钥的使用计划**  
要减少每个 API 密钥的使用计划数量，请为每个使用计划使用一个 API 密钥，并将使用计划与多个 API 关联。建议不要在多个使用计划间共享一个 API 密钥。