रीसेट कोटा नीति

आपको Apigee Edge दस्तावेज़ दिख रहा है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है इस पेज पर जाएं Apigee X दस्तावेज़.
जानकारी

क्या

टारगेट कोटा की नीति के तहत, बचे हुए अनुरोधों की संख्या में डाइनैमिक तरीके से बदलाव करने के लिए इसका इस्तेमाल करें. आम तौर पर, इस नीति का इस्तेमाल, टारगेट कोटा की नीति के लिए मौजूदा कोटा की संख्या कम करने के लिए किया जाता है ऐसा करने से आपको कोटा काउंट के रीसेट होने का इंतज़ार करना होगा.

उदाहरण के लिए, टारगेट कोटा की नीति के तहत डेवलपर को हर हफ़्ते ज़्यादा से ज़्यादा 1,000 अनुरोध करने की अनुमति है. के मुताबिक हफ़्ते के दूसरे दिन, डेवलपर इस सीमा तक पहले ही पहुंच चुका है. कोटा रीसेट करने की नीति का इस्तेमाल करें के कोटा काउंटर से 500 घटाने पर, बची हुई अवधि के लिए 500 और अनुरोध स्वीकार किए जा सकते हैं. सप्ताह. हफ़्ते के आखिर में, कोटा की नीति रीसेट हो जाती है और डेवलपर वापस 1, 000 पर पहुंच जाता है हफ़्ते के अनुरोध.

ज़्यादा जानकारी के लिए, कोटा की नीति देखें कोटा की नीति पढ़ें. इसे भी देखें कम्यूनिटी पोस्ट में, कोटा रीसेट करने की नीति के बारे में बताया गया है.

सैंपल

नीति कोड के इन सैंपल में, कोटा काउंटर रीसेट करने का तरीका बताया गया है:

डिफ़ॉल्ट काउंटर रीसेट करें

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

कोटा रीसेट करने की नीति, <quot> टैग के name एट्रिब्यूट का इस्तेमाल करके, कोटा के लिए तय की गई नीति के बारे में बताती है. ऊपर दिए गए उदाहरण में, का टारगेट है, MyquotPolicy नीति को टारगेट किया गया है.

कोटा रीसेट करने से जुड़ी सभी नीतियों को &lt;Identifier&gt; टैग की मदद से यह तय करना होता है कि अपडेट करने के लिए कोटा नीति में काउंटर का इस्तेमाल करें. कोटे की नीति में डिफ़ॉल्ट रूप से एक काउंटर होता है, अगर कोटा नीति में &lt;Identifier&gt; टैग भी शामिल नहीं है. इस उदाहरण में, टारगेट कोटा की नीति, &lt;Identifier&gt; टैग का इस्तेमाल नहीं करती है. इसलिए, आपने name एट्रिब्यूट _default पर लागू होता है.

&lt;Allow&gt; एलिमेंट टारगेट की गई नीति के लिए मौजूदा कोटा की संख्या को कम करने वाली वैल्यू के बारे में बताता है. इसमें उदाहरण के लिए, टारगेट कोटा के लिए 100 और अनुरोध स्वीकार करने के लिए, कोटा की संख्या 100 तक घट गई है की नीति देखें. टारगेट कोटा की नीति रीसेट होने पर, यह बदलाव खारिज कर दिया जाता है.

टारगेट कोटा की नीति की परिभाषा यहां दी गई है:

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

अगर टारगेट कोटा की नीति में &lt;Identifier&gt; टैग शामिल है, तो ये काम किए जा सकते हैं रीसेट कोटा के &lt;Identifier&gt; टैग के लिए वही वैल्यू डालें का इस्तेमाल करें. देखें कि टारगेट में &lt;Identifier&gt; टैग कैसे नीचे दी गई कोटा नीति, कोटा रीसेट करने की नीति में दी गई वैल्यू से मेल खाती है:

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

&lt;ResetQuota&gt; एट्रिब्यूट

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

