ResetQuota 政策

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件。 資訊

結果

用於動態修改目標配額政策允許的剩餘要求數量。 您通常會透過這項政策來減少目標配額政策目前的配額數量 而不必等候重設配額

例如，目標配額政策將開發人員每週只能提出 1000 個要求。按照 開發人員已達到此上限。使用重設配額政策 ，讓我們從配額計數器中減去 500 個要求，允許額外的 500 個要求， 一整週。一週結束時，配額政策會重設，開發人員將恢復為 1000 包括每週收到的要求數量

詳情請參閱配額政策 配額政策。另請參閱這個 社群貼文：瞭解如何使用「重設配額」政策。

範例

下列政策程式碼範例說明如何重設配額計數器：

<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>

元素參照

元素參照會說明重設配額政策的元素和屬性。

<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 Proxy 編輯器，使用不同的自然語言名稱。

<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 設定的錯誤變數。 如果您正在開發錯誤規則來處理錯誤，請務必瞭解這項資訊。詳情請參閱「政策錯誤須知」和「處理錯誤」。

執行階段錯誤

執行政策時，可能會發生這些錯誤。

部署錯誤

若您部署包含這項政策的 Proxy，就可能會發生這些錯誤。

結構定義

相關主題

配額政策