Parameter Store を使用するときに「レート超過」という表示を含む「ThrottlingException」エラーを防ぐ方法を教えてください。

簡単な説明

Parameter Store API コールは、AWS アカウントおよび AWS リージョンごとに許可されている API リクエストレートの上限を超えて実行することはできません。この制限には、AWS コマンドラインインターフェイス (AWS CLI) および AWS マネジメントコンソールからの API コールも含まれます。

API リクエストが最大レートを超えると、次の例のいずれかに類似したエラーメッセージが表示される場合があります。

• "An error occurred (ThrottlingException) when calling the GetParameters operation (reached max retries: 4): Rate exceeded"
• "An error occurred (ThrottlingException) when calling the GetParameter operation (reached max retries: 4): Rate exceeded"
• "An error occurred (ThrottlingException) when calling the GetParametersByPath operation (reached max retries: 4): Rate exceeded"
• "An error occurred (ThrottlingException) when calling the DescribeParameters operation (reached max retries: 2): Rate exceeded"

解決策

注: AWS CLI コマンドの実行時にエラーが発生する場合は、「AWS CLI のエラーのトラブルシューティング」を参照してください。また、AWS CLI の最新バージョンを使用していることを確認してください。

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

「レート超過」を含む「ThrottlingException」エラーメッセージが表示されないようにするには、次のアクションを実行します。

• API コールの頻度を減らします。
• API コールの間隔を設定し、すべてが同時に実行されないようにします。
• 複数の値を返す API を使用します。例えば、GetParameters と GetParametersByPath は、1 回の API コールで 10 個のパラメーターを取得できます。
• API コールの実行時に、エラー再試行とエクスポネンシャルバックオフを実装します。
• AWS Lambda を使用して Parameter Store に対する API を呼び出す場合は、パラメータをキャッシュします。

Parameter Storeのスループットを引き上げる

上記のトラブルシューティングを行っても "Rate exceeded" エラーが引き続き表示される場合は、Parameter Store のスループットを引き上げてください。最大スループットのデフォルトと最大クォータについては、「Parameter Store の Service Quotas」を参照してください。

重要: スループットを増やすと、アカウントに料金が発生します。詳細については、「AWS Systems Manager の料金」を参照してください。

関連情報

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

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