API Gateway での REST API の設定および実行に関するクォータ - Amazon API Gateway
クォータを削減するためのベストプラクティス

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

Amazon API Gateway での REST API の設定と実行には、次のクォータが適用されます。クォータが API 別の場合、アカウント内のすべての API ではなく、特定の API でのみクォータを増やすことができます。

アカウントレベルのクォータの詳細については、「Amazon API Gateway のクォータ」を参照してください。

リソースまたはオペレーション デフォルトのクォータ 引き上げ可能
1 アカウント、1 リージョンあたりのパブリックカスタムドメイン名数 120 あり
1 アカウント、1 リージョンあたりのプライベートカスタムドメイン名数 50 はい
リージョンあたりのリージョンの API 600 いいえ
リージョンあたりのエッジ最適化 API 120 いいえ
1 アカウント、1 リージョンあたりのプライベート API 600 いいえ
1 アカウントあたりのドメイン名アクセスの関連付け数 100 あり
ドメインごとのマルチレベル API マッピング 200 いいえ
エッジ最適化 API の URLの長さ (文字数) 8192 いいえ
リージョン API の URL の長さ (文字数) 10240 いいえ
API Gateway リソースポリシーの長さ (文字単位) 8192 あり
1 アカウント、1 リージョンあたりの API キー 10000 いいえ
1 アカウント、1 リージョンあたりのクライアント証明書 60 あり
API ごとのオーソライザー (AWS Lambda および Amazon Cognito) 10

[Yes (はい)]

このクォータを引き上げるには、AWS サポートセンターにお問い合わせください。
API あたりのドキュメント部分 2000

はい

このクォータを引き上げるには、AWS サポートセンターにお問い合わせください。
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 ループ内での反復回数 1,000 いいえ
マッピングテンプレートの最大サイズ 300 KB いいえ
メソッドの ARN の長さ 1,600 バイト。メソッドにパスパラメータが含まれており、クライアントが ARN の長さを超える値を使用する場合、API は 414 Request URI too long レスポンスを返します。 いいえ
使用量プランのステージに対するメソッドレベルのスロットリング設定 20

はい

このクォータを引き上げるには、AWS サポートセンターにお問い合わせください。
API あたりのモデルサイズ 400 KB いいえ
トラストストアの証明書数 1,000 件の証明書 (合計オブジェクトサイズは最大 1 MB) いいえ
アイドル接続のタイムアウト 310 秒 いいえ
restapi:import または restapi:put を使用する場合の最大 API 定義ファイルサイズ 6 MB いいえ

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

クォータを削減するためのベストプラクティス

次のベストプラクティスは、クォータの増加を避けるために、現在のリソース数を減らすのに役立ちます。これらの提案が API のアーキテクチャで機能することを確認してください。

リージョンごとの API の数

リージョンあたりの API の数を減らすには、未使用の API をエクスポートし、API Gateway から削除します。詳細については、「API Gateway から REST API をエクスポートする」を参照してください。

API あたりのステージ数

API あたりのステージ数を減らすには、API を複数の API に分割します。

API あたりのリソース数

{proxy+} パスを使用してリソースの数を減らします。詳細については、「プロキシリソースとのプロキシ統合を設定する」を参照してください。

API マッピング

カスタムドメイン名の API マッピングの数を減らすには、/prod などの単一レベルで API マッピングを使用します。単一レベルの API マッピングは、API マッピングのクォータにはカウントされません。

API ごとのオーソライザー数

API あたりのオーソライザーの数を減らすには、API メソッド間でオーソライザーを再使用します。

API あたりのドキュメント部分

API あたりのドキュメントパートの数を減らすには、API をインポートするときに ignore=documentation を使用します。詳細については、「API ドキュメントのインポート」を参照してください。

コンテンツ継承を使用して、一部のドキュメントパーツがより一般的な仕様の API エンティティからコンテンツを継承できるようにすることもできます。詳細については、「API Gateway での API ドキュメントの表現」を参照してください。

API Gateway リソースポリシーの長さ (文字単位)

リソースポリシーの長さを減らすには、AWS WAFV2 を使用して API を保護します。詳細については、「AWS WAF を使用して API Gateway の REST API を保護する」を参照してください。

ポリシーに IP アドレスが含まれている場合は、特定の値の代わりに範囲を使用して IP アドレスを定義することもできます。

API キーあたりの使用量プラン

API キーあたりの使用量プランの数を減らすには、使用量プランごとに 1 つの API キーを使用し、使用量プランを複数の API に関連付けます。1 つの API キーを複数の使用量プランで共有することは推奨しません。