কোটা নীতি

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশনে যান । তথ্য

কি

একটি এপিআই প্রক্সি একটি নির্দিষ্ট সময়ের জন্য, যেমন একটি মিনিট, ঘন্টা, দিন, সপ্তাহ বা মাস অনুমতি দেয় এমন অনুরোধ বার্তাগুলির সংখ্যা কনফিগার করতে কোটা নীতি ব্যবহার করুন৷ আপনি API প্রক্সি অ্যাক্সেস করা সমস্ত অ্যাপের জন্য কোটা একই হতে সেট করতে পারেন, অথবা আপনি এর উপর ভিত্তি করে কোটা সেট করতে পারেন:

• যে পণ্যটিতে API প্রক্সি রয়েছে
• অ্যাপটি এপিআই অনুরোধ করছে
• অ্যাপ ডেভেলপার
• অন্যান্য অনেক মানদণ্ড

সামগ্রিক ট্রাফিক স্পাইক থেকে রক্ষা পেতে কোটা ব্যবহার করবেন না। এর জন্য, স্পাইক অ্যারেস্ট নীতি ব্যবহার করুন। স্পাইক অ্যারেস্ট নীতি দেখুন।

ভিডিও

এই ভিডিওগুলি কোটা নীতির সাথে কোটা ব্যবস্থাপনার পরিচয় দেয়:

নমুনা

এই নীতি কোড নমুনাগুলি কীভাবে কোটা সময়কাল শুরু এবং শেষ করতে হয় তা ব্যাখ্যা করে:

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

কোটা নীতি সম্পর্কে ড

একটি কোটা হল অনুরোধ বার্তাগুলির একটি বরাদ্দ যা একটি API প্রক্সি একটি নির্দিষ্ট সময়ের মধ্যে পরিচালনা করতে পারে, যেমন মিনিট, ঘন্টা, দিন, সপ্তাহ বা মাস৷ নীতিটি এমন কাউন্টারগুলি বজায় রাখে যেগুলি API প্রক্সি দ্বারা প্রাপ্ত অনুরোধের সংখ্যাকে গণনা করে৷ এই ক্ষমতা API প্রদানকারীদের একটি সময়ের ব্যবধানে অ্যাপ দ্বারা করা API কলের সংখ্যার উপর সীমা কার্যকর করতে সক্ষম করে। কোটা নীতিগুলি ব্যবহার করে আপনি, উদাহরণস্বরূপ, অ্যাপগুলিকে প্রতি মিনিটে 1টি অনুরোধের মধ্যে বা প্রতি মাসে 10,000 অনুরোধের মধ্যে সীমাবদ্ধ করতে পারেন৷

উদাহরণস্বরূপ, যদি একটি কোটা প্রতি মাসে 10,000 বার্তা হিসাবে সংজ্ঞায়িত করা হয়, 10,000 তম বার্তার পরে হার-সীমাবদ্ধতা শুরু হয়৷ 10,000 বার্তা সেই সময়ের প্রথম দিনে বা শেষ দিনে গণনা করা হয়েছিল তা বিবেচ্য নয়; নির্দিষ্ট সময়ের ব্যবধানের শেষে কোটা কাউন্টার স্বয়ংক্রিয়ভাবে রিসেট না হওয়া পর্যন্ত বা কোটা রিসেট কোটা নীতি ব্যবহার করে স্পষ্টভাবে রিসেট না হওয়া পর্যন্ত কোনো অতিরিক্ত অনুরোধের ক্ষেত্র অনুমোদিত নয়।

স্পাইকআরেস্ট নামক কোটার একটি ভিন্নতা ট্রাফিক স্পাইক (বা বিস্ফোরণ) প্রতিরোধ করে যা ব্যবহারে হঠাৎ বৃদ্ধি, বগি ক্লায়েন্ট বা দূষিত আক্রমণের কারণে হতে পারে। স্পাইক অ্যারেস্ট সম্পর্কে আরও তথ্যের জন্য, স্পাইক অ্যারেস্ট নীতি দেখুন।

কোটা পৃথক API প্রক্সিগুলিতে প্রযোজ্য এবং API প্রক্সিগুলির মধ্যে বিতরণ করা হয় না। উদাহরণস্বরূপ, যদি আপনার একটি API পণ্যে তিনটি API প্রক্সি থাকে, তবে তিনটিই একই কোটা নীতি কনফিগারেশন ব্যবহার করলেও তিনটিতে একটি একক কোটা ভাগ করা হয় না৷

