API Gateway API에 대한 '429 Too Many Requests'(429 요청이 너무 많음) 또는 'Limit Exceeded'(한도 초과) 오류를 해결하려면 어떻게 해야 하나요?

간략한 설명

API Gateway에는 리전별로 계정 수준 할당량이 있습니다. 스로틀 할당량은 토큰 버킷 알고리즘에서 제공하는 추가 버스트 용량과 함께 10,000RPS(초당 요청)입니다. 최대 버킷 용량은 계정 및 리전당 요청 5,000개입니다. API Gateway 제한 관련 설정은 다음 순서로 적용됩니다.

• 사용량 계획에서 API 단계에 대해 설정한 클라이언트별 또는 메서드별 제한
• API 단계에 대해 설정한 메서드별 제한
• 리전별 계정 수준 제한
• AWS 리전별 제한

제한 한도 또는 할당량을 초과하면 '429 Too Many Requests'(429 요청이 너무 많음) 또는 'Limit Exceeded'(한도 초과) 오류 응답이 반환됩니다.

자세한 내용은 API Gateway에 조절 한도 설정을 적용하는 방법을 참조하세요.

해결 방법

시작하기 전에 지침에 따라 API Gateway 문제 해결을 위해 Amazon CloudWatch Logs를 활성화했는지 확인합니다. 오류가 발생하는 API 요청에 대해서만 실행 로그를 생성하려면 ERROR를 선택해야 합니다. 그런 다음 CloudWatch 콘솔을 사용하여 기록된 API 요청 및 응답을 확인합니다.

'429 Too Many Requests'(429 요청이 너무 많음) 오류

사용량 계획의 API 단계에 대해 설정한 클라이언트별 또는 메서드별 제한 한도에 대한 속도 또는 버스트 제한을 확인합니다. 속도 또는 버스트 제한을 초과하면 CloudWatch 실행 시 다음과 비슷한 스로틀 한도 초과 오류가 기록됩니다.

(f277a0b4-2bcd-41b3-8e43-4de770663ffb) API Key 
**********************************
F0yrv6 exceeded throttle limit for API
 Stage rohkz08x02/dev: Key throttle limit exceeded for Usage Plan ID 
nnpegc, RestApi rohkz08x02, Stage dev, Resource f646q2, HttpMethod GET. 
Limit: 5.00 Burst: 10

이 오류를 해결하려면 지터와 함께 지수 백오프 알고리즘 및 재시도를 사용한 다음, API 요청을 다시 제출합니다.

자세한 내용은 지수 백오프 및 지터를 참조하세요.

'Limit Exceeded'(한도 초과) 오류

이 오류는 API Gateway 사용 계획에 대한 할당량 한도를 초과했음을 나타낼 수 있습니다. 할당량 한도를 초과하면 CloudWatch 실행 시 다음과 비슷한 할당량 한도 초과 오류가 기록됩니다.

(7b819c41-e0a0-433a-883e-bc461fd70fd6) API Key 
**********************************
F0yrv6 exceeded quota limit for API 
Stage rohkz08x02/dev: Key quota exhausted for Usage Plan ID nnpegc. Q
Limit: 500 Period: DAY

이 오류를 해결하려면 지침에 따라 남은 할당량을 확장합니다.

---

관련 정보

"속도 초과(Rate Exceeded)" 및 429 "TooManyRequestsException" 오류가 발생한 Lambda 함수 조절 문제를 해결하려면 어떻게 해야 합니까?

내 CloudWatch logs에서 API Gateway REST API 오류를 찾으려면 어떻게 해야 하나요?