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) と、トークンバケットアルゴリズム注記バーストクォータは、リージョンのアカウントの全体的な 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
エッジ最適化 API
|
いいえ |
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
エッジ最適化 API
|
いいえ |
PutRestApi | アカウントあたり 1 秒ごとに 1 リクエスト | いいえ |
UpdateAccount | アカウントあたり 20 秒ごとに 1 リクエスト | いいえ |
UpdateDomainName | アカウントあたり 30 秒ごとに 1 リクエスト | いいえ |
UpdateUsagePlan | アカウントあたり 20 秒ごとに 1 リクエスト | いいえ |
その他のオペレーション | 合計アカウントクォータまでのクォータはありません。 | いいえ |
合計オペレーション数 | 1 秒あたり 10 リクエストで、バーストクォータは 1 秒あたり 40 リクエスト。 | いいえ |