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 呼び出しの頻度を減らしてください。
• API 呼び出しの間隔をずらして、すべてが同時に実行されないようにします。
• 複数の値を返す API を使用してください。たとえば、GetParameters と GetParametersByPath では、1 回の API 呼び出しで 10 個のパラメーターを取得できます。
• API 呼び出しを行うときに、エラー再試行とエクスポネンシャルバックオフを実装します。
• Parameter Storeのスループットを向上させます。
  重要: スループットを増やすと、AWS アカウントに課金されます。詳細については、AWS Systems Manager の料金を参照してください。
  注: AWS Systems Manager コンソール、AWS CLI、または Windows PowerShell 用 AWS ツールを使用してスループットを向上させることができます。AWS CLI コマンドの実行中にエラーが発生した場合は、AWS CLI の最新バージョンを使用しているかを確認してください。

サービスクォータの増加をリクエストする

上記のトラブルシューティング手順をすべて試しても「レート超過」エラーが表示される場合は、サービスクォータの引き上げをリクエストすることができます。

注: リクエストを送信する前に、API 呼び出しと呼び出しレートを確認してください。

Parameter Store のサービスクォータの引き上げをリクエストするには、次の手順に従ってください。

1. AWS サポートセンターを開き、[ケースの作成] を選択します。
2. 「サービス制限の引き上げを検討していますか?」を選択してください。
3. 「制限タイプ」には、「EC2 Systems Manager」を選択します。
4. 「リージョン」には、「リクエスト」で AWS リージョンを選択します。
5. 「リソースタイプ」で、「Parameter Store」を選択します。
6. 増やしたい制限を選択し、新しい制限値を入力します。
7. 「ユースケースの説明」テキストボックスに、スロットリングの問題に関連する時間枠とクォータ増加リクエストを出す理由を記入してください。
8. 希望する連絡先オプションを選択し、[送信] を選択します。

関連情報

エクスポネンシャルバックオフとジッター

Parameter Store のトラブルシューティング