कोटा नीति

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

क्या

अनुरोध वाले मैसेज की संख्या कॉन्फ़िगर करने के लिए कोटा नीति का इस्तेमाल करें किसी समयावधि के बारे में बताएं, जैसे कि मिनट, घंटा, दिन, हफ़्ता या महीना. आप कोटा को इस प्रकार सेट कर सकते हैं: एपीआई प्रॉक्सी का इस्तेमाल करने वाले सभी ऐप्लिकेशन के लिए एक जैसा होगा या फिर आप इनके आधार पर कोटा सेट कर सकते हैं:

• वह प्रॉडक्ट जिसमें एपीआई प्रॉक्सी शामिल है
• एपीआई का अनुरोध करने वाला ऐप्लिकेशन
• ऐप्लिकेशन डेवलपर
• कई अन्य शर्तें

ट्रैफ़िक में हुई कुल बढ़ोतरी से बचने के लिए कोटा का इस्तेमाल न करें. इसके लिए, स्पाइक अरेस्ट का इस्तेमाल करें की नीति देखें. स्पाइक अरेस्ट देखें नीति पढ़ें.

वीडियो

इन वीडियो में, कोटा नीति के साथ कोटा मैनेजमेंट की सुविधा उपलब्ध है:

सैंपल

नीति कोड के इन सैंपल में, कोटा की अवधि शुरू और खत्म करने का तरीका बताया गया है. इसके लिए:

<Quota name="CheckQuota"> 
  <Interval ref="verifyapikey.verify-api-key.apiproduct.developer.quota.interval">1</Interval>
  <TimeUnit ref="verifyapikey.verify-api-key.apiproduct.developer.quota.timeunit">hour</TimeUnit>
  <Allow count="200" countRef="verifyapikey.verify-api-key.apiproduct.developer.quota.limit"/>
</Quota>

<Quota name="DeveloperQuota"> 
  <Identifier ref="verifyapikey.verify-api-key.client_id"/> 
  <Interval ref="verifyapikey.verify-api-key.developer.timeInterval"/> 
  <TimeUnit ref="verifyapikey.verify-api-key.developer.timeUnit"/> 
  <Allow countRef="verifyapikey.verify-api-key.developer.limit"/> 
</Quota>

<Quota name="QuotaPolicy" type="calendar">
  <StartTime>2017-02-18 10:30:00</StartTime>
  <Interval>5</Interval>
  <TimeUnit>hour</TimeUnit>
  <Allow count="99"/>
</Quota>

<Quota name="QuotaPolicy">
  <Interval>5</Interval>
  <TimeUnit>hour</TimeUnit>
  <Allow count="99"/>
</Quota>

<AssignMessage async="false" continueOnError="false" enabled="true" name="ReturnQuotaVars">
    <AssignTo createNew="false" type="response"/>
    <Set>
        <Headers>
            <Header name="QuotaLimit">{ratelimit.QuotaPolicy.allowed.count}</Header>
            <Header name="QuotaUsed">{ratelimit.QuotaPolicy.used.count}</Header>
            <Header name="QuotaResetUTC">{ratelimit.QuotaPolicy.expiry.time}</Header>
        </Headers>
    </Set>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
</AssignMessage>

<Quota name="MyQuota">
  <Interval>1</Interval>
  <TimeUnit>hour</TimeUnit>
  <Allow count="10000"/>
</Quota>

<Quota name="QuotaPolicy" type="calendar">
  <Identifier ref="request.header.clientId"/> 
  <StartTime>2017-02-18 10:00:00</StartTime>
  <Interval>5</Interval>
  <TimeUnit>hour</TimeUnit>
  <Allow count="99"/>
</Quota>

<Identifier ref="request.queryparam.id"/>

<Identifier ref="verifyapikey.verify-api-key.client_id"></Identifier>

<Quota name="QuotaPolicy">
  <Interval>1</Interval>
  <TimeUnit>day</TimeUnit>
  <Allow>
    <Class ref="request.header.developer_segment">
      <Allow class="platinum" count="10000"/>
      <Allow class="silver" count="1000" />
    </Class>
  </Allow>
</Quota>

कोटा नीति के बारे में जानकारी

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

