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}) の最大長は 1,600 バイトです。パスパラメータ値 (ランタイムにサイズが決定される) により、ARN の長さが制限を超過する可能性があります。この場合、API クライアントは 414 Request URI too long レスポンスを受け取ります。

注記

これによって、リソースポリシーが使用される場合の URI の長さが制限されます。リソースポリシーが必要となるプライベート API の場合は、すべてのプライベート API の URI の長さが制限されます。

API Gateway アカウントレベルのクォータ (リージョンごと)

以下のクォータは、アカウントごと、Amazon API Gateway のリージョンごとに適用されます。

リソースまたはオペレーション デフォルトのクォータ 引き上げ可能
HTTP API、REST API、WebSocket API、WebSocket コールバック API にわたってリージョンごとに適用されるアカウント単位のスロットリングクォータ 10,000 リクエスト/秒 (RPS) と、トークンバケットアルゴリズムで提供される追加のバースト容量 (最大バケット容量は 5,000 リクエスト *)。
注記

バーストクォータは、リージョンのアカウントの全体的な RPS クォータに基づいて、API Gateway サービスチームによって決定されます。このクォータは顧客が制御したり変更をリクエストできるものではありません。

はい
リージョンの API 600 いいえ
エッジ最適化 API 120 不可

* 次のリージョンでは、デフォルトのスロットリングクォータは 2500 RPS、デフォルトのバーストクォータは 1250 RPS です: アフリカ (ケープタウン)、欧州 (ミラノ)、アジアパシフィック (ジャカルタ)、中東 (アラブ首長国連邦)、アジアパシフィック (ハイデラバード)、アジアパシフィック (メルボルン)、欧州 (スペイン)、欧州 (チューリッヒ)、イスラエル (テルアビブ)、カナダ西部 (カルガリー)、アジアパシフィック (マレーシア)。

HTTP API クォータ

次のクォータは、API Gateway での HTTP API の設定と実行に適用されます。

リソースまたはオペレーション デフォルトのクォータ 引き上げ可能
API あたりのルート数 300 はい
API あたりの統合の数 300 いいえ
最大統合タイムアウト 30 秒 いいえ
API あたりのステージ数 10 [Yes (はい)]
ドメインごとのマルチレベル API マッピング 200 不可
ステージごとのタグ 50 いいえ
リクエスト行とヘッダー値の合計サイズ 10240 バイト いいえ
ペイロードサイズ 10 MB いいえ
1 アカウント、1 リージョンあたりのカスタムドメイン 120 はい
アクセスログテンプレートのサイズ 3 KB いいえ
Amazon CloudWatch Logs のログエントリ 1 MB いいえ
API ごとのオーソライザー数 10 はい
オーソライザーあたりの対象者数 50 いいえ
ルートあたりのスコープ数 10 いいえ
JSON ウェブキーセットエンドポイントのタイムアウト 1500 ms いいえ
JSON Web Key Set エンドポイントからのレスポンスサイズ 150,000 バイト いいえ
OpenID Connect 検出エンドポイントのタイムアウト 1500 ms 不可
Lambda オーソライザーレスポンスのタイムアウト 10000 ミリ秒 不可
1 アカウント、1 リージョンあたりの VPC リンク 10 はい
VPC リンクあたりのサブネットの数 10 はい
ステージごとのステージ変数 100 いいえ
ステージ変数内のキー長さ (文字数) 64 いいえ
ステージ変数内の値の長さ (文字数) 512 不可

WebSocket API の設定と実行に関する API Gateway クォータ

Amazon API Gateway での WebSocket API の設定と実行には、次のクォータが適用されます。

リソースまたはオペレーション デフォルトのクォータ 引き上げ可能
1 秒あたり、1 アカウント (すべての WebSocket API 間) あたり、1 リージョンあたりの新しい接続数 500 はい
同時接続 対象外 該当しません
API ごとの AWS Lambda オーソライザー 10 はい
AWS Lambda オーソライザー結果サイズ 8 KB いいえ
API あたりのルート数 300 はい
API あたりの統合の数 300 可能
統合のタイムアウト Lambda、Lambda プロキシ、HTTP、HTTP プロキシ、AWS 統合など、すべての統合タイプで 50 ミリ秒〜29 秒。 不可
API あたりのステージ数 10 はい
WebSocket のフレームサイズ 32 KB いいえ
メッセージのペイロードサイズ 128 KB ** 不可
マッピングテンプレートの最大サイズ 300 KB 不可
WebSocket API の接続時間 2 時間 いいえ
アイドル接続のタイムアウト 10 分 不可
WebSocket API の URL の長さ (文字数) 4096 不可

* API Gateway は、同時接続にクォータを適用しません。同時接続の最大数は、1 秒あたりの新規接続数と 2 時間の最大接続時間によって決まります。たとえば、デフォルトのクォータが 500 新規接続/秒の場合、クライアントが 2 時間を超える最大速度で接続する場合、API Gateway は最大 3,600,000 の同時接続を提供することができます。

** WebSocket フレームサイズには 32 KB のクォータがあるため、32 KB を超えるメッセージはそれぞれが 32 KB 以下の複数のフレームに分割する必要があります。これは @connections のコマンドにも該当します。それより大きなメッセージ (または大きなフレームサイズ) が受信された場合、接続は 1009 コードで閉じられます。

REST API の設定および実行に関する API Gateway クォータ

Amazon API Gateway での REST API の設定と実行には、次のクォータが適用されます。restapi:import または restapi:put では、API 定義ファイルの最大サイズは、6 MB です。

