AWS Systems Manager Parameter Store を使用するときに発生する「ThrottlingException」または「速度を超過しました」エラーを防ぐにはどうすればよいですか?

簡単な説明

Parameter Store API 呼び出しは、アカウントごとおよびリージョンごとに許可される最大 API リクエストレートを超えることはできません。これには、AWS コマンドラインインターフェイス (AWS CLI) および AWS マネジメントコンソールの両方からの API 呼び出しが含まれます。API リクエストが最大レートを超えると、「速度を超過しました」といったエラーが表示され、API 呼び出しがスロットリングされます。

Parameter Store リクエストは、各リージョンのアマゾン ウェブ サービス (AWS) アカウントごとに調整され、サービスのパフォーマンスを高めます。Parameter Store 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、または AWS Tools for Windows PowerShell を使用して、スループットを向上させることができます。AWS CLI コマンドの実行時にエラーが発生した場合は、AWS CLI の最新バージョンを使用していることを確認してください。

サービスクォータの緩和をリクエストする

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

注: リクエストを送信する前に、API 呼び出しと呼び出しレートを特定します。

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

1. AWS サポートセンターを開いて、[Create case (ケースを作成する)] を選択します。
2. [Service limit increase (サービス制限の引き上げ)] を選択します。
3. [Limit type (制限タイプ)] で、[EC2 Systems Manager (EC2 システムマネージャー)] を選択します。
4. **Region (リージョン)**にはお使いの AWS リージョンを選択します。
5. [Resource Type (リソースタイプ)] で、[Parameter Store (パラメータストア)] を選択します。
6. 増やしたい [Limit (制限)] を選択し、新しい制限値を入力します。
7. [Use case description (ユースケースの説明)] テキストボックスに、スロットリング問題に関連する時間枠とクォータの引き上げをリクエストする理由を含めます。
8. ご希望の連絡先オプションを選択して、[Submit (送信)] をクリックします。

---

関連情報

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

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