আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।
কী
টার্গেট কোটা পলিসি দ্বারা অনুমোদিত অবশিষ্ট অনুরোধের সংখ্যা গতিশীলভাবে পরিবর্তন করতে এটি ব্যবহার করুন। কোটা গণনা রিসেট হওয়ার জন্য অপেক্ষা না করে, টার্গেট কোটা পলিসির বর্তমান কোটা সংখ্যা কমানোর জন্য আপনি সাধারণত এই পলিসিটি ব্যবহার করেন।
উদাহরণস্বরূপ, টার্গেট কোটা পলিসি একজন ডেভেলপারকে প্রতি সপ্তাহে ১০০০টি রিকোয়েস্টের মধ্যে সীমাবদ্ধ রাখে। সপ্তাহের দ্বিতীয় দিনের মধ্যেই ডেভেলপার এই সীমায় পৌঁছে যান। সপ্তাহের বাকি সময়ের জন্য অতিরিক্ত ৫০০টি রিকোয়েস্টের অনুমতি দিতে, তাদের কোটা কাউন্টার থেকে ৫০০ বিয়োগ করার জন্য রিসেট কোটা পলিসি ব্যবহার করুন। সপ্তাহের শেষে, কোটা পলিসি রিসেট হয়ে যায় এবং ডেভেলপার সেই সপ্তাহের জন্য আবার ১০০০টি রিকোয়েস্ট করার সুযোগ পান।
কোটা নীতি সম্পর্কে আরও জানতে কোটা নীতি দেখুন। এছাড়াও, কোটা নীতি রিসেট করার ব্যবহার সম্পর্কে এই কমিউনিটি পোস্টটি দেখুন।
নমুনা
এই পলিসি কোডের নমুনাগুলো দেখায় কীভাবে কোটা কাউন্টার রিসেট করতে হয়:
ডিফল্ট কাউন্টার রিসেট করুন
<ResetQuota name="resetQuota">
<Quota name="MyQuotaPolicy">
<Identifier name="_default">
<Allow>100</Allow>
</Identifier>
</Quota>
</ResetQuota>রিসেট কোটা পলিসিটি <Quota> ট্যাগের name অ্যাট্রিবিউট ব্যবহার করে টার্গেট কোটা পলিসি নির্দিষ্ট করে। উপরের উদাহরণে, MyQuotaPolicy পলিসিটি হলো টার্গেট।
সমস্ত রিসেট কোটা পলিসিতে, আপডেট করার জন্য কোটা পলিসির কাউন্টারটি নির্দিষ্ট করতে <Identifier> ট্যাগ প্রয়োজন হয়। ডিফল্টরূপে, একটি কোটা পলিসিতে একটিমাত্র কাউন্টার থাকে, যদি না সেই কোটা পলিসিতে <Identifier> ট্যাগটিও অন্তর্ভুক্ত থাকে। এই উদাহরণে, টার্গেট কোটা পলিসিতে <Identifier> ট্যাগ ব্যবহার করা হয়নি, তাই আপনি name অ্যাট্রিবিউট হিসেবে _default নির্দিষ্ট করবেন।
<Allow> এলিমেন্টটি টার্গেট পলিসিতে বর্তমান কোটা সংখ্যা কমানোর জন্য ব্যবহৃত মান নির্দিষ্ট করে। এই উদাহরণে, টার্গেট কোটা পলিসিতে আরও ১০০টি অনুরোধ অনুমোদনের জন্য কোটা সংখ্যা ১০০ কমানো হয়েছে। যখন টার্গেট কোটা পলিসি রিসেট করা হয়, তখন এই পরিবর্তনটি বাতিল হয়ে যায়।
নিম্নে টার্গেট কোটা পলিসির সংজ্ঞা দেখানো হলো:
<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>যদি টার্গেট কোটা পলিসিতে <Identifier> ট্যাগটি নির্দিষ্ট করা থাকে, তাহলে একটি নির্দিষ্ট কোটা সংখ্যা আপডেট করার জন্য আপনি রিসেট কোটা পলিসির <Identifier> ট্যাগেও একই মান নির্দিষ্ট করতে পারেন। লক্ষ্য করুন, নিচের টার্গেট কোটা পলিসির <Identifier> ট্যাগটি কীভাবে রিসেট কোটা পলিসিতে নির্দিষ্ট করা মানের সাথে মিলে যায়:
<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 | নীতির অভ্যন্তরীণ নাম। ঐচ্ছিকভাবে, ম্যানেজমেন্ট UI প্রক্সি এডিটরে নীতিটিকে একটি ভিন্ন, প্রাকৃতিক-ভাষা নামের সাথে লেবেল করতে | N/A | প্রয়োজন |
continueOnError | একটি নীতি ব্যর্থ হলে একটি ত্রুটি ফেরত দিতে একটি নীতি ব্যর্থ হওয়ার পরেও ফ্লো এক্সিকিউশন চালিয়ে যেতে | মিথ্যা | ঐচ্ছিক |
enabled | নীতি প্রয়োগ করতে নীতি বন্ধ করতে | সত্য | ঐচ্ছিক |
async | এই বৈশিষ্ট্যটি অবমূল্যায়ন করা হয়েছে৷ | মিথ্যা | অবচয় |
<DisplayName> উপাদান
ম্যানেজমেন্ট UI প্রক্সি এডিটরে নীতিটিকে একটি ভিন্ন, প্রাকৃতিক-ভাষা নামের সাথে লেবেল করতে name বৈশিষ্ট্য ছাড়াও ব্যবহার করুন।
<DisplayName>Policy Display Name</DisplayName>
| ডিফল্ট | N/A আপনি এই উপাদানটি বাদ দিলে, নীতির |
|---|---|
| উপস্থিতি | ঐচ্ছিক |
| টাইপ | স্ট্রিং |
<কোটা> উপাদান
সেই লক্ষ্য কোটা নীতি শনাক্ত করে যার কাউন্টারটি আপডেট করা প্রয়োজন।
<Quota name="quotaName" ref="request.header.quotapolicy">
<Identifier name="identifierName" ref="request.header.identifier">
<Allow>100</Allow>
</Identifier>
</Quota>| ডিফল্ট: | প্রযোজ্য নয় |
| উপস্থিতি: | প্রয়োজনীয় |
| প্রকার: | প্রযোজ্য নয় |
বৈশিষ্ট্য
| বৈশিষ্ট্য | বর্ণনা | ডিফল্ট | উপস্থিতি |
|---|---|---|---|
| নাম | লক্ষ্য কোটা নীতির নাম নির্দিষ্ট করে। | প্রযোজ্য নয় | ঐচ্ছিক |
| রেফারেন্স | একটি ফ্লো ভেরিয়েবল যা টার্গেট কোটা পলিসির নাম ধারণ করে। যদি ref এবং name উভয়ই নির্দিষ্ট করা থাকে, তবে ref অগ্রাধিকার পায়। যদি রানটাইমে ref সমাধান না হয়, তবে name ব্যবহৃত হয়। | প্রযোজ্য নয় | ঐচ্ছিক |
<কোটা>/<শনাক্তকারী> উপাদান
যদি টার্গেট কোটা পলিসিতে <Identifier> ট্যাগটি নির্দিষ্ট করা থাকে, তবে কাউন্টারটিকে অনন্যভাবে শনাক্ত করতে এই ভেরিয়েবলটি ব্যবহৃত হয়।
<Quota name="quotaName">
<Identifier name="identifierName" ref="request.header.identifier">
<Allow>100</Allow>
</Identifier>
</Quota>| ডিফল্ট: | প্রযোজ্য নয় |
| উপস্থিতি: | প্রয়োজনীয় |
| প্রকার: | স্ট্রিং |
বৈশিষ্ট্য
| বৈশিষ্ট্য | বর্ণনা | ডিফল্ট | উপস্থিতি |
|---|---|---|---|
| নাম | লক্ষ্য কোটা পলিসিতে গণনা শনাক্তকারীর নাম নির্দিষ্ট করে। যে কোটা পলিসি <Identifier> ট্যাগ ব্যবহার করে না, তার জন্য _default নির্দিষ্ট করুন। | প্রযোজ্য নয় | ঐচ্ছিক |
| রেফারেন্স | একটি ফ্লো ভেরিয়েবল যা টার্গেট কোটা পলিসিতে থাকা কাউন্ট আইডেন্টিফায়ারের নাম ধারণ করে। যদি ref এবং name উভয়ই নির্দিষ্ট করা থাকে, তবে ref অগ্রাধিকার পায়। যদি রানটাইমে ref সমাধান না হয়, তবে name ব্যবহৃত হয়। | প্রযোজ্য নয় | ঐচ্ছিক |
<কোটা>/<শনাক্তকারী>/<অনুমতি> উপাদান
কোটা কাউন্টার কমানোর পরিমাণ নির্দিষ্ট করে। আপনাকে অবশ্যই <Allow> নির্দিষ্ট করতে হবে, অন্যথায়, পলিসিটি কোটা পরিবর্তন করবে না।
<Identifier name="identifierName" ref="request.header.identifier"> <Allow ref="request.header.allowquota">100</Allow> </Identifier>
| ডিফল্ট: | প্রযোজ্য নয় |
| উপস্থিতি: | প্রয়োজনীয় |
| প্রকার: | পূর্ণসংখ্যা |
বৈশিষ্ট্য
| বৈশিষ্ট্য | বর্ণনা | ডিফল্ট | উপস্থিতি |
|---|---|---|---|
| রেফারেন্স | একটি ফ্লো ভেরিয়েবল যা টার্গেট কোটা পলিসিতে কোটা সংখ্যার পরিবর্তন ধারণ করে। | প্রযোজ্য নয় | ঐচ্ছিক |
<কোটা>/<শনাক্তকারী>/<শ্রেণী> উপাদান
যে ক্লাসের জন্য কোটা কাউন্টার আপডেট করা হবে, তা নির্দিষ্ট করে। কোটা পলিসির সাথে ক্লাসের ব্যবহার সম্পর্কে আরও জানতে, কোটা পলিসি দেখুন।
<Identifier name="_default">
<Class ref="request.header.classIdentifier">
<Allow>200</Allow>
</Class>
</Identifier>| ডিফল্ট: | প্রযোজ্য নয় |
| উপস্থিতি: | ঐচ্ছিক |
| প্রকার: | প্রযোজ্য নয় |
বৈশিষ্ট্য
| বৈশিষ্ট্য | বর্ণনা | ডিফল্ট | উপস্থিতি |
|---|---|---|---|
| রেফারেন্স | যে ফ্লো ভেরিয়েবলটিতে আপডেট করার জন্য কোটা ক্লাসটি রয়েছে, তার রেফারেন্স। | প্রযোজ্য নয় | ঐচ্ছিক |
ত্রুটির রেফারেন্স
এই বিভাগটি ফল্ট কোড এবং ত্রুটির বার্তাগুলি বর্ণনা করে যেগুলি ফেরত দেওয়া হয় এবং ত্রুটি ভেরিয়েবলগুলি যেগুলি এজ দ্বারা সেট করা হয় যখন এই নীতিটি একটি ত্রুটি ট্রিগার করে৷ এই তথ্যটি জানা গুরুত্বপূর্ণ যে আপনি ত্রুটিগুলি পরিচালনা করার জন্য ত্রুটির নিয়ম তৈরি করছেন কিনা। আরও জানতে, নীতিগত ত্রুটি এবং হ্যান্ডলিং ফল্ট সম্পর্কে আপনার যা জানা দরকার তা দেখুন৷
রানটাইম ত্রুটি
নীতি কার্যকর করার সময় এই ত্রুটিগুলি ঘটতে পারে৷
| ফল্ট কোড | HTTP স্থিতি | কারণ | ঠিক করুন |
|---|---|---|---|
policies.resetquota.InvalidRLPolicy | 500 | কোটা নীতি রিসেট কোটা নীতির <Quota> উপাদানে নির্দিষ্ট করা কোটা নীতি API প্রক্সিতে সংজ্ঞায়িত করা হয়নি এবং এইভাবে প্রবাহের সময় উপলব্ধ নয়। <Quota> উপাদানটি বাধ্যতামূলক এবং লক্ষ্য কোটা নীতি চিহ্নিত করে যার কাউন্টার রিসেট কোটা নীতির মাধ্যমে আপডেট করা উচিত। | build |
policies.resetquota.FailedToResolveAllowCountRef | N/A | নীতির <Allow> উপাদানের মঞ্জুরি গণনা ধারণকারী ভেরিয়েবলের রেফারেন্স একটি মান সমাধান করা যাবে না। এই উপাদানটি বাধ্যতামূলক এবং কোটা কাউন্টার হ্রাস করার পরিমাণ নির্দিষ্ট করে৷ | build |
policies.resetquota.FailedToResolveRLPolicy | 500 | <Quota> উপাদানে ref অ্যাট্রিবিউট দ্বারা উল্লেখ করা পরিবর্তনশীলটি সমাধান করা যাবে না। | build |
স্থাপনার ত্রুটি
আপনি যখন এই নীতি সম্বলিত একটি প্রক্সি স্থাপন করেন তখন এই ত্রুটিগুলি ঘটতে পারে৷
| ত্রুটির নাম | কারণ | ঠিক করুন |
|---|---|---|
InvalidCount | রিসেট কোটা নীতির <Allow> উপাদানে উল্লিখিত গণনা মান একটি পূর্ণসংখ্যা না হলে, API প্রক্সির স্থাপনা ব্যর্থ হয়। | build |