AWS Systems Manager Parameter Store を使用しているときに「レート超過」と表示される「ThrottlingException」エラーメッセージをトラブルシューティングしたいです。
簡単な説明
Parameter Store API 呼び出しは、アカウントおよび AWS リージョンごとに許可されている API リクエストレートの上限を超えることはできません。この制限には、AWS コマンドラインインターフェイス (AWS CLI) と AWS マネジメントコンソール、この両方からの API 呼び出しも含まれます。API リクエストが最大レートを超えると、「レート超過」エラーが表示され、それ以降の API コールは制限されます。次のいずれかに似たエラーが表示される場合があります。
- GetParameters オペレーションを呼び出すときにエラー (スロットリング例外) が発生しました (最大リトライ回数: 4に達しました)。 レートを超過しました
- GetParameter オペレーションを呼び出すときにエラー (スロットリング例外) が発生しました (最大リトライ回数: 4に達しました)。 レートを超過しました
- GetParameters ByPath オペレーションを呼び出すときにエラー (スロットリング例外) が発生しました (最大リトライ回数: 4に達しました)。 レートを超過しました
- DescribeParameters オペレーションを呼び出すときにエラー (スロットリング例外) が発生しました (最大リトライ回数: 2に達しました) レートを超過しました
Parameter Store のリクエストは、サービスのパフォーマンスを向上させるために、リージョン別に Amazon Web Services (AWS) アカウントごとに調整されます。パラメータストア API の最大スループットクォータの詳細については、「AWS Systems Manager エンドポイントとクォータ」を参照してください。
解決方法
トラブルシューティング
「ThrottlingException」エラーまたは「レート超過」エラーを防止または軽減するには、次のトラブルシューティング手順を試してください。
サービスクォータの増加をリクエストする
上記のトラブルシューティング手順をすべて試しても「レート超過」エラーが表示される場合は、サービスクォータの引き上げをリクエストすることができます。
注: リクエストを送信する前に、API 呼び出しと呼び出しレートを確認してください。
Parameter Store のサービスクォータの引き上げをリクエストするには、次の手順に従ってください。
- AWS サポートセンターを開き、[ケースの作成] を選択します。
- 「サービス制限の引き上げを検討していますか?」を選択してください。
- 「制限タイプ」には、「EC2 Systems Manager」を選択します。
- 「リージョン」には、「リクエスト」で AWS リージョンを選択します。
- 「リソースタイプ」で、「Parameter Store」を選択します。
- 増やしたい制限を選択し、新しい制限値を入力します。
- 「ユースケースの説明」テキストボックスに、スロットリングの問題に関連する時間枠とクォータ増加リクエストを出す理由を記入してください。
- 希望する連絡先オプションを選択し、[送信] を選択します。
関連情報
エクスポネンシャルバックオフとジッター
Parameter Store のトラブルシューティング