다음을 통해 공유

구독으로 사용 할당량 설정

  • 아티클

적용 대상: 모든 API Management 계층

quota 정책은 구독을 기준으로 갱신 가능 또는 수명 호출 볼륨 및/또는 대역폭 할당량을 적용할 수 있습니다. 할당량이 초과되면 호출자가 403 Forbidden 응답 상태 코드를 수신하며, 응답에는 값이 권장되는 재시도 간격(초)인 Retry-After 헤더가 포함됩니다.

속도 제한과 할당량 간의 차이를 이해하려면 속도 제한 및 할당량을 참조하세요.

참고 항목

서비스 플랫폼에서 기본 컴퓨팅 리소스가 다시 시작될 때 API Management는 할당량에 도달한 후 짧은 기간 동안 요청을 계속 처리할 수 있습니다.

참고 항목

정책 문에 제공된 순서대로 정책의 요소 및 자식 요소를 설정합니다. API Management 정책을 설정하거나 편집하는 방법에 대해 자세히 알아봅니다.

정책 문

<quota calls="number" bandwidth="kilobytes" renewal-period="seconds">
    <api name="API name" id="API id" calls="number">
        <operation name="operation name" id="operation id" calls="number" />
    </api>
</quota>

특성

특성 설명 필수 항목 기본값
bandwidth renewal-period에 지정된 시간 간격 동안 허용된 전체 최대 킬로바이트 수입니다. 정책 식은 허용되지 않습니다. calls, bandwidth 또는 둘 다 함께 지정해야 합니다. 해당 없음
호출 renewal-period에 지정된 시간 간격 동안 허용된 전체 최대 호출 수입니다. 정책 식은 허용되지 않습니다. calls, bandwidth 또는 둘 다 함께 지정해야 합니다. 해당 없음
renewal-period 할당량이 초기화된 후 고정된 기간의 길이(초)입니다. 각 기간의 시작은 구독 시작 시간을 기준으로 계산됩니다. renewal-period가 0으로 설정되면 기간이 무한으로 설정됩니다. 정책 식은 허용되지 않습니다. 예 해당 없음

Elements

요소 설명 필수
api 제품 내에서 API에 대한 호출 할당량을 적용하려면 해당 요소 중 하나 이상을 추가합니다. 제품 및 API 호출 할당량은 독립적으로 적용됩니다. API는 name 또는 id를 통해 참조할 수 있습니다. 두 특성이 모두 제공되면 id는 사용되지만 name은 무시됩니다. 아니요
operation API 내에서 작업에 대한 호출 할당량을 적용하려면 해당 요소 중 하나 이상을 추가합니다. 제품, API 및 작업 호출 할당량은 독립적으로 적용됩니다. 작업은 name 또는 id를 통해 참조할 수 있습니다. 두 특성이 모두 제공되면 id는 사용되지만 name은 무시됩니다. 아니요

api 특성

attribute 설명 필수 항목 기본값
name 호출 할당량 제한을 적용할 API의 이름입니다. name 또는 id를 지정해야 합니다. 해당 없음
id 호출 할당량 제한을 적용할 API의 ID입니다. name 또는 id를 지정해야 합니다. 해당 없음
bandwidth renewal-period에 지정된 시간 간격 동안 허용된 전체 최대 킬로바이트 수입니다. 정책 식은 허용되지 않습니다. calls, bandwidth 또는 둘 다 함께 지정해야 합니다. 해당 없음
호출 renewal-period에 지정된 시간 간격 동안 허용된 전체 최대 호출 수입니다. 정책 식은 허용되지 않습니다. calls, bandwidth 또는 둘 다 함께 지정해야 합니다. 해당 없음
renewal-period 할당량이 초기화된 후 고정된 기간의 길이(초)입니다. 각 기간의 시작은 구독 시작 시간을 기준으로 계산됩니다. renewal-period가 0으로 설정되면 기간이 무한으로 설정됩니다. 정책 식은 허용되지 않습니다. 예 해당 없음

작업 특성

attribute 설명 필수 항목 기본값
name 호출 할당량 제한을 적용할 작업의 이름입니다. name 또는 id를 지정해야 합니다. 해당 없음
id 호출 할당량 제한을 적용할 작업의 ID입니다. name 또는 id를 지정해야 합니다. 해당 없음
bandwidth renewal-period에 지정된 시간 간격 동안 허용된 전체 최대 킬로바이트 수입니다. 정책 식은 허용되지 않습니다. calls, bandwidth 또는 둘 다 함께 지정해야 합니다. 해당 없음
호출 renewal-period에 지정된 시간 간격 동안 허용된 전체 최대 호출 수입니다. 정책 식은 허용되지 않습니다. calls, bandwidth 또는 둘 다 함께 지정해야 합니다. 해당 없음
renewal-period 할당량이 초기화된 후 고정된 기간의 길이(초)입니다. 각 기간의 시작은 구독 시작 시간을 기준으로 계산됩니다. renewal-period가 0으로 설정되면 기간이 무한으로 설정됩니다. 정책 식은 허용되지 않습니다. 예 해당 없음

사용

사용법 참고 사항

  • 이 정책은 정책 정의당 한 번만 사용할 수 있습니다.
  • 이 정책은 구독 키를 사용하여 API에 액세스할 때만 적용됩니다.

예시

<policies>
    <inbound>
        <base />
        <quota calls="10000" bandwidth="40000" renewal-period="3600" />
    </inbound>
    <outbound>
        <base />
    </outbound>
</policies>

관련 콘텐츠

정책 작업에 대한 자세한 내용은 다음을 참조하세요.