# Amazon API Gateway のクォータ 次のクォータは、すべての Amazon API Gateway API タイプに適用されます。 ## API Gateway アカウントレベルのクォータ (リージョンごと) 以下のクォータは、アカウントごと、Amazon API Gateway のリージョンごとに適用されます。 | リソースまたはオペレーション | デフォルトのクォータ | 引き上げ可能 | | --- | --- | --- | | HTTP API、REST API、WebSocket API、WebSocket コールバック API にわたってリージョンごとに適用されるアカウント単位のスロットリングクォータ | 10,000 リクエスト/秒 (RPS) と、[トークンバケットアルゴリズム](https://en.wikipedia.org/wiki/Token_bucket)で提供される追加のバースト容量 (最大バケット容量は 5,000 リクエスト \$1)。 バーストクォータは、リージョンのアカウントの全体的な RPS クォータに基づいて、API Gateway サービスチームによって決定されます。このクォータは顧客が制御したり変更をリクエストできるものではありません。 | [可](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-8A5B8E43) | | ポータルのリージョンごと、アカウントごとのアクセスコントロールなしのスロットリングクォータ | 1 秒あたり 250,000 個のリクエスト | 不可 | | ポータルのリージョンごと、アカウントごとのアクセスコントロールを使用するスロットリングクォータ | 1 秒あたり 10,000 個のリクエスト | 不可 | \$1 次のリージョンでは、デフォルトのスロットリングクォータは 2500 RPS、デフォルトのバーストクォータは 1250 RPS です: アフリカ (ケープタウン)、欧州 (ミラノ)、アジアパシフィック (ジャカルタ)、中東 (アラブ首長国連邦)、アジアパシフィック (ハイデラバード)、アジアパシフィック (メルボルン)、欧州 (スペイン)、欧州 (チューリッヒ)、イスラエル (テルアビブ)、カナダ西部 (カルガリー)、アジアパシフィック (マレーシア)、アジアパシフィック (タイ)、メキシコ (中部)。 ## API の作成、デプロイ、管理に関する API Gateway クォータ 以下の固定クォータは、AWS CLI、API Gateway コンソール、または API Gateway REST API とその SDK を使用して、API Gateway で API の作成、デプロイ、および管理に適用されます。これらのクォータを増やすことはできません。 | アクション | デフォルトのクォータ | 引き上げ可能 | | --- | --- | --- | | [CreateApiKey](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateApiKey.html) | アカウントあたり 1 秒ごとに 5 リクエスト | いいえ | | [CreateDeployment](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateDeployment.html) | アカウントあたり 5 秒ごとに 1 リクエスト | いいえ | | [CreateDocumentationVersion](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateDocumentationVersion.html) | アカウントあたり 20 秒ごとに 1 リクエスト | いいえ | | [CreateDomainName](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateDomainName.html) | アカウントあたり 30 秒ごとに 1 リクエスト | いいえ | | [CreateResource](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateResource.html) | アカウントあたり 1 秒ごとに 5 リクエスト | 不可 | | リージョン API またはプライベート API の [CreateRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateRestApi.html) | アカウントあたり 3 秒ごとに 1 リクエスト | 不可 | | エッジ最適化 API の [CreateRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateRestApi.html) | アカウントあたり 30 秒ごとに 1 リクエスト | いいえ | | [CreateVpcLink](https://docs.aws.amazon.com/apigatewayv2/latest/api-reference/vpclinks.html#CreateVpcLink) (V2) | アカウントあたり 15 秒ごとに 1 リクエスト | いいえ | | [DeleteApiKey](https://docs.aws.amazon.com/apigateway/latest/api/API_DeleteApiKey.html) | アカウントあたり 1 秒ごとに 5 リクエスト | いいえ | | [DeleteDomainName](https://docs.aws.amazon.com/apigateway/latest/api/API_DeleteDomainName.html) | アカウントあたり 30 秒ごとに 1 リクエスト | いいえ | | [DeleteResource](https://docs.aws.amazon.com/apigateway/latest/api/API_DeleteResource.html) | アカウントあたり 1 秒ごとに 5 リクエスト | いいえ | | [DeleteRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_DeleteRestApi.html) | アカウントあたり 30 秒ごとに 1 リクエスト | いいえ | | [GetResources](https://docs.aws.amazon.com/apigateway/latest/api/API_GetResources.html) | アカウントあたり 2 秒ごとに 5 リクエスト | いいえ | | [DeleteVpcLink](https://docs.aws.amazon.com/apigatewayv2/latest/api-reference/vpclinks.html#DeleteVpcLink) (V2) | アカウントあたり 30 秒ごとに 1 リクエスト | いいえ | | [ImportDocumentationParts](https://docs.aws.amazon.com/apigateway/latest/api/API_ImportDocumentationParts.html) | アカウントあたり 30 秒ごとに 1 リクエスト | 不可 | | リージョン API またはプライベート API の [ImportRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_ImportRestApi.html) | アカウントあたり 3 秒ごとに 1 リクエスト | 不可 | | エッジ最適化 API の [ImportRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_ImportRestApi.html) | アカウントあたり 30 秒ごとに 1 リクエスト | いいえ | | [PutRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_PutRestApi.html) | アカウントあたり 1 秒ごとに 1 リクエスト | いいえ | | [UpdateAccount](https://docs.aws.amazon.com/apigateway/latest/api/API_UpdateAccount.html) | アカウントあたり 20 秒ごとに 1 リクエスト | いいえ | | [UpdateDomainName](https://docs.aws.amazon.com/apigateway/latest/api/API_UpdateDomainName.html) | アカウントあたり 30 秒ごとに 1 リクエスト | いいえ | | [UpdateUsagePlan](https://docs.aws.amazon.com/apigateway/latest/api/API_UpdateUsagePlan.html) | アカウントあたり 20 秒ごとに 1 リクエスト | 不可 | | ポータルの作成 | 3 秒あたり 1 個のリクエスト | 不可 | | ポータルの更新 | 1 分あたり 2 個のリクエスト | 不可 | | ポータルの取得 | 1 秒あたり 10 個のリクエスト | 不可 | | ポータルを一覧表示する | 1 秒あたり 10 個のリクエスト | 不可 | | ポータルの発行 | 1 分あたり 2 個のリクエスト | 不可 | | DeletePortal | 1 分あたり 2 個のリクエスト | 不可 | | PreviewPortal | 3 秒あたり 1 個のリクエスト | 不可 | | DisablePortal | 1 分あたり 2 個のリクエスト | 不可 | | GetPortalProduct | 1 秒あたり 10 個のリクエスト | 不可 | | ListPortalProduct | 1 秒あたり 5 個のリクエスト | 不可 | | CreatePortalProduct | 1 秒あたり 2 個のリクエスト | 不可 | | UpdatePortalProduct | 1 秒あたり 0.5 個のリクエスト | 不可 | | DeletePortalProduct | 1 秒あたり 1 個のリクエスト | 不可 | | PutPortalProductSharingPolicy | 3 秒あたり 1 個のリクエスト | 不可 | | GetPortalProductSharingPolicy | 1 秒あたり 10 個のリクエスト | 不可 | | DeletePortalProductSharingPolicy | 3 秒あたり 1 個のリクエスト | 不可 | | CreateProductRestEndpointPage | 3 秒あたり 1 個のリクエスト | 不可 | | GetProductRestEndpointPage | 1 秒あたり 10 個のリクエスト | 不可 | | UpdateProductRestEndpointPage | 3 秒あたり 1 個のリクエスト | 不可 | | DeleteProductRestEndpointPage | 3 秒あたり 1 個のリクエスト | 不可 | | ListProductRestEndpointPages | 1 秒あたり 10 個のリクエスト | 不可 | | CreateProductPage | 3 秒あたり 1 個のリクエスト | 不可 | | GetProductPage | 1 秒あたり 10 個のリクエスト | 不可 | | UpdateProductPage | 3 秒あたり 1 個のリクエスト | 不可 | | DeleteProductPage | 3 秒あたり 1 個のリクエスト | 不可 | | ListProductPages | 1 秒あたり 10 個のリクエスト | 不可 | | その他のオペレーション | 合計アカウントクォータまでのクォータはありません。 | いいえ | | 合計オペレーション数 | 1 秒あたり 10 リクエストで、バーストクォータは 1 秒あたり 40 リクエスト。 | いいえ | # API Gateway での REST API の設定および実行に関するクォータ Amazon API Gateway での REST API の設定と実行には、次のクォータが適用されます。クォータが API 別の場合、アカウント内のすべての API ではなく、特定の API でのみクォータを増やすことができます。 アカウントレベルのクォータの詳細については、「[Amazon API Gateway のクォータ](limits.md)」を参照してください。 | リソースまたはオペレーション | デフォルトのクォータ | 引き上げ可能 | | --- | --- | --- | | 1 アカウント、1 リージョンあたりのパブリックカスタムドメイン名数 | 120 | [はい](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-A93447B8) | | 1 アカウント、1 リージョンあたりのプライベートカスタムドメイン名数 | 50 | [はい](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-24E7E662) | | リージョンあたりのリージョンの API | 600 | 不可 | | リージョンあたりのエッジ最適化 API | 120 | 不可 | | 1 アカウント、1 リージョンあたりのプライベート API | 600 | 不可 | | 1 アカウントあたりのドメイン名アクセスの関連付け数 | 100 | [はい](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-4D98A8A5) | | ドメインごとのマルチレベル API マッピング | 200 | 不可 | | ドメインごとのルーティングルール | 50 | [はい](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-68B79FF0) | | エッジ最適化 API の URLの長さ (文字数) | 8192 | いいえ | | リージョン API の URL の長さ (文字数) | 10240 | 不可 | | プライベート API の URL の長さ (文字数) | 8192 | 不可 | | API Gateway リソースポリシーの長さ (文字単位) | 8192 | [はい](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-8B81B02C) | | 1 アカウント、1 リージョンあたりの API キー | 10000 | 不可 | | 1 アカウント、1 リージョンあたりのクライアント証明書 | 60 | [はい](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-824C9E42) | | API ごとのオーソライザー (AWS Lambda および Amazon Cognito) | 10 | [Yes (はい)] このクォータを引き上げるには、[AWS サポートセンター](https://console.aws.amazon.com/support/home#/)にお問い合わせください。 | | API あたりのドキュメント部分 | 2000 | はい このクォータを引き上げるには、[AWS サポートセンター](https://console.aws.amazon.com/support/home#/)にお問い合わせください。 | | API あたりのリソース数 | 300 | [はい](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-01C8A9E0) | | API あたりのステージ数 | 10 | [Yes (はい](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-379E48B0) | | ステージごとのステージ変数 | 100 | いいえ | | ステージ変数内のキー長さ (文字数) | 64 | いいえ | | ステージ変数内の値の長さ (文字数) | 512 | いいえ | | 1 アカウント、1 リージョンあたりの使用量プラン | 300 | [はい](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-E8693075) | | API キーあたりの使用量プラン | 10 | [Yes (はい](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-985EB478) | | 1 アカウント、1 リージョンあたりの VPC リンク | 20 | [はい](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-A4C7274F) | | API キャッシュの TTL | デフォルトで 300 秒、API 所有者が 0～3600 の範囲で設定可能。 | 上限あり (3600) | | キャッシュされたレスポンスサイズ | 1048576 バイト。キャッシュデータの暗号化により、キャッシュされるアイテムのサイズが増える可能性があります。 | 不可 | | リージョン API の統合のタイムアウト | Lambda、Lambda プロキシ、HTTP、HTTP プロキシ、AWS 統合など、すべての統合タイプで 50 ミリ秒〜29 秒。 | [はい \$1](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-E5AE38E3) | | エッジ最適化 API の統合のタイムアウト | Lambda、Lambda プロキシ、HTTP、HTTP プロキシ、AWS 統合など、すべての統合タイプで 50 ミリ秒〜29 秒。 | 不可 | | プライベート API の統合のタイムアウト | Lambda、Lambda プロキシ、HTTP、HTTP プロキシ、AWS 統合など、すべての統合タイプで 50 ミリ秒〜29 秒。 | [はい\$1](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-E5AE38E3) | | ヘッダー名、値、行末記号、空白を含むすべてのヘッダー値の合計サイズ | 10,240 バイト | 不可 | | プライベート API のすべてのヘッダー値の合計サイズ | 8000 バイト | 不可 | | ペイロードサイズ | 10 MB | いいえ | | ステージごとのタグ | 50 | いいえ | | マッピングテンプレートでの \$1foreach ... \$1end ループ内での反復回数 | 1,000 | 不可 | | マッピングテンプレートの最大サイズ | 300 KB | 不可 | | アクセスログテンプレートのサイズ | 3 KB | 不可 | | メソッドの ARN の長さ | 1,600 バイト。メソッドにパスパラメータが含まれており、クライアントが ARN の長さを超える値を使用する場合、API は 414 Request URI too long レスポンスを返します。 | 不可 | | 使用量プランのステージに対するメソッドレベルのスロットリング設定 | 20 | はい このクォータを引き上げるには、[AWS サポートセンター](https://console.aws.amazon.com/support/home#/)にお問い合わせください。 | | API あたりのモデルサイズ | 400 KB | 不可 | | トラストストアの証明書数 | 1,000 件の証明書 (合計オブジェクトサイズは最大 1 MB) | 不可 | | アイドル接続のタイムアウト | 310 秒 | 不可 | | [restapi:import](https://docs.aws.amazon.com/apigateway/latest/api/API_ImportRestApi.html) または [restapi:put](https://docs.aws.amazon.com/apigateway/latest/api/API_PutRestApi.html) を使用する場合の最大 API 定義ファイルサイズ | 6 MB | 不可 | \$1 統合タイムアウトを 50 ミリ秒未満に設定することはできません。統合のタイムアウトは 29 秒超に設定できますが、これに伴ってアカウントにおけるリージョンレベルのスロットリングクォータの緩和が必要になる場合があります。 ## クォータを削減するためのベストプラクティス 次のベストプラクティスは、クォータの増加を避けるために、現在のリソース数を減らすのに役立ちます。これらの提案が API のアーキテクチャで機能することを確認してください。 **リージョンごとの API の数** リージョンあたりの API の数を減らすには、未使用の API をエクスポートし、API Gateway から削除します。詳細については、「[API Gateway から REST API をエクスポートする](api-gateway-export-api.md)」を参照してください。 **API あたりのステージ数** API あたりのステージ数を減らすには、API を複数の API に分割します。 **API あたりのリソース数** `{proxy+}` パスを使用してリソースの数を減らします。詳細については、「[プロキシリソースとのプロキシ統合を設定する](api-gateway-set-up-simple-proxy.md)」を参照してください。 **API マッピング** カスタムドメイン名の API マッピングの数を減らすには、`/prod` などの単一レベルで API マッピングを使用します。単一レベルの API マッピングは、API マッピングのクォータにはカウントされません。 **API ごとのオーソライザー数** API あたりのオーソライザーの数を減らすには、API メソッド間でオーソライザーを再使用します。 **API あたりのドキュメント部分** API あたりのドキュメントパートの数を減らすには、API をインポートするときに `ignore=documentation` を使用します。詳細については、「[API ドキュメントのインポート](api-gateway-documenting-api-quick-start-import-export.md)」を参照してください。 コンテンツ継承を使用して、一部のドキュメントパーツがより一般的な仕様の API エンティティからコンテンツを継承できるようにすることもできます。詳細については、「[API Gateway での API ドキュメントの表現](api-gateway-documenting-api-content-representation.md)」を参照してください。 **API Gateway リソースポリシーの長さ (文字単位)** リソースポリシーの長さを減らすには、AWS WAFV2 を使用して API を保護します。詳細については、「[AWS WAF を使用して API Gateway の REST API を保護する](apigateway-control-access-aws-waf.md)」を参照してください。 ポリシーに IP アドレスが含まれている場合は、特定の値の代わりに範囲を使用して IP アドレスを定義することもできます。 **API キーあたりの使用量プラン** API キーあたりの使用量プランの数を減らすには、使用量プランごとに 1 つの API キーを使用し、使用量プランを複数の API に関連付けます。1 つの API キーを複数の使用量プランで共有することは推奨しません。 # API Gateway での HTTP API の設定および実行に関するクォータ 次のクォータは、Amazon API Gateway での HTTP API の設定と実行に適用されます。クォータが API 別の場合、アカウント内のすべての API ではなく、特定の API でのみクォータを増やすことができます。アカウントレベルのクォータの詳細については、「[Amazon API Gateway のクォータ](limits.md)」を参照してください。 | リソースまたはオペレーション | デフォルトのクォータ | 引き上げ可能 | | --- | --- | --- | | API あたりのルート数 | 300 | [あり](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-01C8A9E0) | | API あたりの統合の数 | 300 | いいえ | | 最大統合タイムアウト | 30 秒 | いいえ | | API あたりのステージ数 | 10 | [Yes (はい](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-379E48B0) | | ドメインごとのマルチレベル API マッピング | 200 個の API マッピング。この制限には、/prod などの単一レベルの API マッピングは含まれません。 | 不可 | | ステージごとのタグ | 50 | いいえ | | リクエスト行とヘッダー値の合計サイズ | 10240 バイト | いいえ | | ペイロードサイズ | 10 MB | いいえ | | 1 アカウント、1 リージョンあたりのカスタムドメイン | 120 | [あり](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-A93447B8) | | アクセスログテンプレートのサイズ | 3 KB | いいえ | | Amazon CloudWatch Logs のログエントリ | 1 MB | いいえ | | API ごとのオーソライザー数 | 10 | [Yes (はい)] このクォータを引き上げるには、[AWS サポートセンター](https://console.aws.amazon.com/support/home#/)にお問い合わせください。 | | オーソライザーあたりの対象者数 | 50 | いいえ | | ルートあたりのスコープ数 | 10 | いいえ | | JSON ウェブキーセットエンドポイントのタイムアウト | 1500 ms | いいえ | | JSON Web Key Set エンドポイントからのレスポンスサイズ | 150,000 バイト | いいえ | | OpenID Connect 検出エンドポイントのタイムアウト | 1500 ms | 不可 | | Lambda オーソライザーレスポンスのタイムアウト | 10000 ミリ秒 | 不可 | | 1 アカウント、1 リージョンあたりの VPC リンク | 10 | [Yes (はい](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-608BDCD4) | | VPC リンクあたりのサブネットの数 | 10 | [Yes (はい](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-668C9B28) | | ステージごとのステージ変数 | 100 | いいえ | | ステージ変数内のキー長さ (文字数) | 64 | いいえ | | ステージ変数内の値の長さ (文字数) | 512 | 不可 | ## クォータを削減するためのベストプラクティス 次のベストプラクティスは、クォータの増加を避けるために、現在のリソース数を減らすのに役立ちます。これらの提案が API のアーキテクチャで機能することを確認してください。 **リージョンごとの API の数** リージョンあたりの API の数を減らすには、未使用の API をエクスポートし、API Gateway から削除します。詳細については、「[API Gateway から HTTP API をエクスポートする](http-api-export.md)」を参照してください。 **API あたりのステージ数** API あたりのステージ数を減らすには、API を複数の API に分割します。 **API ごとのオーソライザー数** API あたりのオーソライザーの数を減らすには、API メソッド間でオーソライザーを再使用します。 # API Gateway でポータルを設定するためのクォータ API Gateway でのポータルの作成には、次のクォータが適用されます。詳細については、「[API Gateway ポータル](apigateway-portals.md)」を参照してください。 | リソースまたはオペレーション | デフォルトのクォータ | 引き上げ可能 | | --- | --- | --- | | アカウントあたりのポータル | 15 | 可 | | ポータルあたりのポータル製品 | 200 | 可 | | アカウントあたりのポータル製品 | 2000 | 可 | | ポータル製品あたりの製品 REST エンドポイントページ | 40 | 可 | | ポータル製品あたりの製品ページ | 40 | 可 | | ロゴサイズ | 200 KB | 不可 | | 製品 REST エンドポイントページあたりのドキュメントページサイズ | 32,000 文字 | 不可 | | 製品ページのカスタムページサイズ | 32,000 文字 | 不可 | | ポータルあたりのカスタムドメイン名 | 1 | 不可 | | ポータルあたりのオーソライザー | 1 | いいえ | # API Gateway での WebSocket API の設定と実行に関するクォータ Amazon API Gateway での WebSocket API の設定と実行には、次のクォータが適用されます。クォータが API 別の場合、アカウント内のすべての API ではなく、特定の API でのみクォータを増やすことができます。アカウントレベルのクォータの詳細については、「[Amazon API Gateway のクォータ](limits.md)」を参照してください。 | リソースまたはオペレーション | デフォルトのクォータ | 引き上げ可能 | | --- | --- | --- | | 1 秒あたり、1 アカウント (すべての WebSocket API 間) あたり、1 リージョンあたりの新しい接続数 | 500 | [あり](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-9ED1E49A) | | 同時接続 | 対象外 | 該当しません | | API ごとの AWS Lambda オーソライザー | 10 | [Yes (はい)] このクォータを引き上げるには、[AWS サポートセンター](https://console.aws.amazon.com/support/home#/)にお問い合わせください。 | | AWS Lambda オーソライザー結果サイズ | 8 KB | いいえ | | API あたりのルート数 | 300 | [あり](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-01C8A9E0) | | API あたりの統合の数 | 300 | はい このクォータを引き上げるには、[AWS サポートセンター](https://console.aws.amazon.com/support/home#/)にお問い合わせください。 | | 統合のタイムアウト | Lambda、Lambda プロキシ、HTTP、HTTP プロキシ、AWS 統合など、すべての統合タイプで 50 ミリ秒〜29 秒。 | いいえ | | API あたりのステージ数 | 10 | [あり](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-379E48B0) | | WebSocket のフレームサイズ | 32 KB | いいえ | | メッセージのペイロードサイズ | 128 KB \$1\$1 | いいえ | | マッピングテンプレートの最大サイズ | 300 KB | いいえ | | WebSocket API の接続時間 | 2 時間 | いいえ | | アイドル接続のタイムアウト | 10 分 | いいえ | | WebSocket API の URL の長さ (文字数) | 4096 | いいえ | | アクセスログテンプレートのサイズ | 3 KB | いいえ | \$1 API Gateway は、同時接続にクォータを適用しません。同時接続の最大数は、1 秒あたりの新規接続数と 2 時間の最大接続時間によって決まります。たとえば、デフォルトのクォータが 500 新規接続/秒の場合、クライアントが 2 時間を超える最大速度で接続する場合、API Gateway は最大 3,600,000 の同時接続を提供することができます。 \$1\$1 WebSocket フレームサイズには 32 KB のクォータがあるため、32 KB を超えるメッセージはそれぞれが 32 KB 以下の複数のフレームに分割する必要があります。これは `@connections` のコマンドにも該当します。それより大きなメッセージ (または大きなフレームサイズ) が受信された場合、接続は 1009 コードで閉じられます。 # Amazon API Gateway に関する重要な注意点 次のセクションでは、API Gateway の使用に影響する可能性がある注意点について詳しく説明します。 **Topics** + [Amazon API Gateway の HTTP API に関する重要な注意点](#api-gateway-known-issues-http-apis) + [Amazon API Gateway の HTTP および WebSocket API に関する重要な注意点](#api-gateway-known-issues-http-and-websocket-apis) + [Amazon API Gateway の REST および WebSocket API に関する重要な注意点](#api-gateway-known-issues-rest-and-websocket-apis) + [Amazon API Gateway の WebSocket API に関する重要な注意点](#api-gateway-known-issues-websocket-apis) + [Amazon API Gateway の REST API に関する重要な注意点](#api-gateway-known-issues-rest-apis) ## Amazon API Gateway の HTTP API に関する重要な注意点 + HTTP API は受信 `X-Forwarded-*` ヘッダーを標準 `Forwarded` ヘッダーに変換し、出力 IP、ホスト、プロトコルを追加します。 + ペイロードがなく、Content-Length が 0 の場合、API Gateway は Content-type ヘッダーをリクエストに追加します。 ## Amazon API Gateway の HTTP および WebSocket API に関する重要な注意点 + 署名バージョン 4A は、Amazon API Gateway で HTTP および WebSocket API 向けに正式にはサポートされていません。 ## Amazon API Gateway の REST および WebSocket API に関する重要な注意点 + API Gateway では、REST と WebSocket API 間でのカスタムドメイン名の共有はサポートされていません。 + ステージ名には、英数字、ハイフン、およびアンダースコアのみ含めることができます。最大長は 128 文字です。 + `/ping` および `/sping` のパスは、サービスのヘルスチェック専用です。カスタムドメインを使用した API ルートレベルでの使用は良い結果を生みません。 + API Gateway は現在、ログイベントを 1024 バイトに制限しています。リクエストやレスポンスの本文など、1024 バイトを超えるログイベントは、CloudWatch Logs への送信前に API Gateway によって切り捨てられます。 + 現在、CloudWatch メトリクスではディメンション名と値が 255 文字の有効な XML 文字に制限されています (詳細については、[CloudWatch ユーザーガイド](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension)を参照してください)。ディメンション値は、API 名、ラベル (ステージ) 名、およびリソース名を含む、ユーザーが定義した名前の関数です。これらの名前を選択するときは、CloudWatch メトリクスの制限を超えないように注意してください。 + マッピングテンプレートの最大サイズは 300 KB です。 ## Amazon API Gateway の WebSocket API に関する重要な注意点 + API Gateway は最大 128 KB までのメッセージペイロードをサポートし、最大フレームサイズは 32 KB です。メッセージが 32 KB を超えた場合は、それぞれが 32 KB 以下の複数のフレームに分割する必要があります。大きなメッセージが受信された場合、接続は 1009 コードで閉じられます。 ## Amazon API Gateway の REST API に関する重要な注意点 + プレーンテキストのパイプ文字 (`|`) と中かっこ文字 (`{` または `}`) は、リクエスト URL クエリ文字列ではサポートされておらず、URL エンコードする必要があります。 + セミコロン文字 (`;`) はリクエスト URL クエリ文字列に対してサポートされておらず、この結果、データが分割されます。 + REST API は、URL エンコードされたリクエストパラメータをデコードしてからバックエンド統合に渡します。UTF-8 リクエストパラメータの場合、REST API は、パラメータをデコードしてから、バックエンド統合にユニコードとして渡します。REST API は、パーセント文字 (`%`) を URL エンコードしてからバックエンド統合に渡します。 + API Gateway コンソールを使用して API をテストするとき、バックエンドに自己署名証明書が存在する、中間証明書が証明書チェーンにない、または他の認識されない証明書関連の例外がバックエンドからスローされた場合に「不明なエンドポイントのエラー」レスポンスが返されることがあります。 + プライベート統合の API [https://docs.aws.amazon.com/apigateway/latest/api/API_Resource.html](https://docs.aws.amazon.com/apigateway/latest/api/API_Resource.html) または [https://docs.aws.amazon.com/apigateway/latest/api/API_Method.html](https://docs.aws.amazon.com/apigateway/latest/api/API_Method.html) エンティティの場合は、[https://docs.aws.amazon.com/apigateway/latest/api/API_VpcLink.html](https://docs.aws.amazon.com/apigateway/latest/api/API_VpcLink.html) のハードコーディングされたリファレンスを削除した後で、それを削除する必要があります。それ以外の場合は、ダングリング統合があり、`Resource` または `Method` エンティティが削除されても VPC リンクがまだ使用中であることを示すエラーが表示されます。プライベート統合がステージ変数を通じて `VpcLink` を参照する場合、この動作は適用されません。 + 以下のバックエンドでは、API Gateway と互換性のある方法では SSL クライアント認証がサポートされない場合があります。 + [NGINX](https://nginx.org/en/) + [Heroku](https://www.heroku.com/) + API Gateway は、ほとんどの [OpenAPI 2.0 仕様](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/2.0.md)と [OpenAPI 3.0 仕様](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.1.md)をサポートしますが、次の例外があります。 + パスセグメントには、英数字、アンダースコア、ハイフン、ピリオド、カンマ、コロン、中括弧のみを含めることができます。パスパラメータは、別のパスセグメントである必要があります。たとえば、「resource/\$1path\$1parameter\$1name\$1」は有効です。「resource\$1path\$1parameter\$1name\$1」は無効です。 + モデル名は、英数字のみ含めることができます。 + 入力パラメータについては、次の属性のみがサポートされています。`name`、`in`、`required`、`type`、`description`。他の属性は無視されます。 + `securitySchemes` タイプを使用する場合は、`apiKey` にする必要があります。ただし、OAuth 2 および HTTP Basic 認証は [Lambda オーソライザー](apigateway-use-lambda-authorizer.md)によってサポートされています。OpenAPI 設定は、[ベンダー拡張機能](api-gateway-swagger-extensions-authorizer.md)によって実現されます。 + この `deprecated` フィールドはサポートされておらず、エクスポートされた API では削除されます。 + API Gateway モデルは、OpenAPI が使用する JSON スキーマではなく、[JSON スキーマのドラフト 4](https://datatracker.ietf.org/doc/html/draft-zyp-json-schema-04) を使用して定義されます。 + `discriminator`パラメータは、どのスキーマオブジェクトでもサポートされません。 + `example` タグはサポートされません。 + `nullable` フィールドはサポートされません。 + `exclusiveMinimum` は API Gateway ではサポートされていません。 + [単純なリクエストの検証](api-gateway-method-request-validation.md)には `maxItems` タグと `minItems` タグは含まれません。この問題を回避するには、インポートした後で、検証を行う前にモデルを更新します。 + OpenAPI 3.0 では、同じスキーマ内の定義に `$ref` を使用する `oneOf`、`anyOf`、または `allOf` を持つことはできません。スキーマを直接入力するか、別の API Gateway モデルリソースを定義できます。詳細については、「[より複雑なモデルの作成](models-mappings-models.md#api-gateway-request-validation-model-more-complex)」を参照してください。 + `oneOf` は、OpenAPI 2.0 または SDK の生成ではサポートされていません。 + `readOnly` フィールドはサポートされません。 + `$ref` を使用して他のファイルを参照することはできません。 + `"500": {"$ref": "#/responses/UnexpectedError"}` フォームのレスポンス定義は、OpenAPI ドキュメントルートではサポートされません。回避策として、参照をインラインスキーマに置き換えます。 + `Int32` タイプまたは `Int64` タイプの数値はサポートされていません。例を以下に示します。 ``` "elementId": { "description": "Working Element Id", "format": "int32", "type": "number" } ``` + 10 進数型 (`"format": "decimal"`) は、スキーマ定義でサポートされません。 + メソッドレスポンスでは、スキーマ定義をオブジェクト型にする必要があり、プリミティブ型にすることはできません。たとえば、`"schema": { "type": "string"}` はサポートされません。ただし、回避策として次のオブジェクト型を使用できます。 ``` "schema": { "$ref": "#/definitions/StringResponse" } "definitions": { "StringResponse": { "type": "string" } } ``` + API Gateway は、OpenAPI 仕様に定義されているルートレベルのセキュリティを使用しません。したがって、オペレーションレベルでセキュリティを定義して、セキュリティが適切に適用されるようにする必要があります。 + `default` のキーワードはサポートされていません。 + API Gateway は、Lambda 統合または HTTP 統合を使用した処理方法に以下の制約と制限を設定しています。 + ヘッダー名とクエリパラメータは大文字と小文字を区別する方法で処理されます。 + 以下の表には、統合エンドポイントに送信されたり、統合エンドポイントから戻ったりしたときに、ドロップされたり、再マップされたり、それ以外の場合は変更されることがあるヘッダーがリストされています。この表で以下の点に注意してください。 + `Remapped` は、ヘッダー名が `` から `X-Amzn-Remapped-` に変更されたことを意味します。 `Remapped Overwritten` は、ヘッダー名が `` から `X-Amzn-Remapped-` に変更され、値が上書きされたことを意味します。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/apigateway/latest/developerguide/api-gateway-known-issues.html) \$1 [Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) の署名が含まれているか、`AWS_IAM` 認可が使用されている場合、`Authorization` ヘッダーは削除されます。 + API Gateway で生成された API の Android SDK では、`java.net.HttpURLConnection` クラスを使用します。このクラスは、Android 4.4 以前を実行するデバイスでは、`WWW-Authenticate` ヘッダーから `X-Amzn-Remapped-WWW-Authenticate` への再マッピングに伴う 401 レスポンスに対して、処理されない例外をスローします。 + API Gateway で生成された Java や、API の Android および iOS SDK とは異なり、API Gateway で生成された API の JavaScript SDK では、500 レベルのエラーの再試行はサポートされていません。 + メソッドのテスト呼び出しでは、`application/json` のデフォルトコンテンツタイプを使用し、その他のコンテンツタイプの使用は無視されます。 + `X-HTTP-Method-Override` ヘッダーを渡して API にリクエストを送信すると、API Gateway によってメソッドがオーバーライドされます。したがって、ヘッダーをバックエンドに渡すには、ヘッダーを統合リクエストに追加する必要があります。 + リクエストの `Accept` ヘッダーに複数のメディアタイプが含まれている場合、API Gateway は最初の `Accept` メディアタイプのみ受け入れます。`Accept` メディタイプの順序を制御できず、バイナリコンテンツのメディアタイプがリストの先頭にない場合、API の `Accept` リストに最初の `binaryMediaTypes` メディアタイプを追加できます。 API Gateway によりコンテンツがバイナリとして返されます。たとえば、ブラウザで `` 要素を使用して JPEG ファイルを送信するため、ブラウザがリクエストで `Accept:image/webp,image/*,*/*;q=0.8` を送信することがあります。`image/webp` を `binaryMediaTypes` リストに追加することで、エンドポイントは JPEG ファイルをバイナリとして受け取るようになります。 + 現在、`413 REQUEST_TOO_LARGE` のデフォルトゲートウェイレスポンスのカスタマイズはサポートされていません。 + API Gateway には、すべての統合レスポンスの `Content-Type` ヘッダーが含まれています。デフォルトでは、コンテンツタイプは `application/json` です。