如何在使用 Parameter Store 時防止顯示「超出請求率」的「ThrottlingException」錯誤？

簡短說明

Parameter Store API 呼叫不得超過每個 AWS 帳戶和每個 AWS 區域允許的最大 API 請求率。允許的最大請求率包括來自 AWS Command Line Interface (AWS CLI) 和 AWS Management Console 的 API 呼叫。

如果 API 請求超過最大請求率，您可能會看到類似下列其中一個項目的錯誤訊息：

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

為了協助提升服務效能，Parameter Store 會對每個帳戶和區域進行請求節流。如需有關 Parameter Store API 輸送量配額上限的詳細資訊，請參閱Parameter Store 的服務配額。

解決方法

**注意：**如果您在執行 AWS CLI 命令時收到錯誤，請參閱對 AWS CLI 錯誤進行疑難排解。此外，請確定您使用的是最新的 AWS CLI 版本。

疑難排解

若要防止包含「超出請求率」的「ThrottlingException」錯誤訊息，請執行下列動作：

• 減少 API 呼叫的頻率。
• 設定 API 呼叫的間隔，使它們不會全部同時執行。
• 使用傳回多個值的 API。例如，GetParameters 和 GetParametersByPath 可以透過一次 API 呼叫擷取 10 個參數。
• 進行 API 呼叫時，實作錯誤重試和指數退避。如需指示，請參閱重試行為。
• 如果您針對 Parameter Store 使用 AWS Lambda 來呼叫 API，請快取您的參數。
• 增加 Parameter Store 輸送量。
  **重要：**當您增加輸送量時，AWS 會對您的帳戶收取費用。如需詳細資訊，請參閱 AWS Systems Manager 定價。

請求增加服務配額

如果您已嘗試上述所有疑難排解方法，但仍收到「超出請求率」錯誤訊息，則可以請求提高服務配額。

**注意：**在提交請求之前，請確定 API 呼叫和呼叫率。

若要請求增加 Parameter Store 的服務配額，請完成下列步驟：

1. 開啟 AWS Support 主控台，然後選擇 Create case (建立案例)。
2. 選擇Looking for service limit increases? (想要提高服務限額？)
3. 針對 Limit type (限制類型)，選擇 EC2 Systems Manager。
4. 針對 Region (區域)，請在 Requests (請求) 下方選擇您的區域。
5. 在 Resource Type (資源類型)，請選擇 Parameter Store。
6. 在 Quota (配額)，請選取項目，然後在 Use case description (使用案例描述) 文字方塊中描述 API 配額增加的原因。
   **注意：**API 呼叫每秒交易上限數暫無適用項目。
7. 輸入新配額值。
8. 在 Use case description (使用案例說明) 文字方塊中，填入與節流問題相關的時間範圍，以及請求增加配額的原因。
9. 選擇您偏好的聯絡人選項，然後選擇 Submit (提交)。

相關資訊

指數退避和抖動

疑難排解 Parameter Store