在使用 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 呼叫和呼叫率。
若要申請增加 Parameter Store 的服務配額,請依照下列步驟執行:
- 開啟 AWS 支援中心,然後選擇建立案例。
- 選擇尋找提高服務限額?
- 針對限制類型,選擇 EC2 Systems Manager。
- 針對區域,請在請求下方選擇您的 AWS 區域。
- 針對資源類型,選擇 Parameter Store。
- 選擇您要增加的限制,然後輸入新的限制值。
- 在使用案例說明文字方塊中,填入與節流問題相關的時間範圍,以及請求增加配額的原因。
- 選擇您偏好的聯絡人選項,然後選擇提交。
相關資訊
指數退避和抖動
疑難排解 Parameter Store