如何在使用 Parameter Store 時，避免顯示「Rate exceeded」的「ThrottlingException」錯誤？

簡短說明

Parameter Store API 呼叫不得超過每個 AWS 帳戶和每個 AWS 區域允許的 API 請求速率上限。允許的速率上限包含來自 AWS Command Line Interface (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 版本。

疑難排解錯誤

若要避免包含「Rate exceeded」的「ThrottlingException」錯誤訊息，請採取以下動作：

• 降低 API 呼叫頻率。
• 設定 API 呼叫間隔，讓呼叫不會全部同時執行。
• 使用可傳回多個值的 API。例如，GetParameters 和 GetParametersByPath 可以透過一次 API 呼叫擷取 10 個參數。
• 進行 API 呼叫時，請實作錯誤重試和指數退避。
• 如果您使用 AWS Lambda 對 Parameter Store 呼叫 API，請快取您的參數。

提高 Parameter Store 輸送量

如果您採取上述疑難排解動作後仍收到「Rate exceeded」錯誤，請提高您的 Parameter Store 輸送量。如需預設輸送量上限和最高配額的資訊，請參閱 Parameter Store 的服務配額。

**重要：**提高輸送量時，您的帳戶會產生費用。如需更多資訊，請參閱 AWS Systems Manager 定價。

相關資訊

指數退避和抖動

疑難排解 Parameter Store