কোটা সংক্রান্ত নীতি

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

কী

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

• API প্রক্সি থাকা প্রোডাক্ট
• যে অ্যাপ API-এর জন্য অনুরোধ করছে
• অ্যাপ ডেভেলপার
• আরও অনেক মাপকাঠি

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

<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 কলের সংখ্যার উপর সীমা আরোপ করতে সক্ষম করে। কোটা নীতি ব্যবহার করে আপনি, যেমন প্রতি মিনিটে অ্যাপকে ১টি অনুরোধ বা প্রতি মাসে ১০,০০০টি অনুরোধে সীমাবদ্ধ করতে পারেন।

যেমন, কোটা যদি প্রতি মাসে ১০,০০০ মেসেজ হিসেবে নির্ধারণ করা হয়, তাহলে ১০,০০০তম মেসেজের পরে রেট-লিমিটিং শুরু হয়। প্রথম দিন বা সেই মেয়াদের শেষ দিনে ১০,০০০ মেসেজ গণনা করা হোক না কেন, তাতে কিছু যায় আসে না; নির্দিষ্ট সময়সীমা শেষে কোটা কাউন্টার অটোমেটিক রিসেট না হওয়া পর্যন্ত বা কোটা রিসেট করার নীতি ব্যবহার করে কোটা স্পষ্টভাবে রিসেট না করা পর্যন্ত কোনও অতিরিক্ত অনুরোধ করা যাবে না।

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

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

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

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

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

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

যেমন, আপনি দু'ঘণ্টার একটি উইন্ডো নির্ধারণ করেছেন যা ১০০০টি অনুরোধ গ্রহণ করতে পারে। বিকেল ৪:৪৫-এ একটি নতুন অনুরোধ আসে। নীতিটি গত দুই ঘণ্টার উইন্ডোর জন্য কোটা গণনা করে, অর্থাৎ বিকেল ২:৪৫ থেকে আসা অনুরোধের সংখ্যা। সেই দুই ঘণ্টার সময়সীমার মধ্যে কোটা সীমা অতিক্রম না করে থাকলে, অনুরোধটি অনুমোদিত হবে।

এক মিনিট পরে, বিকেল ৪:৪৬-এ, আরেকটি অনুরোধ আসে। এখন নীতিটি কোটার সংখ্যা গণনা করে দেখবে যে সীমা অতিক্রম করা হয়েছে কিনা। এটি ২:৪৬ PM থেকে গণনা করা শুরু করেছে।

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

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

সাধারণত, কোটা নীতি একটি কাউন্টার বজায় রাখে, আপনি API প্রক্সিতে যতবারই এটি রেফারেন্স করুন না কেন। কোটা কাউন্টারের নাম নীতির name অ্যাট্রিবিউটের উপর ভিত্তি করে তৈরি হয়।

যেমন, আপনি MyQuotaPolicy নামের একটি কোটা নীতি তৈরি করেছেন যাতে ৫টি অনুরোধের সীমা আছে এবং API প্রক্সিতে একাধিক ফ্লোতে (ফ্লো A, B ও C) এটি প্রয়োগ করেছেন। এটি একাধিক ফ্লোতে ব্যবহার করা হলেও, একটি কাউন্টার বজায় রাখে যা নীতির সব ইনস্ট্যান্স আপডেট করে:

• ফ্লো 'ক' এক্সিকিউট করা হয় -> MyQuotaPolicy এক্সিকিউট করা হয় এবং এর কাউন্টার = ১
• ফ্লো 'খ' এক্সিকিউট করা হয় -> MyQuotaPolicy এক্সিকিউট করা হয় এবং এর কাউন্টার = ২
• ফ্লো 'ক' এক্সিকিউট করা হয় -> MyQuotaPolicy এক্সিকিউট করা হয় এবং এর কাউন্টার = ৩
• ফ্লো 'গ' এক্সিকিউট করা হয় -> MyQuotaPolicy এক্সিকিউট করা হয় এবং এর কাউন্টার = ৪
• ফ্লো 'ক' এক্সিকিউট করা হয় -> MyQuotaPolicy এক্সিকিউট করা হয় এবং এর কাউন্টার = ৫

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

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

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

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

সময়ের নোটেশন

সব কোটা টাইম কোঅর্ডিনেটেড ইউনিভার্সাল টাইম (UTC) টাইম জোনে সেট করা আছে।

