在使用 AWS Systems Manager Parameter Store 時，如何防止出現「ThrottlingException」或「超出請求率」錯誤？

簡短描述

Parameter Store API 呼叫都不得超過每個帳戶和每個 AWS 區域允許的最大 API 請求率。這包括來自 AWS Command Line Interface (AWS CLI) 和 AWS Management Console 的 API 呼叫。如果 API 請求超過比率上限，您會收到「超出請求率」錯誤，且後續的 API 呼叫會受到限流。您可能會看到類似下列其中一項的錯誤：

• 呼叫 GetParameters 作業時發生錯誤 (ThrottlingException) (達到重試次數上限： 4)： 超出請求率
• 呼叫 GetParameter 作業時發生錯誤 (ThrottlingException) (達到重試次數上限： 4)： 超出請求率
• 呼叫 GetParametersByPath 作業時發生錯誤 (ThrottlingException) (達到重試次數上限： 4)： 超出請求率
• 呼叫 DescribeParameters 作業時發生錯誤 (ThrottlingException) (達到重試次數上限： 2)： 超出請求率

每個 Amazon Web Services (AWS) 帳戶會針對每個區域進行限制 Parameter Store 請求，以協助服務效能。如需 Parameter Store API 最大輸送量配額的詳細資訊，請參閱 AWS Systems Manager 端點和配額。

解決方法

疑難排解

若要避免或緩解「ThrottlingException」或「超出請求率」錯誤，請嘗試下列疑難排解步驟：

• 減少 API 呼叫的頻率。
• 錯開 API 呼叫的間隔，以便其不會全部同時執行。
• 使用傳回多個值的 API。例如：一次 API 呼叫，GetParameters 和 GetParametersByPath 支援擷取 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