本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Amazon API Gateway 配額和重要備註
下一節說明 Amazon API Gateway 的配額。除非另有說明,否則可以在請求時提高配額。若要請求提高配額,您可以使用 Service Quotas 或與 AWS 支援中心
方法啟用授權時,方法 ARN(例如 arn:aws:execute-api:{region-id}:{account-id}:{api-id}/{stage-id}/{method}/{resource}/{path}
) 的長度上限為 1600 個位元組。路徑參數值 (其大小是在執行階段決定) 可能會導致ARN長度超過限制。發生這種情況時,API用戶端會收到414 Request URI too long
回應。
注意
這會限制使用資源政策時URI的長度。在需要APIs資源政策的私有情況下,這會限制所有私有 URI的長度APIs。
主題
API Gateway 帳戶層級配額,每個區域
下列配額適用於 Amazon API Gateway 中的每個帳戶、每個區域。
資源或操作 | 預設配額 | 可以提高 |
---|---|---|
每個帳戶、跨 APIs WebSocket APIs、 HTTP APIs REST 和 回 WebSocket 呼每個區域的限流配額 APIs | 每秒 10,000 個請求 (RPS),具有權杖儲存貯體演算法注意爆量配額是由 API Gateway 服務團隊根據 區域中帳戶的整體RPS配額來決定。客戶無法針對該配額進行控制或請求變更。 |
是 |
區域性 APIs | 600 | 否 |
邊緣最佳化 APIs | 120 | 否 |
* 對於下列區域,預設限流配額為 2500RPS,預設爆量配額為 1250RPS:非洲 (開普敦)、歐洲 (米蘭)、亞太區域 (雅加達)、中東 (UAE)、亞太區域 (海德拉巴)、亞太區域 (墨爾本)、歐洲 (西班牙)、歐洲 (蘇黎世)、以色列 (特拉維夫) 和加拿大西部 (卡加利)、亞太區域 (馬來西亞)。
HTTP API 配額
下列配額適用於在 API Gateway HTTPAPI中設定和執行 。
資源或操作 | 預設配額 | 可以提高 |
---|---|---|
每個路由數 API | 300 | 是 |
每個 的整合 API | 300 | 否 |
最大整合逾時 | 30 秒 | 否 |
每個階段數 API | 10 | 是 |
每個網域的多層級API映射 | 200 | 否 |
每個階段的標籤 | 50 | 否 |
請求行與標頭值的總大小 | 10240 個位元組 | 否 |
承載大小 | 10 MB | 否 |
每個區域每個帳戶的自訂網域數 | 120 | 是 |
存取日誌範本大小 | 3 KB | 否 |
Amazon CloudWatch Logs 日誌項目 | 1 MB | 否 |
每個授權方 API | 10 | 是 |
每個授權方的對象 | 50 | 否 |
每個路由的範圍 | 10 | 否 |
JSON Web 金鑰集端點逾時 | 1500 毫秒 | 否 |
JSON Web 金鑰集端點的回應大小 | 150000 個位元組 | 否 |
OpenID Connect 探索端點的逾時 | 1500 毫秒 | 否 |
Lambda 授權方回應逾時 | 10000 毫秒 | 否 |
VPC 每個區域每個帳戶的連結 | 10 | 是 |
每個VPC連結的子網路數 | 10 | 是 |
每個階段的階段變數 | 100 | 否 |
階段變數中的金鑰長度 (以字元為單位) | 64 | 否 |
階段變數中的數值長度 (以字元為單位) | 512 | 否 |
API 用於設定和執行 的閘道配額 WebSocket API
下列配額適用於在 Amazon API Gateway 中設定和執行 WebSocket API。
資源或操作 | 預設配額 | 可以提高 |
---|---|---|
每個區域每個帳戶 (所有 WebSocket APIs) 每秒的新連線數 | 500 | 是 |
並行連線 | 不適用 * | 不適用 |
AWS Lambda 每個授權方 API | 10 | 是 |
AWS Lambda 授權方結果大小 | 8 KB | 否 |
每個路由數 API | 300 | 是 |
每個 的整合 API | 300 | 是 |
整合逾時 | 所有整合類型的 50 毫秒 - 29 秒,包括 Lambda、Lambda 代理、HTTP、HTTP代理和 AWS 整合。 | 否 |
每個階段數 API | 10 | 是 |
WebSocket 影格大小 | 32 KB | 否 |
訊息承載大小 | 128 KB ** | 否 |
映射範本大小上限 | 300 KB | 否 |
的連線持續時間 WebSocket API | 2 小時 | 否 |
閒置連線逾時 | 10 分鐘 | 否 |
URL 的長度,以字元表示 WebSocket API | 4096 | 否 |
* API Gateway 不會強制執行並行連線的配額。並行連線的最大數目取決於新連線每秒速率,以及兩小時期間的連線數目上限。例如,預設配額為每秒 500 個新連線,如果用戶端在兩小時內以最高速率連線,APIGateway 最多可提供 3,600,000 個並行連線。
** 由於 WebSocket 訊框大小配額為 32 KB,大於 32 KB 的訊息必須分割為多個訊框,每個訊框大小為 32 KB 或更小。這適用於 @connections
命令。如果接收到更大的訊息 (或更大的框架大小),則該連線會關閉,並出現代碼 1009。
API 用於設定和執行 的閘道配額 REST API
下列配額適用於在 Amazon API Gateway RESTAPI中設定和執行 。對於 restapi:import 或 restapi:put ,API定義檔案的大小上限為 6 MB。
所有每個API配額只能在特定 上增加APIs。
資源或操作 | 預設配額 | 可以提高 |
---|---|---|
每個區域每個帳戶的自訂網域名稱 | 120 | 是 |
每個網域的多層級API映射 | 200 | 否 |
邊緣最佳化URL的 長度,以字元表示 API | 8192 | 否 |
區域 的長度,以字元URL表示 API | 10240 | 否 |
APIs 每個區域每個帳戶的私有 | 600 | 否 |
API Gateway 資源政策的長度,以字元表示 | 8192 | 是 |
API 每個區域每個帳戶的金鑰 | 10000 | 否 |
每個區域每個帳戶的用戶端憑證 | 60 | 是 |
每個 API(AWS Lambda 和 Amazon Cognito的授權方 | 10 | 是 |
每個文件部分 API | 2000 | 是 |
每個資源 API | 300 | 是 |
每個階段數 API | 10 | 是 |
每個階段的階段變數 | 100 | 否 |
階段變數中的金鑰長度 (以字元為單位) | 64 | 否 |
階段變數中的數值長度 (以字元為單位) | 512 | 否 |
每個區域每個帳戶的用量計劃 | 300 | 是 |
每個API金鑰的使用計畫 | 10 | 是 |
VPC 每個區域每個帳戶的連結 | 20 | 是 |
API 快取 TTL | 預設 300 秒,可由API擁有者在 0 到 3600 之間設定。 | 不適用於上限 (3600) |
快取的回應大小 | 1048576 個位元組。快取資料加密可能增加正在快取的項目大小。 | 否 |
整合逾時 | 所有整合類型的 50 毫秒 - 29 秒,包括 Lambda、Lambda 代理、HTTP、HTTP代理和 AWS 整合。 | 是 * |
所有標頭值的總合併大小,包括標頭名稱、值、任何行終端器和空格 | 10240 個位元組 | 否 |
私有所有標頭值的總合併大小 API | 8000 個位元組 | 否 |
承載大小 | 10 MB | 否 |
每個階段的標籤 | 50 | 否 |
映射範本中 #foreach ... #end 迴圈的反覆運算數目 |
1000 | 否 |
映射範本大小上限 | 300 KB | 否 |
ARN 具有授權方法的長度 | 1600 個位元組 | 否 |
用量計劃中單一階段的方法層級調節設定 | 20 | 是 |
每個模型大小 API | 400 KB | 否 |
信任存放區中的憑證數量 | 1,000 個憑證,總物件大小上限為 1 MB。 | 否 |
* 您無法將整合逾時設定為小於 50 毫秒。對於區域APIs和私有 ,您可以將整合逾時提高到超過 29 秒APIs,但這可能需要降低您帳戶的區域層級限流配額限制。
API 建立、部署和管理 的閘道配額 API
下列固定配額適用於在 API Gateway API中使用 、APIGateway 主控台或 API Gateway 及其 建立 AWS CLI、部署RESTAPI和管理 SDKs。這些配額無法增加。
動作 | 預設配額 | 可以提高 |
---|---|---|
CreateApiKey | 每個帳戶每秒 5 個請求 | 否 |
CreateDeployment | 每個帳戶每 5 秒 1 個請求。 | 否 |
CreateDocumentationVersion | 每個帳戶每 20 秒 1 個請求。 | 否 |
CreateDomainName | 每個帳戶每 30 秒 1 個請求。 | 否 |
CreateResource | 每個帳戶每秒 5 個請求 | 否 |
CreateRestApi | 區域或私有 API
邊緣最佳化 API
|
否 |
CreateVpcLink (V2) | 每個帳戶每 15 秒 1 個請求。 | 否 |
DeleteApiKey | 每個帳戶每秒 5 個請求 | 否 |
DeleteDomainName | 每個帳戶每 30 秒 1 個請求。 | 否 |
DeleteResource | 每個帳戶每秒 5 個請求 | 否 |
DeleteRestApi | 每個帳戶每 30 秒 1 個請求。 | 否 |
GetResources | 每個帳戶每 2 秒 5 個請求。 | 否 |
DeleteVpcLink (V2) | 每個帳戶每 30 秒 1 個請求。 | 否 |
ImportDocumentationParts | 每個帳戶每 30 秒 1 個請求。 | 否 |
ImportRestApi | 區域或私有 API
邊緣最佳化 API
|
否 |
PutRestApi | 每個帳戶每秒 1 個請求 | 否 |
UpdateAccount | 每個帳戶每 20 秒 1 個請求。 | 否 |
UpdateDomainName | 每個帳戶每 30 秒 1 個請求。 | 否 |
UpdateUsagePlan | 每個帳戶每 20 秒 1 個請求。 | 否 |
其他操作 | 配額不可超過帳戶配額總計。 | 否 |
操作總計 | 每秒 10 個請求 (rps),爆量配額為每秒 40 個請求。 | 否 |