কোটা নীতির ধরন

কোটা নীতি বিভিন্ন ধরনের নীতি সমর্থন করে: ডিফল্ট, calendar , flexi এবং rollingwindow । প্রতিটি প্রকার নির্ধারণ করে কখন কোটা কাউন্টার শুরু হয় এবং কখন এটি পুনরায় সেট হয়, যেমনটি নিম্নলিখিত টেবিলে দেখানো হয়েছে:

type="calendar" এর জন্য, আপনাকে অবশ্যই <StartTime> -এর মান নির্দিষ্ট করতে হবে।

টেবিলটি rollingwindow প্রকারের মান তালিকাভুক্ত করে না। রোলিং উইন্ডো কোটা একটি কোটার আকার "উইন্ডো" সেট করে কাজ করে, যেমন এক ঘন্টা বা একদিনের উইন্ডো। যখন একটি নতুন অনুরোধ আসে, নীতি নির্ধারণ করে যে কোটাটি সময়ের অতীত "উইন্ডো" অতিক্রম করেছে কিনা।

উদাহরণস্বরূপ, আপনি একটি দুই ঘন্টার উইন্ডো সংজ্ঞায়িত করেন যা 1000টি অনুরোধের অনুমতি দেয়। বিকাল ৪:৪৫ মিনিটে একটি নতুন অনুরোধ আসে। নীতি গত দুই ঘণ্টার উইন্ডোর কোটা গণনা করে, মানে 2:45 PM থেকে অনুরোধের সংখ্যা। সেই দুই ঘণ্টার উইন্ডোতে যদি কোটার সীমা অতিক্রম না করা হয়, তাহলে অনুরোধটি অনুমোদিত।

এক মিনিট পরে, 4:46 PM-এ, আরেকটি অনুরোধ আসে। এখন নীতিটি সীমা অতিক্রম করেছে কিনা তা নির্ধারণ করতে 2:46 PM থেকে কোটা গণনা করে।

rollingwindow টাইপের জন্য, কাউন্টারটি কখনই রিসেট হয় না, তবে প্রতিটি অনুরোধে পুনরায় গণনা করা হয়।

কোটা কাউন্টার বোঝা

ডিফল্টরূপে, একটি কোটা নীতি একটি একক কাউন্টার বজায় রাখে, আপনি এটিকে একটি API প্রক্সিতে কতবার উল্লেখ করুন না কেন। কোটা কাউন্টারের নাম নীতির name বৈশিষ্ট্যের উপর ভিত্তি করে।

উদাহরণস্বরূপ, আপনি 5টি অনুরোধের সীমা সহ MyQuotaPolicy নামে একটি কোটা নীতি তৈরি করুন এবং API প্রক্সিতে এটিকে একাধিক ফ্লোতে (ফ্লো A, B, এবং C) রাখুন৷ যদিও এটি একাধিক প্রবাহে ব্যবহৃত হয়, এটি একটি একক কাউন্টার বজায় রাখে যা নীতির সমস্ত দৃষ্টান্ত দ্বারা আপডেট করা হয়:

• ফ্লো A কার্যকর করা হয়েছে -> MyQuotaPolicy কার্যকর করা হয়েছে এবং এর কাউন্টার = 1
• ফ্লো বি কার্যকর করা হয়েছে -> MyQuotaPolicy কার্যকর করা হয়েছে এবং এর কাউন্টার = 2
• ফ্লো A কার্যকর করা হয়েছে -> MyQuotaPolicy কার্যকর করা হয়েছে এবং এর কাউন্টার = 3
• ফ্লো সি কার্যকর করা হয়েছে -> MyQuotaPolicy কার্যকর করা হয়েছে এবং এর কাউন্টার = 4
• ফ্লো A কার্যকর করা হয়েছে -> MyQuotaPolicy কার্যকর করা হয়েছে এবং এর কাউন্টার = 5

তিনটি প্রবাহের যেকোনো একটির পরবর্তী অনুরোধ প্রত্যাখ্যান করা হয়েছে কারণ কোটা কাউন্টার তার সীমাতে পৌঁছেছে।

একটি API প্রক্সি ফ্লোতে একাধিক জায়গায় একই কোটা নীতি ব্যবহার করা, যা অনিচ্ছাকৃতভাবে কোটা আপনার প্রত্যাশার চেয়ে দ্রুত ফুরিয়ে যেতে পারে, এটি The Book of Apigee Edge Antipatterns- এ বর্ণিত একটি অ্যান্টি-প্যাটার্ন।

