Parameter Store를 사용할 때 "속도 초과"라고 표시되는 "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"

서비스 성능을 높이기 위해 Parameter Store는 각 계정과 리전에 대해 요청을 제한합니다. Parameter Store API 최대 처리량 할당량에 대한 자세한 내용은 Service quotas for Parameter Store의 서비스 할당량을 참조하십시오.

해결 방법

참고: AWS CLI 명령을 실행할 때 오류가 발생하면 AWS CLI의 오류 문제 해결을 참조하십시오. 또한 최신 AWS CLI 버전을 사용하고 있는지 확인하십시오.

문제 해결

"속도 초과"가 포함된 "ThrottlingException" 오류 메시지를 방지하려면 다음 작업을 실행하십시오.

• API 호출 빈도를 줄입니다.
• API 호출 사이에 간격을 두어 동시에 모두 실행되지 않도록 합니다.
• 둘 이상의 값을 반환하는 API를 사용합니다. 예를 들어, GetParameters 및 GetParametersByPath는 한 번의 API 호출로 10개의 파라미터를 검색할 수 있습니다.
• API 호출 시 오류 재시도 및 지수 백오프를 구현합니다. 지침은 재시도 동작을 참조하십시오.
• AWS Lambda를 사용하여 Parameter Store를 대상으로 API를 호출하는 경우 파라미터를 캐싱합니다.
• Parameter Store 처리량을 늘립니다.
  중요: 처리량을 늘리면 계정에 요금이 부과됩니다. 자세한 내용은 AWS Systems Manager 가격 책정을 참조하십시오.

서비스 할당량 증가 요청

위의 문제 해결 방법을 시도했는데도 "속도 초과" 오류가 계속 나타나는 경우 서비스 할당량 증가를 요청할 수 있습니다.

참고: 요청을 제출하기 전에 API 호출 및 호출 속도를 확인하십시오.

Parameter Store에 대한 서비스 할당량 증가를 요청하려면 다음 단계를 완료하십시오.

1. AWS Support Center 콘솔을 연 다음 사례 생성을 선택합니다.
2. **서비스 한도 증가를 찾고 계신가요?**를 선택합니다.
3. 한도 유형에서 EC2 시스템 관리자를 선택합니다.
4. 리전의 경우 요청에서 리전을 선택합니다.
5. 리소스 유형에서 Parameter Store를 선택합니다.
6. 할당량에서 항목을 선택한 다음, 사용 사례 설명 텍스트 상자에 API 할당량 증가 이유를 설명합니다.
   참고: API 호출의 초당 최대 트랜잭션에 적용할 수 있는 항목은 없습니다.
7. 새 할당량 값을 입력합니다.
8. 사용 사례 설명 텍스트 상자에 제한 문제와 관련된 기간 및 할당량 증가 요청 이유를 입력합니다.
9. 원하는 연락 방법을 선택한 다음 제출을 선택합니다.

관련 정보

지수 백오프 및 지터

Parameter Store 문제 해결