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

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

কি

লক্ষ্য কোটা নীতি দ্বারা অনুমোদিত অনুরোধের অবশিষ্ট সংখ্যা গতিশীলভাবে পরিবর্তন করতে ব্যবহার করুন। আপনি সাধারণত কোটা গণনা পুনরায় সেট করার জন্য অপেক্ষা না করে লক্ষ্য কোটা নীতির বর্তমান কোটা সংখ্যা হ্রাস করতে এই নীতিটি ব্যবহার করেন৷

উদাহরণস্বরূপ, টার্গেট কোটা নীতি একজন বিকাশকারীকে প্রতি সপ্তাহে 1000টি অনুরোধের মধ্যে সীমাবদ্ধ করে। সপ্তাহের দ্বিতীয় দিন, বিকাশকারী ইতিমধ্যে এই সীমাতে পৌঁছেছেন। তাদের কোটা কাউন্টার থেকে 500 বিয়োগ করতে রিসেট কোটা নীতি ব্যবহার করে সপ্তাহের বাকি অংশের জন্য অতিরিক্ত 500টি অনুরোধের অনুমতি দিন। সপ্তাহের শেষে, কোটা নীতি রিসেট হয় এবং বিকাশকারী সপ্তাহের জন্য 1000টি অনুরোধে ফিরে আসে।

কোটা নীতি সম্পর্কে আরও জানতে কোটা নীতি দেখুন। রিসেট কোটা নীতি ব্যবহার করার জন্য এই সম্প্রদায়ের পোস্টটিও দেখুন।

নমুনা

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

ডিফল্ট কাউন্টার রিসেট করুন 

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

রিসেট কোটা নীতি <কোটা> ট্যাগের নাম বৈশিষ্ট্য ব্যবহার করে লক্ষ্য কোটা নীতি নির্দিষ্ট করে। উপরের উদাহরণে, MyQuotaPolicy নীতিটি লক্ষ্য।

সমস্ত রিসেট কোটা নীতি আপডেট করার জন্য কোটা নীতিতে কাউন্টার নির্দিষ্ট করতে <আইডেন্টিফায়ার> ট্যাগ প্রয়োজন। ডিফল্টরূপে, একটি কোটা নীতির একটি একক কাউন্টার থাকে, যদি না কোটা নীতিতে <আইডেন্টিফায়ার> ট্যাগ অন্তর্ভুক্ত থাকে। এই উদাহরণে, টার্গেট কোটা নীতি <আইডেন্টিফায়ার> ট্যাগ ব্যবহার করে না, তাই আপনি _default হিসাবে নামের বৈশিষ্ট্যটি নির্দিষ্ট করুন।

<অনুমতি> উপাদানটি লক্ষ্য নীতিতে বর্তমান কোটা গণনা হ্রাস করতে ব্যবহৃত মান নির্দিষ্ট করে। এই উদাহরণে, টার্গেট কোটা নীতিতে আরও 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>

যদি টার্গেট কোটা নীতি <আইডেন্টিফায়ার> ট্যাগ নির্দিষ্ট করে, তাহলে আপনি একটি নির্দিষ্ট কোটা সংখ্যা আপডেট করতে রিসেট কোটা নীতির <আইডেন্টিফায়ার> ট্যাগে একই মান নির্দিষ্ট করতে পারেন। লক্ষ্য করুন কিভাবে নিচের টার্গেট কোটা নীতিতে <আইডেন্টিফায়ার> ট্যাগ রিসেট কোটা নীতির সাথে নির্দিষ্ট করা মানের সাথে মেলে:

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

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

বৈশিষ্ট্য বর্ণনা ডিফল্ট উপস্থিতি
name

নীতির অভ্যন্তরীণ নাম। name বৈশিষ্ট্যের মানটিতে অক্ষর, সংখ্যা, স্পেস, হাইফেন, আন্ডারস্কোর এবং পিরিয়ড থাকতে পারে। এই মান 255 অক্ষরের বেশি হতে পারে না।

ঐচ্ছিকভাবে, ম্যানেজমেন্ট UI প্রক্সি এডিটরে নীতিটিকে একটি ভিন্ন, প্রাকৃতিক-ভাষা নামের সাথে লেবেল করতে <DisplayName> উপাদানটি ব্যবহার করুন।

 N/A প্রয়োজন
continueOnError

একটি নীতি ব্যর্থ হলে একটি ত্রুটি ফেরত দিতে false সেট করুন৷ এটি বেশিরভাগ নীতির জন্য প্রত্যাশিত আচরণ।

একটি নীতি ব্যর্থ হওয়ার পরেও ফ্লো এক্সিকিউশন চালিয়ে যেতে true সেট করুন৷

 মিথ্যা ঐচ্ছিক
enabled

নীতি প্রয়োগ করতে true সেট করুন৷

নীতি বন্ধ করতে false সেট করুন। নীতিটি প্রবাহের সাথে সংযুক্ত থাকলেও তা কার্যকর করা হবে না।

 সত্য ঐচ্ছিক