বিকল্পভাবে, আপনি আপনার API প্রক্সিতে একাধিক কোটা নীতি নির্ধারণ করতে পারেন এবং প্রতিটি প্রবাহে একটি ভিন্ন নীতি ব্যবহার করতে পারেন। প্রতিটি কোটা নীতি নীতির name বৈশিষ্ট্যের উপর ভিত্তি করে তার নিজস্ব কাউন্টার বজায় রাখে।

অথবা, একটি একক নীতিতে একাধিক, অনন্য কাউন্টার সংজ্ঞায়িত করতে কোটা নীতিতে <Class> বা <Identifier> উপাদানগুলি ব্যবহার করুন। এই উপাদানগুলি ব্যবহার করে, একটি একক নীতি অ্যাপ অনুরোধ করছে, অ্যাপ বিকাশকারী অনুরোধ করছে, একটি ক্লায়েন্ট আইডি বা অন্যান্য ক্লায়েন্ট শনাক্তকারী এবং আরও অনেক কিছুর উপর ভিত্তি করে বিভিন্ন কাউন্টার বজায় রাখতে পারে। <Class> শ্রেণী> বা <Identifier> উপাদানগুলি ব্যবহার করার বিষয়ে আরও তথ্যের জন্য উপরের উদাহরণগুলি দেখুন।

সময়ের স্বরলিপি

সমস্ত কোটা সময় সমন্বিত ইউনিভার্সাল টাইম (UTC) সময় অঞ্চলে সেট করা আছে।

কোটা টাইম নোটেশন ইন্টারন্যাশনাল স্ট্যান্ডার্ড 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 । পরেরটি সাধারণত পছন্দের স্বরলিপি।

API পণ্য কনফিগারেশন থেকে কোটা সেটিংস পাওয়া

আপনি API পণ্য কনফিগারেশনে কোটা সীমা সেট করতে পারেন। এই সীমাগুলি স্বয়ংক্রিয়ভাবে কোটা প্রয়োগ করে না। পরিবর্তে, আপনি একটি কোটা নীতিতে পণ্য কোটা সেটিংস উল্লেখ করতে পারেন। রেফারেন্সের জন্য কোটা নীতির জন্য পণ্যের উপর একটি কোটা সেট করার কিছু সুবিধা এখানে রয়েছে:

• কোটা নীতিগুলি API পণ্যের সমস্ত API প্রক্সি জুড়ে একটি অভিন্ন সেটিং ব্যবহার করতে পারে৷
• আপনি একটি API পণ্যের কোটা সেটিংয়ে রানটাইম পরিবর্তন করতে পারেন, এবং কোটা নীতিগুলি যা মান উল্লেখ করে সেগুলি স্বয়ংক্রিয়ভাবে কোটা মান আপডেট করে।

একটি API পণ্য থেকে কোটা সেটিংস ব্যবহার করার বিষয়ে আরও তথ্যের জন্য, উপরের "ডাইনামিক কোটা" উদাহরণটি দেখুন৷ .

কোটা সীমা সহ API পণ্য কনফিগার করার তথ্যের জন্য, API পণ্য তৈরি করুন দেখুন।

উপাদান রেফারেন্স

নিম্নলিখিত উপাদান এবং বৈশিষ্ট্যগুলি আপনি এই নীতিতে কনফিগার করতে পারেন৷ মনে রাখবেন যে কিছু উপাদান সমন্বয় পারস্পরিক একচেটিয়া বা প্রয়োজন হয় না। নির্দিষ্ট ব্যবহারের জন্য নমুনা দেখুন. verifyapikey.VerifyAPIKey.apiproduct.* নীচের ভেরিয়েবলগুলি ডিফল্টরূপে উপলব্ধ থাকে যখন "VerifyAPIKey" নামক একটি যাচাই API কী নীতি অনুরোধে অ্যাপের API কী পরীক্ষা করতে ব্যবহার করা হয়৷ পরিবর্তনশীল মানগুলি API পণ্যের কোটা সেটিংস থেকে আসে যার সাথে কী যুক্ত থাকে, যেমন API পণ্য কনফিগারেশন থেকে কোটা সেটিংস পাওয়াতে বর্ণিত হয়েছে।

<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 async="false" continueOnError="false" enabled="true" name="Quota-3" type="calendar">

নিম্নলিখিত গুণাবলী এই নীতি নির্দিষ্ট.