কোটা টাইম নোটেশন আন্তর্জাতিক স্ট্যান্ডার্ড তারিখ নোটেশন মেনে চলে যা ইন্টারন্যাশনাল স্ট্যান্ডার্ড ISO 8601-এ উল্লেখ করা আছে।

তারিখকে বছর, মাস ও দিন হিসেবে নিম্নলিখিত ফর্ম্যাটে সংজ্ঞায়িত করা হয়: YYYY-MM-DD। যেমন, 2015-02-04 ৪ ফেব্রুয়ারি, ২০১৫ তারিখটি বোঝায়।

দিনের সময়কে নিম্নলিখিত ফর্ম্যাটে ঘণ্টা, মিনিট ও সেকেন্ড হিসেবে দেখানো হয়: 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 প্রোডাক্ট তৈরি করুন দেখুন।

এলিমেন্ট রেফারেন্স

এই নীতিতে আপনি যেসব এলিমেন্ট ও অ্যাট্রিবিউট কনফিগার করতে পারবেন সেগুলি নিচে উল্লেখ করা হল। মনে রাখবেন, কিছু এলিমেন্ট কম্বিনেশন পারস্পরিকভাবে এক্সক্লুসিভ বা প্রয়োজন নেই। নির্দিষ্ট ব্যবহারের জন্য স্যাম্পেল দেখুন। অনুরোধে অ্যাপের API কী চেক করার জন্য "VerifyAPIKey" নামের Verify API Key নীতি ব্যবহার করা হলে, নিচে উল্লেখ করা ভেরিয়েবলগুলি verifyapikey.VerifyAPIKey.apiproduct.* ডিফল্ট হিসেবে উপলভ্য থাকে। কী যে 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> অ্যাট্রিবিউট

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

এই নীতির জন্য নিম্নলিখিত অ্যাট্রিবিউট নির্দিষ্ট করা আছে।

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

<DisplayName> উপাদান

ম্যানেজমেন্ট UI প্রক্সি এডিটরে নীতিটিকে একটি ভিন্ন, প্রাকৃতিক-ভাষা নামের সাথে লেবেল করতে 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> এলিমেন্ট

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

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

<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> এলিমেন্ট দ্বারা সংজ্ঞায়িত কোটা কাউন্টারের সীমা নির্দিষ্ট করে। প্রতিটি আলাদা <Allow> চাইল্ড ট্যাগের <Class> জন্য, নীতি আলাদা আলাদা কাউন্টার বজায় রাখে।

যেমন:

<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> এলিমেন্ট

একটি পূর্ণসংখ্যা (যেমন, ১, ২, ৫, ৬০ ইত্যাদি) নির্দিষ্ট করতে ব্যবহার করুন যা TimeUnitআপনি নির্দিষ্ট করেছেন (মিনিট, ঘণ্টা, দিন, সপ্তাহ বা মাস) তার সাথে পেয়ার করা হবে যাতে একটি সময় সীমা নির্ধারণ করা যায় যার মধ্যে Edge কোটা ব্যবহার গণনা করে।

যেমন, Interval-এর 24-এর সাথে TimeUnit-এর hour-এর অর্থ হল যে কোটা ২৪ ঘণ্টা ধরে হিসেব করা হবে।

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

অ্যাট্রিবিউট

<TimeUnit> এলিমেন্ট

কোটার ক্ষেত্রে প্রযোজ্য সময়ের একক নির্দিষ্ট করতে ব্যবহার করা হয়।

যেমন, Interval-এর 24-এর সাথে TimeUnit-এর hour-এর অর্থ হল যে কোটা ২৪ ঘণ্টা ধরে হিসেব করা হবে।

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

অ্যাট্রিবিউট

<StartTime> এলিমেন্ট

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

যেমন:

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

<Distributed> এলিমেন্ট

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

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

<Distributed>true</Distributed>

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

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

<Synchronous> এলিমেন্ট

ডিস্ট্রিবিউট করা কোটা কাউন্টার সিঙ্ক্রোনাসভাবে আপডেট করতে true-এ সেট করুন। এর অর্থ হল, API-তে কোনও অনুরোধের জন্য কোটা চেক করার সময় একই সাথে কাউন্টার আপডেট করা হয়। কোটা শেষ হয়ে যাওয়ার পরে কোনও API কল করা যাবে না, এটি গুরুত্বপূর্ণ হলে true হিসেবে সেট করুন।

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

