本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
在 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 | 否 |
| 每個網域的路由規則 | 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 個位元組。快取資料加密可能增加正在快取的項目大小。 | 否 |
| 區域 API 的整合逾時 | 50 毫秒 - 所有整合類型都是 29 秒 (包含 Lambda、Lambda 代理、HTTP、HTTP 代理和 AWS 整合)。 | 是 * |
| 邊緣最佳化 API 的整合逾時 | 50 毫秒 - 所有整合類型都是 29 秒 (包含 Lambda、Lambda 代理、HTTP、HTTP 代理和 AWS 整合)。 | 否 |
| 私有 API 的整合逾時 | 50 毫秒 - 所有整合類型都是 29 秒 (包含 Lambda、Lambda 代理、HTTP、HTTP 代理和 AWS 整合)。 | 是 * |
| 所有標頭值的總合併大小，包括標頭名稱、值、任何換行符號和空格 | 10240 個位元組 | 否 |
| 一個私有 API 所有標頭值的總合併大小 | 8000 個位元組 | 否 |
| 承載大小 | 10 MB | 否 |
| 每個階段的標籤 | 50 | 否 |
映射範本中 #foreach ... #end 迴圈的反覆運算數目 |
1000 | 否 |
| 映射範本大小上限 | 300 KB | 否 |
| 存取日誌範本大小 | 3 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 架構。
- 每個區域的 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 Gateway 中的 API 文件表示。
- API Gateway 資源政策的長度 (以字元為單位)
-
若要減少資源政策的長度，請使用 AWS WAFV2 來保護您的 API。如需更多詳細資訊，請參閱 使用 AWS WAF 保護 API Gateway 中的 REST API。
如果您的政策包含 IP 位址，您也可以使用範圍而非特定值來定義 IP 位址。
- 每個 API 金鑰的用量計畫
-
若要減少每個 API 金鑰的用量計畫數量，則讓每個用量計畫使用一個 API 金鑰，並將您的用量計畫與多個 API 建立關聯。我們不建議在多個用量計畫之間共用一個 API 金鑰。