নিম্নলিখিত সারণী সমস্ত নীতির মূল উপাদানগুলির জন্য সাধারণ বৈশিষ্ট্যগুলি বর্ণনা করে:

<DisplayName> উপাদান

ম্যানেজমেন্ট UI প্রক্সি এডিটরে নীতিটিকে একটি ভিন্ন, প্রাকৃতিক-ভাষা নামের সাথে লেবেল করতে name বৈশিষ্ট্য ছাড়াও ব্যবহার করুন।

<DisplayName>Policy Display Name</DisplayName>

<অনুমতি> উপাদান

কোটার জন্য গণনার সীমা নির্দিষ্ট করে। যদি পলিসির কাউন্টার এই সীমা মান পর্যন্ত পৌঁছায়, তাহলে কাউন্টার রিসেট না হওয়া পর্যন্ত পরবর্তী কলগুলি প্রত্যাখ্যান করা হয়।

<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 মান ব্যবহার করা হয়।

গুণাবলী

<অনুমতি>/<ক্লাস> উপাদান

<Class> উপাদানটি আপনাকে একটি ফ্লো ভেরিয়েবলের মানের উপর ভিত্তি করে <Allow> উপাদানটির মান শর্তযুক্ত করতে দেয়। <Class> -এর প্রতিটি আলাদা <Allow> চাইল্ড ট্যাগের জন্য, নীতি আলাদা কাউন্টার বজায় রাখে।

<Class> এলিমেন্ট ব্যবহার করতে, <Class> ট্যাগের ref এট্রিবিউট ব্যবহার করে একটি ফ্লো ভেরিয়েবল নির্দিষ্ট করুন। নীতির অনুমোদিত গণনা নির্ধারণ করতে এজ তারপর <Allow> চাইল্ড ট্যাগগুলির একটি নির্বাচন করতে ফ্লো ভেরিয়েবলের মান ব্যবহার করে। এজ ফ্লো ভেরিয়েবলের মান <Allow> ট্যাগের class অ্যাট্রিবিউটের সাথে মেলে, যেমনটি নীচে দেখানো হয়েছে:

<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> উপাদান দ্বারা সংজ্ঞায়িত একটি কোটা কাউন্টারের সীমা নির্দিষ্ট করে। <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 নামে দুটি কোটা কাউন্টার বজায় রাখে।

গুণাবলী

<ব্যবধান> উপাদান

একটি পূর্ণসংখ্যা নির্দিষ্ট করতে ব্যবহার করুন (উদাহরণস্বরূপ, 1, 2, 5, 60, এবং আরও) যা আপনার নির্দিষ্ট করা TimeUnit (মিনিট, ঘন্টা, দিন, সপ্তাহ বা মাস) এর সাথে যুক্ত করা হবে একটি সময়কাল নির্ধারণ করার জন্য যেটি এজ কোটা ব্যবহার গণনা করে।

উদাহরণস্বরূপ, hour একটি TimeUnit সহ 24 এর একটি Interval অর্থ হল কোটাটি 24 ঘন্টার মধ্যে গণনা করা হবে।

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

গুণাবলী

<TimeUnit> উপাদান

কোটার জন্য প্রযোজ্য সময়ের একক উল্লেখ করতে ব্যবহার করুন।

উদাহরণস্বরূপ, hour একটি TimeUnit সহ 24 এর একটি Interval অর্থ হল কোটাটি 24 ঘন্টার মধ্যে গণনা করা হবে।

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

গুণাবলী

<StartTime> উপাদান

যখন type calendar, তখন তারিখ এবং সময় নির্দিষ্ট করে যখন কোটা কাউন্টার গণনা শুরু করবে, কোনো অ্যাপ থেকে কোনো অনুরোধ গৃহীত হয়েছে কিনা তা নির্বিশেষে।

ক্যালেন্ডারে type স্পষ্টভাবে সেট করা হলে আপনাকে অবশ্যই একটি স্পষ্ট StartTime প্রদান করতে হবে calendar, আপনি একটি ফ্লো ভেরিয়েবলের একটি রেফারেন্স ব্যবহার করতে পারবেন না, যদি আপনি একটি StartTime মান নির্দিষ্ট করেন যখন কোনো type মান সেট না থাকে, তাহলে আপনি একটি ত্রুটি পাবেন।

যেমন:

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

<ডিস্ট্রিবিউটেড> উপাদান