async

এই বৈশিষ্ট্যটি অবমূল্যায়ন করা হয়েছে৷

 মিথ্যা অবচয়

<DisplayName> উপাদান

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

<DisplayName>Policy Display Name</DisplayName>
ডিফল্ট

N/A

আপনি এই উপাদানটি বাদ দিলে, নীতির name বৈশিষ্ট্যের মান ব্যবহার করা হবে।

উপস্থিতি ঐচ্ছিক
টাইপ স্ট্রিং

<কোটা> উপাদান

লক্ষ্য কোটা নীতি চিহ্নিত করে যার কাউন্টার আপডেট করা উচিত।

<Quota name="quotaName"  ref="request.header.quotapolicy">
   <Identifier name="identifierName" ref="request.header.identifier">
      <Allow>100</Allow>
   </Identifier>
</Quota>
ডিফল্ট: N/A
উপস্থিতি: প্রয়োজন
প্রকার: N/A

গুণাবলী

বৈশিষ্ট্য বর্ণনা ডিফল্ট উপস্থিতি
নাম

টার্গেট কোটা নীতির নাম উল্লেখ করে।

 N/A ঐচ্ছিক
রেফ একটি ফ্লো ভেরিয়েবল যাতে টার্গেট কোটা নীতির নাম থাকে। যদি রেফ এবং নাম উভয়ই নির্দিষ্ট করা হয়, তাহলে রেফ অগ্রাধিকার পায়। যদি রেফ রানটাইমে সমাধান না করে, তাহলে নাম ব্যবহার করা হয়। N/A ঐচ্ছিক

<কোটা>/<শনাক্তকারী> উপাদান

যদি টার্গেট কোটা নীতি <আইডেন্টিফায়ার> ট্যাগ নির্দিষ্ট করে তাহলে কাউন্টারটিকে অনন্যভাবে সনাক্ত করতে ভেরিয়েবল ব্যবহার করা হয়।

<Quota name="quotaName">
   <Identifier name="identifierName" ref="request.header.identifier">
      <Allow>100</Allow>
   </Identifier>
</Quota>
ডিফল্ট: N/A
উপস্থিতি: প্রয়োজন
প্রকার: স্ট্রিং

গুণাবলী

বৈশিষ্ট্য বর্ণনা ডিফল্ট উপস্থিতি
নাম

টার্গেট কোটা নীতিতে গণনা শনাক্তকারীর নাম উল্লেখ করে। একটি কোটা নীতির জন্য যা <আইডেন্টিফায়ার> ট্যাগ ব্যবহার করে না, _default উল্লেখ করুন।

 N/A ঐচ্ছিক
রেফ

একটি ফ্লো ভেরিয়েবল যাতে লক্ষ্য কোটা নীতিতে গণনা শনাক্তকারীর নাম থাকে। যদি রেফ এবং নাম উভয়ই নির্দিষ্ট করা হয়, তাহলে রেফ অগ্রাধিকার পায়। যদি রেফ রানটাইমে সমাধান না করে, তাহলে নাম ব্যবহার করা হয়।

 N/A ঐচ্ছিক

<কোটা>/<শনাক্তকারী>/<অনুমতি> উপাদান

কোটা কাউন্টার হ্রাস করার পরিমাণ নির্দিষ্ট করে। আপনাকে অবশ্যই <অনুমতি> উল্লেখ করতে হবে, অন্যথায়, নীতি কোটা পরিবর্তন করে না। 

<Identifier name="identifierName" ref="request.header.identifier">
   <Allow ref="request.header.allowquota">100</Allow>
</Identifier>
ডিফল্ট: N/A
উপস্থিতি: প্রয়োজন
প্রকার: পূর্ণসংখ্যা

গুণাবলী

বৈশিষ্ট্য বর্ণনা ডিফল্ট উপস্থিতি
রেফ

একটি ফ্লো ভেরিয়েবল যাতে লক্ষ্য কোটা নীতিতে কোটা গণনার পরিবর্তন থাকে।

 N/A ঐচ্ছিক

<কোটা>/<আইডেন্টিফায়ার>/<ক্লাস> উপাদান

যে শ্রেণীর জন্য কোটা কাউন্টার আপডেট করা হয়েছে তা নির্দিষ্ট করে। কোটা নীতির সাথে ক্লাস ব্যবহার করার বিষয়ে আরও জানতে, কোটা নীতি দেখুন। 

<Identifier name="_default">
   <Class ref="request.header.classIdentifier">
     <Allow>200</Allow>
   </Class>
</Identifier>
ডিফল্ট: N/A
উপস্থিতি: ঐচ্ছিক
প্রকার: N/A

গুণাবলী

বৈশিষ্ট্য বর্ণনা ডিফল্ট উপস্থিতি
রেফ

ফ্লো ভেরিয়েবলের রেফারেন্স যেখানে আপডেট করার জন্য কোটা ক্লাস রয়েছে।

 N/A ঐচ্ছিক

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

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.

স্কিমাস

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

কোটা নীতি