ResetQuota 정책

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보

내용

대상 할당량 정책에서 허용하는 나머지 요청 수를 동적으로 수정하는 데 사용합니다. 할당량 개수가 재설정될 때까지 기다리는 대신 일반적으로 이 정책을 사용하여 대상 할당량 정책의 현재 할당량 수를 줄입니다.

예를 들어 대상 할당량 정책은 개발자의 요청을 매주 1,000개로 제한합니다. 해당 주의 둘째 날, 개발자는 이미 이 한도에 도달했습니다. Reset Quota 정책을 사용하여 할당량 카운터에서 500개를 빼고 해당 주의 나머지 기간 동안 추가 500개의 요청을 허용합니다. 해당 주의 마지막 날, 할당량 정책은 재설정되고 다가오는 주에 대한 개발자의 한도는 요청 1,000개로 돌아갑니다.

할당량 정책에 대한 자세한 내용은 할당량 정책을 참조하세요. Reset Quota 정책 사용에 대한 자세한 내용은 이 커뮤니티 게시물도 참조하세요.

샘플

다음 정책 코드 샘플은 할당량 카운터를 재설정하는 방법을 보여줍니다.

<ResetQuota name="resetQuota">
   <Quota name="MyQuotaPolicy">
      <Identifier name="_default">
         <Allow>100</Allow>
      </Identifier>
   </Quota>
</ResetQuota>

<Quota name="MyQuotaPolicy">
  <Interval>5</Interval>
  <TimeUnit>hour</TimeUnit>
  <Allow count="100"/>
</Quota>

<ResetQuota name="resetQuota">
   <Quota ref="request.header.quotapolicy">
      <Identifier name="_default">
         <Allow ref="request.header.allowquota" />
      </Identifier>
   </Quota>
</ResetQuota>

<ResetQuota name="resetQuota">
   <Quota name="QuotaPolicy">
      <Identifier ref="request.header.clientId">
         <Allow>100</Allow>
      </Identifier>
   </Quota>
</ResetQuota>

<Quota name="QuotaPolicy">
  <Identifier ref="request.header.clientId"/> 
  <Interval>5</Interval>
  <TimeUnit>hour</TimeUnit>
  <Allow count="100"/>
</Quota>

요소 참조

요소 참조는 Reset Quota 정책의 요소 및 속성을 설명합니다.

<ResetQuota async="false" continueOnError="false" enabled="true" name="Reset-Quota-1">
   <DisplayName>Reset Quota 1</DisplayName>
   <Quota name="quotaName" ref="request.header.quotapolicy">
      <Identifier name="identifierName" ref="request.header.identifier">
         <Class ref="request.header.classIdentifier" />
         <Allow>100</Allow>
      </Identifier>
   </Quota>
</ResetQuota>

<ResetQuota> 속성

<ResetQuota async="false" continueOnError="false" enabled="true" name="Reset-Quota-1"> 

다음 표는 모든 정책 상위 요소의 공통 속성에 대해 설명합니다.

<DisplayName> 요소

name 속성 외에도 이 요소를 사용하여 관리 UI 프록시 편집기의 정책에 다른 자연어 이름으로 라벨을 지정합니다.

<DisplayName>Policy Display Name</DisplayName>

<Quota> 요소

카운터가 업데이트되어야 하는 대상 할당량 정책을 식별합니다.

<Quota name="quotaName"  ref="request.header.quotapolicy">
   <Identifier name="identifierName" ref="request.header.identifier">
      <Allow>100</Allow>
   </Identifier>
</Quota>

특성

<Quota>/<Identifier> 요소

대상 할당량 정책이 <Identifier> 태그를 지정하는 경우 카운터를 고유하게 식별하는 데 사용되는 변수입니다.

<Quota name="quotaName">
   <Identifier name="identifierName" ref="request.header.identifier">
      <Allow>100</Allow>
   </Identifier>
</Quota>

특성

<Quota>/<Identifier>/<Allow> 요소

줄일 할당량 카운터의 양을 지정합니다. <Allow>를 지정해야 하며, 그렇지 않으면 정책이 할당량을 수정하지 않습니다.

<Identifier name="identifierName" ref="request.header.identifier">
   <Allow ref="request.header.allowquota">100</Allow>
</Identifier>

특성

<Quota>/<Identifier>/<Class> 요소

할당량 카운터가 업데이트되는 클래스를 지정합니다. 할당량 정책에 클래스를 사용하는 방법에 대한 자세한 내용은 할당량 정책을 참조하세요.

<Identifier name="_default">
   <Class ref="request.header.classIdentifier">
     <Allow>200</Allow>
   </Class>
</Identifier>

특성

오류 참조

이 섹션에서는 반환되는 오류 코드, 오류 메시지, 정책이 오류를 트리거할 때 Edge에서 설정하는 오류 변수를 설명합니다. 오류를 처리하기 위해 오류 규칙을 개발 중인 경우, 이 정보는 중요합니다. 자세한 내용은 정책 오류에 대해 알아야 할 사항 및 오류 처리를 참조하세요.

런타임 오류

이러한 오류는 정책이 실행될 때 발생할 수 있습니다.

배포 오류

이 오류는 이 정책이 포함된 프록시를 배포할 때 발생할 수 있습니다.

스키마

관련 주제

할당량 정책