এজ এর ইনস্টলেশন অনুরোধগুলি প্রক্রিয়া করতে এক বা একাধিক বার্তা প্রসেসর ব্যবহার করতে পারে। নীতির একটি কেন্দ্রীয় কাউন্টার বজায় রাখা এবং সমস্ত বার্তা প্রসেসর জুড়ে ক্রমাগত সিঙ্ক্রোনাইজ করা উচিত তা নির্দিষ্ট করতে এই উপাদানটিকে true সেট করুন৷ বার্তা প্রসেসরগুলি প্রাপ্যতা অঞ্চল এবং/অথবা অঞ্চল জুড়ে হতে পারে।

আপনি যদি false এর ডিফল্ট মান ব্যবহার করেন, তাহলে আপনি আপনার কোটা অতিক্রম করতে পারেন কারণ প্রতিটি বার্তা প্রসেসরের গণনা ভাগ করা হয় না:

<Distributed>true</Distributed>

কাউন্টারগুলি সিঙ্ক্রোনাইজ করা হয়েছে এবং প্রতিটি অনুরোধে আপডেট করা হয়েছে তার নিশ্চয়তা দিতে, <Distributed> এবং <Synchronous> সত্যে সেট করুন:

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

<সিঙ্ক্রোনাস> উপাদান

সিঙ্ক্রোনাসভাবে বিতরণ করা কোটা কাউন্টার আপডেট করতে true সেট করুন। এর মানে হল যে কাউন্টারে আপডেট করা হয় একই সময়ে কোটা চেক করা হয় API-এর অনুরোধে। true সেট করুন যদি এটি অপরিহার্য হয় যে আপনি কোটার উপর কোনো API কলের অনুমতি দেবেন না।

অ্যাসিঙ্ক্রোনাসভাবে কোটা কাউন্টার আপডেট করতে false সেট করুন। এর মানে হল যে কেন্দ্রীয় সংগ্রহস্থলের কোটা কাউন্টারটি অ্যাসিঙ্ক্রোনাসভাবে আপডেট করা হয় তার উপর নির্ভর করে কোটা অতিক্রম করা কিছু API কল করা সম্ভব। যাইহোক, আপনি সিঙ্ক্রোনাস আপডেটের সাথে সম্পর্কিত সম্ভাব্য কর্মক্ষমতা প্রভাবের সম্মুখীন হবেন না।

ডিফল্ট অ্যাসিঙ্ক্রোনাস আপডেটের ব্যবধান 10 সেকেন্ড। এই অ্যাসিঙ্ক্রোনাস আচরণ কনফিগার করতে AsynchronousConfiguration উপাদান ব্যবহার করুন।

<Synchronous>false</Synchronous>

<অ্যাসিনক্রোনাস কনফিগারেশন> উপাদান

যখন নীতি কনফিগারেশন উপাদান <Synchronous> হয় উপস্থিত না থাকে বা উপস্থিত থাকে এবং false সেট থাকে তখন বিতরণ করা কোটা কাউন্টারগুলির মধ্যে সিঙ্ক্রোনাইজেশন ব্যবধান কনফিগার করে।

আপনি SyncIntervalInSeconds বা SyncMessageCount চাইল্ড উপাদানগুলি ব্যবহার করে একটি সময়কাল বা একটি বার্তা গণনার পরে সিঙ্ক্রোনাইজ করতে পারেন৷ তারা পারস্পরিক একচেটিয়া. যেমন,

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

বা

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

<অ্যাসিনক্রোনাস কনফিগারেশন>/<SyncIntervalInSeconds> উপাদান

ডিফল্ট আচরণকে ওভাররাইড করতে এটি ব্যবহার করুন যেখানে 10 সেকেন্ডের ব্যবধানের পরে অ্যাসিঙ্ক্রোনাস আপডেটগুলি সঞ্চালিত হয়।

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

সিঙ্কের ব্যবধানটি হতে হবে >= 10 সেকেন্ড যেমন সীমা বিষয়ে বর্ণিত হয়েছে।

<অ্যাসিনক্রোনাস কনফিগারেশন>/<SyncMessageCount> উপাদান

কোটা আপডেটের মধ্যে সমস্ত Apigee বার্তা প্রসেসর জুড়ে অনুরোধের সংখ্যা নির্দিষ্ট করে।

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

এই উদাহরণটি উল্লেখ করে যে প্রতিটি Apigee Edge মেসেজ প্রসেসর জুড়ে প্রতি 5টি অনুরোধে কোটা গণনা আপডেট করা হয়।