অ্যাসিঙ্ক্রোনাস আপডেটের ডিফল্ট ইন্টার্ভেল হল ১০ সেকেন্ড। এই অ্যাসিঙ্ক্রোনাস আচরণ কনফিগার করতে AsynchronousConfiguration এলিমেন্ট ব্যবহার করুন।

<Synchronous>false</Synchronous>

<AsynchronousConfiguration> এলিমেন্ট

নীতি কনফিগারেশন এলিমেন্ট <Synchronous> না থাকলে অথবা থাকলে এবং false হিসেবে সেট করা থাকলে, ডিস্ট্রিবিউট করা কোটা কাউন্টারগুলির মধ্যে সিঙ্ক্রোনাইজেশন ইন্টারভ্যাল কনফিগার করে।

আপনি SyncIntervalInSeconds বা SyncMessageCount চাইল্ড এলিমেন্ট ব্যবহার করে নির্দিষ্ট সময়সীমা বা মেসেজের সংখ্যার পরে সিঙ্ক্রোনাইজ করতে পারবেন। এগুলি পারস্পরিকভাবে এক্সক্লুসিভ। যেমন,

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

অথবা

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

<AsynchronousConfiguration>/<SyncIntervalInSeconds> এলিমেন্ট

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

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

সিঙ্ক ইন্টারভ্যাল অবশ্যই ১০ সেকেন্ডের বেশি হতে হবে, যা সীমা টপিকে বর্ণনা করা আছে।

<AsynchronousConfiguration>/<SyncMessageCount> এলিমেন্ট

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

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

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

<Identifier> এলিমেন্ট

ফ্লো ভেরিয়েবলের উপর ভিত্তি করে অনন্য কাউন্টার তৈরি করতে, নীতি কনফিগার করার জন্য <Identifier> এলিমেন্ট ব্যবহার করুন।

আপনি এই এলিমেন্ট ব্যবহার না করলে, নীতি একটি কাউন্টার ব্যবহার করে যা কোটার বিরুদ্ধে প্রয়োগ করা হয়।

এই এলিমেন্টটি নিম্নলিখিত Apigee কমিউনিটি পোস্টেও আলোচনা করা হয়েছে: বিভিন্ন নীতি জুড়ে কোটা শনাক্তকারী।

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

অ্যাট্রিবিউট

<MessageWeight> এলিমেন্ট

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

যেমন, আপনি POST মেসেজকে GET মেসেজের তুলনায় দ্বিগুণ "ভারী" বা দামি হিসেবে গণনা করতে চান। তাই, POST-এর জন্য MessageWeight-এর মান ২ এবং GET-এর জন্য ১ সেট করুন। এমনকি, আপনি MessageWeight-এর মান ০ হিসেবে সেট করতে পারেন, যাতে অনুরোধটি কাউন্টারে প্রভাব না ফেলে। এই উদাহরণে, কোটা যদি প্রতি মিনিটে ১০টি মেসেজ হয় এবং POST অনুরোধের জন্য MessageWeight হল 2, তাহলে কোটা যেকোনও ১০ মিনিটের ব্যবধানে ৫টি POST অনুরোধের অনুমতি দেবে। কাউন্টার রিসেট করার আগে কোনও অতিরিক্ত অনুরোধ, POST বা GET, প্রত্যাখ্যান করা হয়।

MessageWeight-এর মান ফ্লো ভেরিয়েবল দ্বারা নির্দিষ্ট করতে হবে এবং HTTP হেডার, কোয়েরি প্যারামিটার, XML বা JSON অনুরোধ পে-লোড বা অন্য যেকোনও ফ্লো ভেরিয়েবল থেকে এক্সট্র্যাক্ট করা যেতে পারে। যেমন, আপনি এটি weightনামের হেডারে সেট করেছেন:

<MessageWeight ref="message_weight"/>

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

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

সমস্যার রেফারেন্স

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

রানটাইম সমস্যা

নীতি এক্সিকিউট করার সময় এই সমস্যা হতে পারে।

ডিপ্লয়মেন্ট সংক্রান্ত সমস্যা

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

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

সমস্যার উত্তরের উদাহরণ

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

স্কিমা

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

ResetQuota নীতি

SpikeArrest নীতি

কোটা, স্পাইক অ্যারেস্ট ও কনকারেন্ট রেট লিমিট সংক্রান্ত নীতিগুলির তুলনা করা