उदाहरण के लिए, अगर किसी महीने के लिए कोटा को 10,000 मैसेज के तौर पर सेट किया गया है, तो दर सीमित करने की प्रोसेस इस तारीख के बाद शुरू होगी 10,000वां मैसेज दिखता है. इससे कोई फ़र्क़ नहीं पड़ता कि पहले 10,000 मैसेज गिने गए दिन या उस अवधि का आखिरी दिन; कोटा काउंटर से पहले, किसी भी अतिरिक्त अनुरोध की अनुमति नहीं है तय समय अंतराल पर खत्म होने पर या कोटा के पूरी तरह से सेट हो जाने तक अपने-आप रीसेट हो जाता है रीसेट करें कोटा का इस्तेमाल करके रीसेट करें नीति पढ़ें.

कोटा में बदलाव जिसे SpikeAest कहा जाता है, ट्रैफ़िक में होने वाली बढ़ोतरी (या बर्स्ट) को रोकता है, जो ऐसा उपयोगकर्ताओं की संख्या में अचानक हुई बढ़ोतरी, गड़बड़ी वाले क्लाइंट या नुकसान पहुंचाने वाले हमलों की वजह से हो सकता है. ज़्यादा के लिए अगर हां, तो स्पाइक अरेस्ट से जुड़ी नीति देखें.

कोटा, अलग-अलग एपीआई प्रॉक्सी पर लागू होते हैं और एपीआई प्रॉक्सी के बीच नहीं बांटे जाते हैं. उदाहरण के लिए, अगर आपके पास किसी एपीआई प्रॉडक्ट में तीन एपीआई प्रॉक्सी हैं, तो किसी एक कोटा को तीनों के बीच शेयर नहीं किया जाता भले ही, तीनों एक ही कोटा नीति के कॉन्फ़िगरेशन का इस्तेमाल करते हों.

कोटा की नीति के टाइप

कोटा की नीति कई अलग-अलग तरह की नीतियों के साथ काम करती है: डिफ़ॉल्ट, calendar, flexi और rollingwindow. हर टाइप तय करता है कि कोटा काउंटर कब चालू होगा शुरू होता है और जब यह रीसेट होता है, जैसा कि नीचे दी गई टेबल में दिखाया गया है:

type="calendar" के लिए, आपको <StartTime>.

टेबल में, rollingwindow टाइप के लिए वैल्यू शामिल नहीं है. रोलिंग विंडो कोटा, किसी कोटा "विंडो" का आकार सेट करके काम करता है, जैसे कि एक घंटे या एक दिन की विंडो. जब नया अनुरोध आता है, तो नीति यह तय करती है कि क्या पहले कोटा पार हुआ "विंडो" समय की है.

उदाहरण के लिए, दो घंटे की ऐसी विंडो सेट की जाती है जिसमें 1,000 अनुरोध किए जा सकते हैं. नया अनुरोध शाम 4:45 बजे आती है. यह नीति पिछले दो घंटे के विंडो के लिए कोटा की संख्या गिनती है. यानी, दोपहर 2:45 बजे से अब तक मिले अनुरोधों की संख्या. अगर कोटे की सीमा पार न हुई हो दो घंटे की विंडो हो, तो अनुरोध की अनुमति हो.

एक मिनट बाद, शाम 4:46 बजे आपको दूसरा अनुरोध आता है. अब नीति, यह पता लगाने के लिए कि सीमा पार हुई है या नहीं.

rollingwindow टाइप के लिए, काउंटर कभी भी रीसेट नहीं होता, लेकिन हर अनुरोध पर फिर से हिसाब लगाया जाता है.

कोटा काउंटर के बारे में जानकारी

डिफ़ॉल्ट रूप से, कोटा नीति एक ही काउंटर बनाए रखती है, भले ही आप कितनी बार भी इसे किसी API प्रॉक्सी में रेफ़र करें. कोटा काउंटर का नाम इस पर आधारित होता है नीति की name एट्रिब्यूट की वैल्यू सबमिट करें.

उदाहरण के लिए, आपने 5 की सीमा वाली MyQuotaPolicy नाम की एक कोटा नीति बनाई है को अनुरोध करता है और उसे एपीआई प्रॉक्सी में एक से ज़्यादा फ़्लो (फ़्लो A, B, और C) पर रखता है. भले ही यह का इस्तेमाल कई फ़्लो में किया है, इसलिए यह एक ही काउंटर बनाए रखता है, जिसे नीति:

• फ़्लो A चलाया जाता है -> MyPolicyPolicy लागू किया गया और इसका काउंटर = 1
• फ़्लो B चलाया जाता है -> MyquotPolicy लागू की गई है और इसका काउंटर = 2
• फ़्लो A चलाया जाता है -> MyPolicyPolicy लागू किया गया और इसका काउंटर = 3
• फ़्लो C चलाया जाता है -> MyTotalPolicy लागू किया गया और इसका काउंटर = 4
• फ़्लो A चलाया जाता है -> MyTotalPolicy लागू किया गया और इसका काउंटर = 5

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

एपीआई प्रॉक्सी फ़्लो में एक से ज़्यादा जगहों पर, कोटा की एक ही नीति का इस्तेमाल करना. इससे गलती से कोटा आपकी उम्मीद से ज़्यादा तेज़ी से खत्म हो जाता है. Apigee Edge के एंटीपैटर्न की किताब.

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

या, इसमें <Class> या <Identifier> एलिमेंट शामिल हैं कोटा नीति का इस्तेमाल एक ही नीति में कई यूनीक काउंटर तय करने के लिए किया जाएगा. इनका इस्तेमाल करके एलिमेंट के लिए, एक ही नीति के तहत अलग-अलग काउंटर बनाए जा सकते हैं. यह इस बात पर निर्भर करता है कि ऐप्लिकेशन किस तरह का अनुरोध करता है, अनुरोध करने वाले ऐप्लिकेशन डेवलपर, क्लाइंट आईडी या अन्य क्लाइंट आइडेंटिफ़ायर वगैरह. ज़्यादा जानकारी के लिए, ऊपर दिए गए उदाहरणों के ज़रिए, <Class> या <Identifier> एलिमेंट.

टाइम नोटेशन

कोटा के सभी समय, कोऑर्डिनेटेड यूनिवर्सल पर सेट किए जाते हैं समय (यूटीसी) टाइम ज़ोन.

कोटा टाइम नोटेशन, अंतरराष्ट्रीय में बताए गए अंतरराष्ट्रीय स्टैंडर्ड तारीख के नोटेशन का पालन करता है स्टैंडर्ड ISO 8601.

तारीख को साल, महीने, और दिन के फ़ॉर्मैट में दिखाया जाता है: YYYY-MM-DD. उदाहरण के लिए, 2015-02-04 से 4 फ़रवरी, 2015 का डेटा मिलता है.

नीचे दिए गए फ़ॉर्मैट में दिन के समय को घंटे, मिनट, और सेकंड के तौर पर दिखाया जाता है: hours:minutes:seconds. उदाहरण के लिए, 23:59:59 समय पहला दिखाता है आधी रात से पहले.

ध्यान दें कि 00:00:00 और 24:00:00 दो नोटेशन यहां उपलब्ध हैं दो मध्यरात्रि में अंतर करता है, जिसे एक तारीख से जोड़ा जा सकता है. इसलिए 2015-02-04 24:00:00 और 2015-02-05 00:00:00 एक ही तारीख और समय हैं. बाद वाला है आम तौर पर नोटेशन का इस्तेमाल करें.

एपीआई प्रॉडक्ट कॉन्फ़िगरेशन से कोटा सेटिंग पाना

एपीआई प्रॉडक्ट कॉन्फ़िगरेशन में कोटा की सीमाएं सेट की जा सकती हैं. ये सीमाएं अपने-आप कोटा लागू करें. इसके बजाय, कोटा नीति में प्रॉडक्ट कोटा की सेटिंग का रेफ़रंस दिया जा सकता है. यहां कुछ कोटा नीतियों के संदर्भ में प्रॉडक्ट पर कोटा सेट करने के फ़ायदे:

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

किसी एपीआई प्रॉडक्ट से कोटा सेटिंग का इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, "डाइनैमिक कोटा" देखें ऊपर उदाहरण दिया गया है..

एपीआई प्रॉडक्ट के लिए कोटा की सीमाओं को कॉन्फ़िगर करने के बारे में जानकारी पाने के लिए, एपीआई प्रॉडक्ट बनाएं पर जाएं.

एलिमेंट का रेफ़रंस

