할당량 정보

API Gateway는 애플리케이션이 API를 호출하는 속도를 제어할 수 있도록 할당량을 제공합니다. 할당량을 설정하면 사용량 한도를 지정하여 호출 애플리케이션의 과도한 요청으로부터 API를 보호할 수 있습니다. 과도한 요청은 단순한 철자 오류로 인해 또는 불필요하게 API를 호출하는 비효율적으로 설계된 시스템으로 인해 발생할 수 있습니다.

원인과 무관하게 API를 전반적으로 정상 상태로 유지하려면 특정 소스의 트래픽이 일정 수준에 도달할 때 트래픽을 차단해야 합니다. 할당량을 설정하면 한 애플리케이션이 API를 사용하는 다른 애플리케이션에 부정적인 영향을 주지 않도록 할 수 있습니다.

할당량은 전체 API에 적용됨

API 구성에서 할당량 측정항목과 한도를 정의하지만 API 게이트웨이는 API 구성 자체에 적용하는 것이 아니라 API 구성을 소유한 API 에 적용합니다. API 구성을 만들 때마다 선언된 측정항목과 한도는 API의 이전 API 구성에서 선언된 측정항목과 한도를 대체합니다. 가장 최근에 생성된 API 구성의 측정항목과 한도만 적용됩니다.

API에 배포된 API 구성이 두 개 이상인 경우 다음과 같은 두 가지 결과가 발생합니다.

  • 한도의 을 변경하면 이전 API 구성을 제공하는 게이트웨이를 포함하여 API의 모든 게이트웨이에 대해 한도가 변경됩니다.

  • 측정항목 의 이름을 바꾸거나 삭제하면 이전 API 구성을 계속 제공하는 게이트웨이에 잘못된 할당량 구성이 남게 됩니다. 이러한 게이트웨이의 할당량 적용 메서드에 대한 요청은 HTTP 500 오류와 Failed to call Service Control Quota. 메시지와 함께 실패합니다.

잘못된 할당량 구성을 찾고 수정하려면 할당량 적용 메서드에 대한 API 요청이 HTTP 500 오류를 반환함을 참고하세요.