यहां दी गई टेबल में, ऐसे एट्रिब्यूट के बारे में बताया गया है जो नीति के सभी पैरंट एलिमेंट में एक जैसे होते हैं:

एट्रिब्यूट ब्यौरा डिफ़ॉल्ट मौजूदगी
name

नीति का अंदरूनी नाम. name एट्रिब्यूट की वैल्यू ये काम कर सकती है: अक्षरों, संख्याओं, स्पेस, हाइफ़न, अंडरस्कोर, और फ़ुलस्टॉप को शामिल करें. यह मान नहीं हो सकता 255 वर्णों से ज़्यादा होने चाहिए.

इसके अलावा, नीति को लेबल करने के लिए, <DisplayName> एलिमेंट का इस्तेमाल करें प्रबंधन यूज़र इंटरफ़ेस (यूआई) प्रॉक्सी एडिटर को अलग, आम भाषा में इस्तेमाल करने वाले नाम के साथ किया जा सकता है.

लागू नहीं ज़रूरी है
continueOnError

किसी नीति के काम न करने पर, गड़बड़ी दिखाने के लिए false पर सेट करें. यह उम्मीद है व्यवहार की जानकारी देने वाला डेटा.

नीति के लागू होने के बाद भी फ़्लो को एक्ज़ीक्यूट करने के लिए, इसे true पर सेट करें विफल होता है.

गलत वैकल्पिक
enabled

नीति को लागू करने के लिए, true पर सेट करें.

नीति को बंद करने के लिए, false पर सेट करें. नीति लागू किया जाता है, भले ही वह किसी फ़्लो से जुड़ा रहता हो.

सही वैकल्पिक
async

यह एट्रिब्यूट अब काम नहीं करता.

गलत बहिष्कृत

&lt;DisplayName&gt; एलिमेंट

इस कॉलम में नीति को लेबल करने के लिए, name एट्रिब्यूट के साथ-साथ इस्तेमाल करें मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) प्रॉक्सी एडिटर, जिसका नाम अलग और सामान्य भाषा में है.

<DisplayName>Policy Display Name</DisplayName>
डिफ़ॉल्ट

लागू नहीं

अगर आप इस एलिमेंट को छोड़ देते हैं, तो नीति की name एट्रिब्यूट की वैल्यू यह होगी इस्तेमाल किया गया.

मौजूदगी वैकल्पिक
टाइप स्ट्रिंग

&lt;Quota&gt; एलिमेंट

टारगेट कोटा की उस नीति की पहचान करता है जिसका काउंटर अपडेट किया जाना चाहिए.

<Quota name="quotaName"  ref="request.header.quotapolicy">
   <Identifier name="identifierName" ref="request.header.identifier">
      <Allow>100</Allow>
   </Identifier>
</Quota>
डिफ़ॉल्ट: लागू नहीं
मौजूदगी: ज़रूरी है
टाइप: लागू नहीं

विशेषताएं

एट्रिब्यूट ब्यौरा डिफ़ॉल्ट मौजूदगी
नाम

टारगेट कोटा की नीति का नाम बताता है.

लागू नहीं वैकल्पिक
संदर्भ एक फ़्लो वैरिएबल, जिसमें टारगेट कोटा की नीति का नाम होता है. अगर आपने ref और name दोनों से जुड़ी जानकारी दी गई है, तो ref को प्राथमिकता दी जाती है. अगर ref ऐसा करता है रनटाइम पर रिज़ॉल्व नहीं होता है, तो name का इस्तेमाल किया जाता है. लागू नहीं वैकल्पिक

&lt;Quota&gt;/&lt;Identifier&gt; एलिमेंट

अगर टारगेट कोटा नीति में बताई गई सीमा में, काउंटर की खास तौर पर पहचान करने के लिए वैरिएबल का इस्तेमाल किया जाता है &lt;Identifier&gt; टैग.

<Quota name="quotaName">
   <Identifier name="identifierName" ref="request.header.identifier">
      <Allow>100</Allow>
   </Identifier>
