Amazon API Gateway のクォータと重要な注意点 - Amazon API Gateway

Amazon API Gateway のクォータと重要な注意点

特に明記されていない限り、クォータはリクエストに応じて引き上げることができます。クォータの引き上げをリクエストするには、サービスクォータを使用するか、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 はい
ステージごとのタグ 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 いいえ
1 アカウント、1 リージョンあたりの VPC リンク 10 はい
VPC リンクあたりのサブネットの数 10 はい
ステージごとのステージ変数 100 いいえ

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 はい
API あたりのステージ数 10 はい
WebSocket のフレームサイズ 32 KB いいえ
メッセージのペイロードサイズ 128 KB ** いいえ
WebSocket API の接続時間 2 時間 いいえ
アイドル接続のタイムアウト 10 分 いいえ

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

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

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

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

リソースまたはオペレーション デフォルトのクォータ 引き上げ可能
1 アカウント、1 リージョンあたりのカスタムドメイン名 120 はい
エッジ最適化 API の URLの長さ (文字数) 8192 いいえ
リージョン API の URL の長さ (文字数) 10240 いいえ
1 アカウント、1 リージョンあたりのプライベート API 600 いいえ
API Gateway リソースポリシーの長さ (文字単位) 8192 はい
1 アカウント、1 リージョンあたりの API キー 500 はい
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 バイト いいえ
ペイロードサイズ 10 MB いいえ
ステージごとのタグ 50 いいえ
マッピングテンプレートでの #foreach ... #end ループ内での反復回数。 1,000 いいえ
認証があるメソッドの ARN の長さ 1600 バイト いいえ

restapi:import または restapi:put では、API 定義ファイルの最大サイズは、6 MB です。

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

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 リクエスト。 いいえ