Parameter Store를 사용할 때 "Rate exceeded"라고 표시되는 "ThrottlingException" 오류를 방지하려면 어떻게 해야 합니까?

간략한 설명

Parameter Store API 호출은 각 AWS 계정과 각 AWS 리전에 허용되는 최대 API 요청 속도를 초과할 수 없습니다. 최대 허용 속도에는 AWS Command Line Interface(AWS CLI)와 AWS Management Console에서의 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 문제 해결