</Quota>
डिफ़ॉल्ट: लागू नहीं
मौजूदगी: ज़रूरी है
टाइप: स्ट्रिंग

विशेषताएं

एट्रिब्यूट ब्यौरा डिफ़ॉल्ट मौजूदगी
नाम

टारगेट कोटा की नीति में, संख्या के आइडेंटिफ़ायर का नाम बताता है. कोटा के लिए वह नीति जो &lt;Identifier&gt; टैग का इस्तेमाल नहीं करती है. _default पर लागू होता है.

लागू नहीं वैकल्पिक
संदर्भ

एक फ़्लो वैरिएबल, जिसमें टारगेट कोटा में संख्या वाले आइडेंटिफ़ायर का नाम होता है की नीति देखें. अगर ref और name दोनों बताए गए हों, तो ref को प्राथमिकता दी जाती है. अगर ref का समाधान तो name का इस्तेमाल किया जाता है.

लागू नहीं वैकल्पिक

&lt;Quota&gt;/&lt;Identifier&gt;/&lt;Allow&gt; एलिमेंट

कोटा काउंटर कम करने की रकम बताता है. आपको &lt;Allow&gt; का इस्तेमाल करना होगा, नहीं तो नीति लागू नहीं होगी कोटा संशोधित करें.

<Identifier name="identifierName" ref="request.header.identifier">
   <Allow ref="request.header.allowquota">100</Allow>
</Identifier>
डिफ़ॉल्ट: लागू नहीं
मौजूदगी: ज़रूरी है
टाइप: पूर्णांक

विशेषताएं

एट्रिब्यूट ब्यौरा डिफ़ॉल्ट मौजूदगी
संदर्भ

एक फ़्लो वैरिएबल, जिसमें टारगेट कोटा की नीति में कोटे की संख्या में बदलाव शामिल होता है.

लागू नहीं वैकल्पिक

&lt;Quota&gt;/&lt;Identifier&gt;/&lt;Class&gt; एलिमेंट

इस नीति से उस कैटगरी के बारे में पता चलता है जिसके लिए कोटा काउंटर अपडेट किया गया है. कोटा नीति, कोटा देखें नीति पढ़ें.

<Identifier name="_default">
   <Class ref="request.header.classIdentifier">
     <Allow>200</Allow>
   </Class>
</Identifier>
डिफ़ॉल्ट: लागू नहीं
मौजूदगी: वैकल्पिक
टाइप: लागू नहीं

विशेषताएं

एट्रिब्यूट ब्यौरा डिफ़ॉल्ट मौजूदगी
संदर्भ

उस फ़्लो वैरिएबल का रेफ़रंस जिसमें अपडेट किया जाने वाला कोटा क्लास शामिल है.

लागू नहीं वैकल्पिक

गड़बड़ी का रेफ़रंस

This section describes the fault codes and error messages that are returned and fault variables that are set by Edge when this policy triggers an error. This information is important to know if you are developing fault rules to handle faults. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

These errors can occur when the policy executes.

Fault code HTTP status Cause Fix
policies.resetquota.InvalidRLPolicy 500 The Quota policy specified in the <Quota> element of the Reset Quota policy is not defined in the API proxy and thus is not available during the flow. The <Quota> element is mandatory and identifies the target Quota policy whose counter should be updated through the Reset Quota policy.
policies.resetquota.FailedToResolveAllowCountRef N/A The reference to the variable containing the allow count in the <Allow> element of the policy cannot be resolved to a value. This element is mandatory and specifies the amount to decrease the quota counter.
policies.resetquota.FailedToResolveRLPolicy 500 The variable referenced by the ref attribute in the <Quota> element cannot be resolved.

Deployment errors

These errors can occur when you deploy a proxy containing this policy.

Error name Cause Fix
InvalidCount If the count value specified in the <Allow> element of the Reset Quota Policy is not an integer, then the deployment of the API proxy fails.

स्कीमा

मिलते-जुलते विषय

कोटा की नीति