Amazon API Gateway 配額和重要備註 - Amazon API Gateway

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

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),具有權杖儲存貯體演算法 提供的額外爆量容量,使用 5,000 個請求的最大儲存貯體容量。 *
注意

爆量配額是由 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:importrestapi: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
  • 每個帳戶每 3 秒 1 個請求。

邊緣最佳化 API
  • 每個帳戶每 30 秒 1 個請求。

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
  • 每個帳戶每 3 秒 1 個請求。

邊緣最佳化 API
  • 每個帳戶每 30 秒 1 個請求。

PutRestApi 每個帳戶每秒 1 個請求
UpdateAccount 每個帳戶每 20 秒 1 個請求。
UpdateDomainName 每個帳戶每 30 秒 1 個請求。
UpdateUsagePlan 每個帳戶每 20 秒 1 個請求。
其他操作 配額不可超過帳戶配額總計。
操作總計 每秒 10 個請求 (rps),爆量配額為每秒 40 個請求。