<আইডেন্টিফায়ার> উপাদান

একটি ফ্লো ভেরিয়েবলের উপর ভিত্তি করে অনন্য কাউন্টার তৈরি করতে নীতি কনফিগার করতে <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"/>

গুণাবলী

<মেসেজওয়েট> উপাদান

প্রতিটি বার্তার জন্য নির্ধারিত ওজন নির্দিষ্ট করতে ব্যবহার করুন। অনুরোধের বার্তাগুলির প্রভাব বাড়ানোর জন্য বার্তার ওজন ব্যবহার করুন যেগুলি, উদাহরণস্বরূপ, অন্যদের তুলনায় বেশি গণনামূলক সংস্থানগুলি ব্যবহার করে৷

উদাহরণস্বরূপ, আপনি POST বার্তাগুলিকে GET বার্তা হিসাবে দ্বিগুণ "ভারী" বা ব্যয়বহুল হিসাবে গণনা করতে চান৷ অতএব, আপনি একটি পোস্টের জন্য MessageWeight 2 এবং একটি GET-এর জন্য 1 সেট করুন৷ এমনকি আপনি MessageWeight 0 এ সেট করতে পারেন যাতে অনুরোধটি কাউন্টারকে প্রভাবিত না করে। এই উদাহরণে, যদি কোটা হয় 10টি বার্তা প্রতি মিনিটে এবং POST অনুরোধের জন্য MessageWeight 2 হয়, তাহলে কোটা 10 মিনিটের ব্যবধানে 5টি POST অনুরোধের অনুমতি দেবে৷ কাউন্টার রিসেট প্রত্যাখ্যান করার আগে কোনো অতিরিক্ত অনুরোধ, পোস্ট করুন বা GET করুন।

MessageWeight প্রতিনিধিত্বকারী একটি মান অবশ্যই একটি ফ্লো ভেরিয়েবল দ্বারা নির্দিষ্ট করা উচিত এবং HTTP শিরোনাম, ক্যোয়ারী প্যারামিটার, একটি XML বা JSON অনুরোধ পেলোড বা অন্য কোনো ফ্লো ভেরিয়েবল থেকে বের করা যেতে পারে। উদাহরণস্বরূপ, আপনি weight নামক একটি শিরোনামে এটি সেট করুন:

<MessageWeight ref="message_weight"/>

ফ্লো ভেরিয়েবল

একটি কোটা নীতি কার্যকর হলে নিম্নলিখিত পূর্বনির্ধারিত ফ্লো ভেরিয়েবলগুলি স্বয়ংক্রিয়ভাবে পপুলেট হয়৷ ফ্লো ভেরিয়েবল সম্পর্কে আরও তথ্যের জন্য, ভেরিয়েবল রেফারেন্স দেখুন।

ত্রুটি উল্লেখ

এই বিভাগটি ফল্ট কোড এবং ত্রুটি বার্তাগুলি বর্ণনা করে যেগুলি ফেরত দেওয়া হয় এবং ত্রুটি ভেরিয়েবলগুলি যেগুলি এজ দ্বারা সেট করা হয় যখন এই নীতিটি একটি ত্রুটি ট্রিগার করে৷ এই তথ্যটি জানা গুরুত্বপূর্ণ যে আপনি ত্রুটিগুলি পরিচালনা করার জন্য ত্রুটির নিয়ম তৈরি করছেন কিনা। আরও জানতে, নীতিগত ত্রুটি এবং হ্যান্ডলিং ফল্ট সম্পর্কে আপনার যা জানা দরকার তা দেখুন৷

রানটাইম ত্রুটি

নীতি কার্যকর করার সময় এই ত্রুটিগুলি ঘটতে পারে৷

স্থাপনার ত্রুটি

ফল্ট ভেরিয়েবল

যখন এই নীতি একটি ত্রুটি ট্রিগার করে তখন এই ভেরিয়েবলগুলি সেট করা হয়৷ আরও তথ্যের জন্য, নীতি ত্রুটি সম্পর্কে আপনার যা জানা দরকার তা দেখুন।

উদাহরণ ত্রুটি প্রতিক্রিয়া

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

উদাহরণ দোষ নিয়ম

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

স্কিমাস

সম্পর্কিত বিষয়

কোটা নীতি রিসেট করুন

স্পাইক অ্যারেস্ট নীতি

কোটা, স্পাইক অ্যারেস্ট, এবং সমসাময়িক হার সীমা নীতির তুলনা করা