AWS Systems Manager Parameter Store를 사용할 때 "ThrottlingException" 또는 "비율이 초과됨" 오류를 해결하려면 어떻게 해야 하나요?
최종 업데이트 날짜: 2021년 3월 12일
AWS Systems Manager Parameter Store를 사용할 때 다음 중 하나와 유사한 "비율이 초과됨"을 나타내는 "ThrottlingException" 오류 메시지가 수신됩니다.
- GetParameters 작업을 호출할 때 오류 발생(ThrottlingException), 최대 4회의 재시도 횟수에 도달함: 비율이 초과됨
- GetParameter 작업을 호출할 때 오류 발생(ThrottlingException), 최대 4회의 재시도 횟수에 도달함: 비율이 초과됨
- GetParametersByPath 작업을 호출할 때 오류 발생(ThrottlingException), 최대 4회의 재시도 횟수에 도달함: 비율이 초과됨
- DescribeParameters 작업을 호출할 때 오류 발생(ThrottlingException), 최대 2회의 재시도 횟수에 도달함: 비율이 초과됨
"비율이 초과됨" 오류가 발생하는 이유는 무엇이며, 문제를 해결하려면 어떻게 해야 하나요?
간략한 설명
Parameter Store API 호출은 계정 및 리전당 허용되는 최대 API 요청 속도를 초과할 수 없습니다. 여기에는 AWS 명령줄 인터페이스(AWS CLI) 및 AWS 관리 콘솔 모두의 API 호출이 포함됩니다. API 요청이 최대 속도를 초과하는 경우 "비율이 초과됨" 오류가 수신되고 추가 API 호출이 제한됩니다.
서비스 성능을 높이기 위해, Parameter Store 요청은 리전별로 각 Amazon Web Services(AWS) 계정에 대해 조정됩니다. Parameter Store API 최대 처리량 할당량에 대한 자세한 내용은 AWS Systems Manager 엔드포인트 및 할당량을 참조하세요.
해결 방법
문제 해결
"ThrottlingException" 또는 "비율이 초과됨" 오류를 방지하거나 완화하려면 다음 문제 해결 단계를 시도하세요.
- API 호출 빈도를 줄입니다.
- 한 번에 모두 실행되지 않도록 API 호출 간격을 설정합니다.
- 둘 이상의 값을 반환하는 API를 사용합니다. 예를 들어, GetParameters 및 GetParametersByPath는 하나의 API 호출에서 10개의 파라미터 호출을 지원합니다.
- API를 호출할 때 오류 재시도 및 지수 백오프를 구현합니다.
- Parameter Store 처리량 증가. 중요: 처리량을 늘리면 AWS 계정에 요금이 부과됩니다. 자세한 내용은 AWS Systems Manager 요금을 참조하세요.
참고: AWS Systems Manager 콘솔, AWS CLI 또는 AWS Tools for Windows PowerShell을 사용하여 처리량을 늘릴 수 있습니다. AWS CLI 명령을 실행할 때 오류가 발생하는 경우 최신 버전의 AWS CLI를 사용하고 있는지 확인하세요.
서비스 할당량 증가 요청
위의 모든 문제 해결 단계를 시도했지만 여전히 "비율이 초과됨" 오류가 발생하는 경우 서비스 할당량 증가를 요청할 수 있습니다.
참고: 요청을 제출하기 전에 API 호출 및 호출 속도를 식별합니다.
Parameter Store에 대한 서비스 할당량 증가를 요청하려면 다음 단계를 수행합니다.
- AWS 지원 센터를 열고 [사례 생성(Create case)]을 선택합니다.
- [서비스 한도 증가(Service limit increase)]를 선택합니다.
- [한도 유형(Limit type)]에 대해 [EC2 Systems Manager]를 선택합니다.
- [리전(Region)]에서 AWS 리전을 선택합니다.
- [리소스 유형(Resource Type)]에서 [Parameter Store]를 선택합니다.
- 늘리려는 [한도(Limit)]를 선택하고 [새 한도 값(new limit value)]을 입력합니다.
- [사용 사례 설명(Use case description)] 텍스트 상자에 조정 문제와 관련된 시간 프레임과 할당량 증가 요청의 이유를 포함합니다.
- 기본 연락처 옵션을 선택하고 [제출(Submit)]을 선택합니다.