यहां ऐसे एलिमेंट और एट्रिब्यूट दिए गए हैं जिन्हें इस नीति पर कॉन्फ़िगर किया जा सकता है. ध्यान दें कि कुछ कॉम्बिनेशन अलग-अलग होते हैं या फिर ज़रूरी नहीं होते. खास तरह के इस्तेमाल के लिए सैंपल देखें. कॉन्टेंट बनाने नीचे दिए गए verifyapikey.VerifyAPIKey.apiproduct.* वैरिएबल, डिफ़ॉल्ट रूप से तब उपलब्ध होते हैं, जब पुष्टि करें कि एपीआई पासकोड की नीति "VerifyAPIKey" के बारे में है का इस्तेमाल, अनुरोध में ऐप्लिकेशन के एपीआई पासकोड की जांच करने के लिए किया जाता है. वैरिएबल की वैल्यू, उस एपीआई प्रॉडक्ट की कोटा सेटिंग से मिलती हैं जिससे कुंजी जुड़ी हुई है के साथ, जैसा कि एपीआई प्रॉडक्ट से कोटा सेटिंग पाना कॉन्फ़िगरेशन.

<Quota async="false" continueOnError="false" enabled="true" name="Quota-3" type="calendar">
   <DisplayName>Quota 3</DisplayName>
   <Allow count="2000" countRef="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.limit"/>
   <Allow>
      <Class ref="request.queryparam.time_variable">
        <Allow class="peak_time" count="5000"/>
        <Allow class="off_peak_time" count="1000"/>
      </Class>
   </Allow>
   <Interval ref="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.interval">1</Interval> 
   <TimeUnit ref="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.timeunit">month</TimeUnit>
   <StartTime>2017-7-16 12:00:00</StartTime> 
   <Distributed>false</Distributed> 
   <Synchronous>false</Synchronous> 
   <AsynchronousConfiguration> 
      <SyncIntervalInSeconds>20</SyncIntervalInSeconds> 
      <SyncMessageCount>5</SyncMessageCount> 
   </AsynchronousConfiguration> 
   <Identifier/> 
   <MessageWeight/> 
</Quota>

<Quota> एट्रिब्यूट

<Quota async="false" continueOnError="false" enabled="true" name="Quota-3" type="calendar">

खास तौर पर, यहां दिए गए एट्रिब्यूट इस नीति के लिए हैं.

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

<DisplayName> एलिमेंट

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

<DisplayName>Policy Display Name</DisplayName>

<Allow> एलिमेंट

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

<Allow> एलिमेंट को सेट करने के तीन तरीके नीचे दिए गए हैं:

<Allow count="2000"/> 

<Allow countRef="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.limit"/> 

<Allow count="2000" countRef="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.limit"/> 

अगर count और countRef, दोनों का डेटा डाला जाता है, तो countRef को प्राथमिकता मिलती है. यदि रनटाइम के दौरान countRef का समाधान नहीं होता है, तो count का इस्तेमाल किया गया है.

विशेषताएं

<Allow>/<Class> एलिमेंट

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

<Class> एलिमेंट का इस्तेमाल करने के लिए, फ़्लो वैरिएबल सेट करें. इसके लिए, <Class> टैग के लिए ref एट्रिब्यूट. इसके बाद Edge फ़्लो वैरिएबल, <Allow> चाइल्ड टैग में से किसी एक को चुनने के लिए की संख्या. एज, फ़्लो वैरिएबल की वैल्यू से class से मेल खाता है <Allow> टैग की विशेषता के बारे में बताएंगे, जैसा कि नीचे दिखाया गया है:

<Allow>
  <Class ref="request.queryparam.time_variable">
    <Allow class="peak_time" count="5000"/>
    <Allow class="off_peak_time" count="1000"/>
  </Class>
</Allow>

इस उदाहरण में, मौजूदा कोटा काउंटर का मान हर अनुरोध के साथ time_variable क्वेरी पैरामीटर पास किया गया. उस वैरिएबल का कोई मान हो सकता है peak_time या off_peak_time में से. यदि क्वेरी पैरामीटर में कोई अमान्य है वैल्यू को शामिल करने पर, नीति कोटा उल्लंघन की गड़बड़ी दिखाती है.

विशेषताएं

<Allow>/<Class>/<Allow> एलिमेंट

<Allow> एलिमेंट, कोटा काउंटर की सीमा बताता है <Class> एलिमेंट से तय होता है. हर एक के लिए <Class> के अलग-अलग <Allow> चाइल्ड टैग, नीति के लिए दूसरा काउंटर बनाया जा रहा है.

उदाहरण के लिए:

<Allow>
  <Class ref="request.queryparam.time_variable">
    <Allow class="peak_time" count="5000"/>
    <Allow class="off_peak_time" count="1000"/>
  </Class>
