AWS Systems Manager Parameter Store를 사용할 때 "ThrottlingException" 또는 "비율이 초과됨" 오류를 해결하려면 어떻게 해야 하나요?

최종 업데이트 날짜: 2021년 3월 12일

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에 대한 서비스 할당량 증가를 요청하려면 다음 단계를 수행합니다.

1. AWS 지원 센터를 열고 [사례 생성(Create case)]을 선택합니다.
2. [서비스 한도 증가(Service limit increase)]를 선택합니다.
3. [한도 유형(Limit type)]에 대해 [EC2 Systems Manager]를 선택합니다.
4. [리전(Region)]에서 AWS 리전을 선택합니다.
5. [리소스 유형(Resource Type)]에서 [Parameter Store]를 선택합니다.
6. 늘리려는 [한도(Limit)]를 선택하고 [새 한도 값(new limit value)]을 입력합니다.
7. [사용 사례 설명(Use case description)] 텍스트 상자에 조정 문제와 관련된 시간 프레임과 할당량 증가 요청의 이유를 포함합니다.
8. 기본 연락처 옵션을 선택하고 [제출(Submit)]을 선택합니다.