本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 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 支援中心](https://console.aws.amazon.com/support/home#/)  | 
| 每個 API 的文件部分 | 2000 |  是 若要增加此配額，請連絡 [AWS 支援中心](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 毫秒 - 所有整合類型的 29 秒，包括 Lambda、Lambda 代理、HTTP、HTTP 代理和 AWS 整合。 | [是 \$1](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-E5AE38E3) | 
| 邊緣最佳化 API 的整合逾時 | 50 毫秒 - 所有整合類型的 29 秒，包括 Lambda、Lambda 代理、HTTP、HTTP 代理和 AWS 整合。 | 否 | 
| 私有 API 的整合逾時 | 50 毫秒 - 所有整合類型的 29 秒，包括 Lambda、Lambda 代理、HTTP、HTTP 代理和 AWS 整合。 | [是 \$1](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-E5AE38E3) | 
| 所有標頭值的總合併大小，包括標頭名稱、值、任何換行符號和空格 | 10240 個位元組 | 否 | 
| 一個私有 API 所有標頭值的總合併大小 | 8000 個位元組 | 否 | 
| 承載大小 | 10 MB | 否 | 
| 每個階段的標籤 | 50 | 否 | 
| 映射範本中 \$1foreach ... \$1end 迴圈的反覆運算數目 | 1000 | 否 | 
| 映射範本大小上限 | 300 KB | 否 | 
| 存取日誌範本大小 | 3 KB | 否 | 
| 方法 ARN 長度 | 1600 個位元組。如果您的方法包含路徑參數，且用戶端使用的值超過 ARN 長度，則您的 API 將傳回 414 Request URI too long 回應。 | 否 | 
| 用量計劃中單一階段的方法層級調節設定 | 20 |  是 若要增加此配額，請連絡 [AWS 支援中心](https://console.aws.amazon.com/support/home#/)  | 
| 每個 API 的資料大小 | 400 KB | 否 | 
| 信任庫中的憑證數量 | 1,000 個憑證，總物件大小上限為 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 Gateway 中的 API 文件表示](api-gateway-documenting-api-content-representation.md)。

**API Gateway 資源政策的長度 (以字元為單位)**  
若要減少資源政策的長度，請使用 AWS WAFV2 來保護您的 API。如需詳細資訊，請參閱[使用 AWS WAF 來保護 API Gateway APIs 中的 REST API](apigateway-control-access-aws-waf.md)。  
如果您的政策包含 IP 位址，您也可以使用範圍而非特定值來定義 IP 位址。

**每個 API 金鑰的用量計畫**  
若要減少每個 API 金鑰的用量計畫數量，則讓每個用量計畫使用一個 API 金鑰，並將您的用量計畫與多個 API 建立關聯。我們不建議在多個用量計畫之間共用一個 API 金鑰。