</Allow>

इस उदाहरण में, कोटा की नीति में दो कोटे काउंटर हैं peak_time और off_peak_time महीने में से.

विशेषताएं

<Interval> एलिमेंट

वैल्यू के तौर पर, 1, 2, 5, 60 वगैरह जैसे पूर्णांक का इस्तेमाल करें. समय तय करने के लिए, आप TimeUnit (मिनट, घंटा, दिन, हफ़्ता या महीना) तय करते हैं वह अवधि जिसके दौरान Edge कोटा इस्तेमाल की गणना करता है.

उदाहरण के लिए, 24 का Interval, hour के TimeUnit का मतलब है कि कोटा का आकलन 24 घंटे में किया जाता है.

<Interval ref="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.interval">1</Interval>

विशेषताएं

<TimeUnit> एलिमेंट

कोटा पर लागू समय की इकाई तय करने के लिए इसका इस्तेमाल करें.

उदाहरण के लिए, 24 का Interval, hour के TimeUnit का मतलब है कि कोटा का आकलन 24 घंटे में किया जाता है.

<TimeUnit ref="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.timeunit">month</TimeUnit>

विशेषताएं

<StartTime> एलिमेंट

जब type को calendar, पर सेट किया जाता है, तो तारीख का पता चलता है और वह समय जब कोटा काउंटर की गिनती शुरू होगी, भले ही कोई अनुरोध हुआ हो भी मिलता है.

अगर type को साफ़ तौर पर सेट किया गया है, तो आपको एक खास StartTime देना होगा को calendar, तक आप किसी फ़्लो वैरिएबल के रेफ़रंस का इस्तेमाल नहीं कर सकते, अगर आपने जब कोई type मान सेट नहीं होता है, तो StartTime मान सेट होता है, फिर आपको गड़बड़ी.

उदाहरण के लिए:

<StartTime>2017-7-16 12:00:00</StartTime>

<डिस्ट्रिब्यूटेड> एलिमेंट

Edge को इंस्टॉल करने पर, अनुरोधों को प्रोसेस करने के लिए एक या एक से ज़्यादा मैसेज प्रोसेसर का इस्तेमाल किया जा सकता है. इसे सेट करें true एलिमेंट का इस्तेमाल करें, ताकि यह बताया जा सके कि नीति के तहत एक सेंट्रल और इसे सभी मैसेज प्रोसेसर में लगातार सिंक करते रहें. मैसेज प्रोसेस करने वाली कंपनी उपलब्धता ज़ोन और/या क्षेत्रों में हो सकती है.

अगर आप false की डिफ़ॉल्ट वैल्यू का इस्तेमाल करते हैं, तो हो सकता है कि आप कोटा को पार कर जाएं, क्योंकि मैसेज प्रोसेसर के लिए, मैसेज की संख्या शेयर नहीं की जाती:

<Distributed>true</Distributed>

काउंटर को सिंक करने और हर अनुरोध पर उसे अपडेट करने की गारंटी के लिए, <Distributed> और <Synchronous> को 'सही' के तौर पर सेट करें:

<Distributed>true</Distributed>
<Synchronous>true</Synchronous>

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

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

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

डिफ़ॉल्ट एसिंक्रोनस अपडेट इंटरवल 10 सेकंड का है. इसका इस्तेमाल करें AsynchronousConfiguration एलिमेंट का इस्तेमाल करके, इस एसिंक्रोनस व्यवहार को कॉन्फ़िगर किया जा सकता है.

<Synchronous>false</Synchronous>

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

यह नीति, डिस्ट्रिब्यूट किए गए कोटा काउंटर के बीच सिंक करने के इंटरवल को कॉन्फ़िगर करती है. ऐसा तब होता है, जब यह नीति लागू होती है कॉन्फ़िगरेशन एलिमेंट <Synchronous> या तो मौजूद नहीं है या मौजूद नहीं है. साथ ही, यह सेट है false तक.

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

<AsynchronousConfiguration>
   <SyncIntervalInSeconds>20</SyncIntervalInSeconds>
</AsynchronousConfiguration>

या

<AsynchronousConfiguration>
   <SyncMessageCount>5</SyncMessageCount>
</AsynchronousConfiguration>

&lt;AsynchronousConfiguration&gt;/&lt;SyncIntervalInSeconds&gt; एलिमेंट

