本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
在 API Gateway 中設定和執行 REST API 的配額
下列配額適用於在 Amazon API Gateway 中設定和執行 REST API。如果配額是每個 API，則只能在特定 APIs上增加配額，而不能用於帳戶中的所有 APIs。
如需帳戶層級配額的詳細資訊，請參閱 Amazon API Gateway 配額。
| 資源或操作 | 預設配額 | 可以提高 |
|---|---|---|
| 每個區域每個帳戶的公有自訂網域名稱 | 120 | 是 |
| 每個區域每個帳戶的私有自訂網域名稱 | 50 | 是 |
| 每個區域的區域 APIs | 600 | 否 |
| 每個區域的邊緣最佳化 APIs | 120 | 否 |
| 每個區域每個帳戶的私有 API | 600 | 否 |
| 每個帳戶的網域名稱存取關聯 | 100 | 是 |
| 每個網域的多層 API 映射 | 200 | 否 |
| 每個網域的路由規則 | 50 | 是 |
| 邊緣最佳化 API 的 URL 長度 (以字元為單位) | 8192 | 否 |
| 區域性 API 的 URL 長度 (以字元為單位) | 10240 | 否 |
| API Gateway 資源政策的長度 (以字元為單位) | 8192 | 是 |
| 每個區域每個帳戶的 API 金鑰 | 10000 | 否 |
| 每個區域每個帳戶的用戶端憑證 | 60 | 是 |
| 每個 API (AWS Lambda 和 Amazon Cognito) 的授權方 | 10 |
是 若要增加此配額，請聯絡 AWS 支援中心 |
| 每個 API 的文件部分 | 2000 |
是 若要增加此配額，請聯絡 AWS 支援中心 |
| 每個 API 資源 | 300 | 是 |
| 每個 API 階段 | 10 | 是 |
| 每個階段的階段變數 | 100 | 否 |
| 階段變數中的金鑰長度 (以字元為單位) | 64 | 否 |
| 階段變數中的數值長度 (以字元為單位) | 512 | 否 |
| 每個區域每個帳戶的用量計劃 | 300 | 是 |
| 每個 API 金鑰的用量計畫 | 10 | 是 |
| 每個區域每個帳戶的 VPC 連結 | 20 | 是 |
| API 快取 TTL | 預設值為 300 秒，而且 API 擁有者可以設定為 0 與 3600 之間的值。 | 不適用於上限 (3600) |
| 快取的回應大小 | 1048576 個位元組。快取資料加密可能增加正在快取的項目大小。 | 否 |
| 區域 APIs整合逾時 | 50 毫秒 - 所有整合類型的 29 秒，包括 Lambda、Lambda 代理、HTTP、HTTP 代理和 AWS 整合。 | 是 * |
| 邊緣最佳化 APIs整合逾時 | 50 毫秒 - 所有整合類型的 29 秒，包括 Lambda、Lambda 代理、HTTP、HTTP 代理和 AWS 整合。 | 否 |
| 私有 APIs整合逾時 | 50 毫秒 - 所有整合類型的 29 秒，包括 Lambda、Lambda 代理、HTTP、HTTP 代理和 AWS 整合。 | 是 * |
| 所有標頭值的總合併大小，包括標頭名稱、值、任何換行符號和空格 | 10240 個位元組 | 否 |
| 一個私有 API 所有標頭值的總合併大小 | 8000 個位元組 | 否 |
| 承載大小 | 10 MB | 否 |
| 每個階段的標籤 | 50 | 否 |
映射範本中 #foreach ... #end 迴圈的反覆運算數目 |
1000 | 否 |
| 映射範本大小上限 | 300 KB | 否 |
| 方法 ARN 長度 | 1600 個位元組。如果您的方法包含路徑參數，且用戶端使用超過 ARN 長度的值，則您的 API 將傳回414 Request URI too long回應。 |
否 |
| 用量計劃中單一階段的方法層級調節設定 | 20 |
是 若要增加此配額，請聯絡 AWS 支援中心 |
| 每個 API 的資料大小 | 400 KB | 否 |
| 信任庫中的憑證數量 | 1,000 個憑證，總物件大小上限為 1 MB。 | 否 |
| 閒置連線逾時 | 310 秒 | 否 |
| 使用 restapi：import 或 restapi：put 時的 API 定義檔案大小上限 | 6 MB | 否 |
* 您無法將整合逾時設定為小於 50 毫秒。您可以將整合逾時提高到 29 秒以上，但這可能需要減少您帳戶的區域層級調節配額。
降低配額的最佳實務
下列最佳實務可能有助於減少您目前的資源數量，以避免增加您的配額。請確定這些建議適用於 API 的架構。
- 每個區域的 APIs
-
若要減少每個區域的 APIs 數量，請匯出任何未使用的 APIs，然後從 API Gateway 刪除它們。如需詳細資訊，請參閱從 API Gateway 匯出 REST API。
- 每個 API 階段
-
若要減少每個 API 的階段數，請將您的 API 分割成多個 APIs。
- 每個 API 資源
-
使用
{proxy+}路徑來減少資源數量。如需詳細資訊，請參閱設定代理整合與代理資源。 - API 映射
-
若要減少自訂網域名稱的 API 映射數量，請使用具有單一層級的 API 映射，例如
/prod。具有單一層級的 API 映射不會計入 API 映射配額。 - 每個 API 的授權方
若要減少每個 API 的授權方數量，請跨 API 方法重複使用授權方。
- 每個 API 的文件部分
-
若要減少每個 API 的文件組件數量，請在匯入 API
ignore=documentation時使用 。如需詳細資訊，請參閱匯入 API 文件。您也可以使用內容繼承來允許某些文件組件從更一般規格的 API 實體繼承內容。如需詳細資訊，請參閱API Gateway 中的 API 文件表示。
- API Gateway 資源政策的長度 (以字元為單位)
-
若要減少資源政策的長度，請使用 AWS WAFV2 來保護您的 API。如需詳細資訊，請參閱使用 AWS WAF 來保護 API Gateway APIs 中的 REST API。
如果您的政策包含 IP 地址，您也可以使用範圍而非特定值來定義 IP 地址。
- 每個 API 金鑰的用量計畫
-
若要減少每個 API 金鑰的用量計劃數量，請針對每個用量計劃使用一個 API 金鑰，並將您的用量計劃與多個 APIs建立關聯。我們不建議跨多個用量計劃共用一個 API 金鑰。