API あたりのすべてのクォータは、特定の API でのみ引き上げることができます。

リソースまたはオペレーション デフォルトのクォータ 引き上げ可能
1 アカウント、1 リージョンあたりのカスタムドメイン名 120 可能
ドメインごとのマルチレベル API マッピング 200 不可
エッジ最適化 API の URLの長さ (文字数) 8192 いいえ
リージョン API の URL の長さ (文字数) 10240 いいえ
1 アカウント、1 リージョンあたりのプライベート API 600 いいえ
API Gateway リソースポリシーの長さ (文字単位) 8192 はい
1 アカウント、1 リージョンあたりの API キー 10000 不可
1 アカウント、1 リージョンあたりのクライアント証明書 60 はい
API ごとのオーソライザー (AWS Lambda および Amazon Cognito) 10 はい
API あたりのドキュメント部分 2000 はい
API あたりのリソース数 300 はい
API あたりのステージ数 10 はい
ステージごとのステージ変数 100 いいえ
ステージ変数内のキー長さ (文字数) 64 いいえ
ステージ変数内の値の長さ (文字数) 512 いいえ
1 アカウント、1 リージョンあたりの使用量プラン 300 はい
API キーあたりの使用量プラン 10 はい
1 アカウント、1 リージョンあたりの VPC リンク 20 はい
API キャッシュの TTL デフォルトで 300 秒、API 所有者が 0~3600 の範囲で設定可能。 上限あり (3600)
キャッシュされたレスポンスサイズ 1048576 バイト。キャッシュデータの暗号化により、キャッシュされるアイテムのサイズが増える可能性があります。 いいえ
統合のタイムアウト Lambda、Lambda プロキシ、HTTP、HTTP プロキシ、AWS 統合など、すべての統合タイプで 50 ミリ秒〜29 秒。 はい *
ヘッダー名、値、行末記号、空白を含むすべてのヘッダー値の合計サイズ 10,240 バイト 不可
プライベート API のすべてのヘッダー値の合計サイズ 8000 バイト 不可
ペイロードサイズ 10 MB いいえ
ステージごとのタグ 50 いいえ
マッピングテンプレートでの #foreach ... #end ループ内での反復回数 1000 不可
マッピングテンプレートの最大サイズ 300 KB 不可
認可があるメソッドの ARN の長さ 1600 バイト いいえ
使用量プランのステージに対するメソッドレベルのスロットリング設定 20 可能
API あたりのモデルサイズ 400 KB 不可
トラストストアの証明書数 1,000 件の証明書 (合計オブジェクトサイズは最大 1 MB) 不可

* 統合タイムアウトを 50 ミリ秒未満に設定することはできません。リージョン API とプライベート API の統合タイムアウトは 29 秒超に設定できますが、これに伴ってアカウントにおけるリージョンレベルのスロットリングクォータ制限の緩和が必要になる場合があります。

API の作成、デプロイ、管理に関する API Gateway クォータ

以下の固定クォータは、AWS CLI、API Gateway コンソール、または API Gateway REST API とその SDK を使用して、API Gateway で API の作成、デプロイ、および管理に適用されます。これらのクォータを増やすことはできません。

アクション デフォルトのクォータ 引き上げ可能
CreateApiKey アカウントあたり 1 秒ごとに 5 リクエスト いいえ
CreateDeployment アカウントあたり 5 秒ごとに 1 リクエスト いいえ
CreateDocumentationVersion アカウントあたり 20 秒ごとに 1 リクエスト いいえ
CreateDomainName アカウントあたり 30 秒ごとに 1 リクエスト いいえ
CreateResource アカウントあたり 1 秒ごとに 5 リクエスト いいえ
CreateRestApi
リージョン API またはプライベート API
  • アカウントあたり 3 秒ごとに 1 リクエスト

エッジ最適化 API
  • アカウントあたり 30 秒ごとに 1 リクエスト

いいえ
CreateVpcLink (V2) アカウントあたり 15 秒ごとに 1 リクエスト いいえ
DeleteApiKey アカウントあたり 1 秒ごとに 5 リクエスト いいえ
DeleteDomainName アカウントあたり 30 秒ごとに 1 リクエスト いいえ
DeleteResource アカウントあたり 1 秒ごとに 5 リクエスト いいえ
DeleteRestApi アカウントあたり 30 秒ごとに 1 リクエスト いいえ
GetResources アカウントあたり 2 秒ごとに 5 リクエスト いいえ
DeleteVpcLink (V2) アカウントあたり 30 秒ごとに 1 リクエスト いいえ
ImportDocumentationParts アカウントあたり 30 秒ごとに 1 リクエスト いいえ
ImportRestApi
リージョン API またはプライベート API
  • アカウントあたり 3 秒ごとに 1 リクエスト

エッジ最適化 API
  • アカウントあたり 30 秒ごとに 1 リクエスト

いいえ
PutRestApi アカウントあたり 1 秒ごとに 1 リクエスト いいえ
UpdateAccount アカウントあたり 20 秒ごとに 1 リクエスト いいえ
UpdateDomainName アカウントあたり 30 秒ごとに 1 リクエスト いいえ
UpdateUsagePlan アカウントあたり 20 秒ごとに 1 リクエスト いいえ
その他のオペレーション 合計アカウントクォータまでのクォータはありません。 いいえ
合計オペレーション数 1 秒あたり 10 リクエストで、バーストクォータは 1 秒あたり 40 リクエスト。 いいえ