इसका इस्तेमाल उस डिफ़ॉल्ट व्यवहार को ओवरराइड करने के लिए करें जिसमें 10 सेकंड का इंटरवल है.

<AsynchronousConfiguration>
   <SyncIntervalInSeconds>20</SyncIntervalInSeconds>
</AsynchronousConfiguration>

सिंक इंटरवल की अवधि 10 सेकंड से ज़्यादा होनी चाहिए, जैसा कि सीमाएं विषय.

&lt;AsynchronousConfiguration&gt;/&lt;SyncMessageCount&gt; एलिमेंट

यह नीति, कोटे के बीच सभी Apigee मैसेज प्रोसेसर में अनुरोधों की संख्या तय करती है अपडेट.

<AsynchronousConfiguration>
   <SyncMessageCount>5</SyncMessageCount>
</AsynchronousConfiguration>

इस उदाहरण से पता चलता है कि हर Apigee के लिए कोटा की संख्या, हर पांच अनुरोध पर अपडेट की जाती है Edge मैसेज प्रोसेसर.

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

यूनीक बनाने के लिए नीति को कॉन्फ़िगर करने के लिए, <Identifier> एलिमेंट का इस्तेमाल करें की गणना कर सकते हैं.

अगर इस एलिमेंट का इस्तेमाल नहीं किया जाता, तो यह नीति तय करना है.

इस एलिमेंट के बारे में, नीचे दी गई Apigee कम्यूनिटी पोस्ट में भी जानकारी दी गई है: http://community.apigee.com/questions/2807/how-does-the-edge-quota-policy-work-when-no-identi.html.

<Identifier ref="verifyapikey.verify-api-key.client_id"/>

विशेषताएं

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

हर मैसेज को असाइन किया गया वज़न बताने के लिए इसका इस्तेमाल करें. संदेश का महत्व बढ़ाने के लिए इसका उपयोग करें उदाहरण के लिए, अन्य लोगों की तुलना में ज़्यादा कंप्यूटेशनल रिसॉर्स इस्तेमाल करने का अनुरोध करने वाले मैसेज.

उदाहरण के लिए, अगर आपको पीओएसटी मैसेज को "भारी" के तौर पर दो बार गिनना है या महंगा, जैसा कि GET मैसेज. इसलिए, आप किसी पीओएसटी के लिए MessageWeight को 2 और डाउनलोड करें. आपके पास MessageWeight को 0 पर सेट करने का भी विकल्प होता है. इससे अनुरोध पर कोई कार्रवाई नहीं की जाती का असर नहीं पड़ता. इस उदाहरण में, अगर कोटा 10 मैसेज प्रति मिनट है और पीओएसटी अनुरोधों के लिए MessageWeight 2 है, तो कोटा किसी भी 10 मिनट के अंतराल में 5 पोस्ट अनुरोधों की अनुमति देता है. कोई अन्य अनुरोध, पीओएसटी या जीईटी, आपके पास इस विकल्प को चुनने का विकल्प होता है.

MessageWeight को दिखाने वाली वैल्यू, फ़्लो के ज़रिए तय की जानी चाहिए वैरिएबल होता है. इसे एचटीटीपी हेडर, क्वेरी पैरामीटर, एक्सएमएल या JSON अनुरोध से भी लिया जा सकता है पेलोड या किसी अन्य फ़्लो वैरिएबल का इस्तेमाल किया जा सकता है. उदाहरण के लिए, आप इसे weight:

<MessageWeight ref="message_weight"/>

फ़्लो वैरिएबल

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

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

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.

Deployment errors

Fault variables

These variables are set when this policy triggers an error. For more information, see What you need to know about policy errors.

Example error response

{  
   "fault":{  
      "detail":{  
         "errorcode":"policies.ratelimit.QuotaViolation"
      },
      "faultstring":"Rate limit quota violation. Quota limit  exceeded. Identifier : _default"
   }
}

Example fault rule

<FaultRules>
    <FaultRule name="Quota Errors">
        <Step>
            <Name>JavaScript-1</Name>
            <Condition>(fault.name Matches "QuotaViolation") </Condition>
        </Step>
        <Condition>ratelimit.Quota-1.failed=true</Condition>
    </FaultRule>
</FaultRules>

स्कीमा

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

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

SpikeArrest नीति

तुलना करना कोटा, स्पाइक अरेस्ट, और एक साथ दर की सीमा से जुड़ी नीतियां