API Gateway のスロットリングクォータを引き上げて管理する方法を教えてください。

概要

API Gateway には、AWS リージョンごとにアカウントレベルのクォータがあります。スロットリングクォータは 10,000 リクエスト/秒 (RPS) で、トークンバケットアルゴリズムによって追加のバースト容量が提供されます。バケットの最大容量は、リージョンごとに AWS アカウント内の 5,000 リクエストです。

詳細については、「API Gateway のスループットを向上させるために REST API へのリクエストをスロットリングする」を参照してください。

解決策

API Gateway のスロットリングクォータを管理するには、アカウントレベルのスロットリングクォータ増加リクエストをリクエストできます。キャッシュを有効にしたり、使用プランと API キーを設定したり、再試行モードを使用したりすることもできます。

注: クォータのスロットリング制限を超えると、"429 Too Many Requests" または "Limited Exceeded" というエラー応答が発生します。この問題を解決するには、「API Gateway での "429 Too Many Requests" または "Limited Exceeded" エラーを解決する方法を教えてください」を参照してください。

アカウントレベルのスロットリングクォータ増加リクエストを送信する

次の手順を実行します。

1. Service Quotas コンソールを開きます。
2. ナビゲーションペインで [AWS のサービス] を選択します。
3. [AWS のサービス] の検索バーに Amazon API Gateway と入力します。
4. [Service Quotas] 検索バーに Throttle rate と入力します。
5. [アカウントレベルでの引き上げをリクエスト] を選択します。
6. [クォータ値を引き上げる] に、10,000 を超える値を入力します。
7. [リクエスト] を選択します。
   注: [最近のクォータ増加リクエスト] セクションには、ステータスが Pending と表示されます。
8. 数分待ってから、ページを更新します。

クォータ増加リクエストが最大クォータ以内である場合、ステータスは承認済みに変更されます。新しいクォータを確認するには、[適用されたアカウントレベルのクォータ値] フィールドを参照します。クォータ増加リクエストが最大クォータを上回る場合、ステータスは [オープンしたケース] に変更されます。そのケースは、AWS サポートセンターで確認できます。

注: スロットルバーストレートクォータは調整できず、クォータの引き上げをリクエストすることもできません。詳細については、「Amazon API Gateway のクォータ」を参照してください。

API Gateway のキャッシュを有効にする

API キャッシュを有効にすると、エンドポイントに対して行われる API 呼び出しの数を減らし、スロットリングを防ぐことができます。詳細については、「レート制限に達しないように最適な Amazon API Gateway キャッシュ容量を選択する方法を教えてください」を参照してください。

REST API 利用プランと API キーを設定する

定義したスロットリング制限とクォータ制限に基づいて API リクエストを制限する使用プランと API キーを設定できます。使用量プランでは、REST API 用に設定した API キーを使用して、API ステージにアクセスできるユーザーを制御します。

REST API 使用プランを設定するには、まず API ゲートウェイで REST API の API キーを設定します。次に、API ゲートウェイで REST API の使用プランを設定します。

API キーに関連する使用状況を取得するには、「API Gateway の API キーに関連する使用状況を確認する方法を教えてください」を参照してください。

詳細については、「API Gateway での REST API の使用量プランと API キー」を参照してください。

標準リトライモードを使用する

スロットリングクォータを超えた場合は、ジッター付きエクスポネンシャルバックオフの標準リトライモードを使用してから、API リクエストを再送信できます。エクスポネンシャルバックオフにより、API Gateway が API 呼び出しを制限するときの待ち時間が長くなります。詳細については、「リトライ動作」および「エクスポネンシャルバックオフとジッター」を参照してください。