سياسة إعادة ضبط الحصة

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X.
معلومات

المزايا

يتم استخدام هذا الإعداد لتعديل العدد المتبقي من الطلبات الذي تسمح به سياسة الحصة المستهدَفة ديناميكيًا. يتم عادةً استخدام هذه السياسة لخفض عدد الحصص الحالية الخاصة بسياسة الحصة المستهدَفة. بدلاً من انتظار إعادة تعيين عدد الحصص.

على سبيل المثال، تفرض سياسة الحصة المستهدَفة حدًّا أقصى على المطوّر بـ 1, 000 طلب في الأسبوع. من قِبل في اليوم الثاني من الأسبوع، يكون مطوّر البرامج قد وصل إلى هذا الحد الأقصى. استخدام سياسة إعادة ضبط الحصة طرح 500 من عداد حصصهم للسماح بـ 500 طلب إضافي لبقية الأسبوع. في نهاية الأسبوع، تتم إعادة ضبط سياسة الحصة، وسيعود مطوِّر البرامج إلى 1,000. الطلبات للأسبوع.

راجِع سياسة الحصة لمزيد من المعلومات حول سياسة الحصة. شاهد أيضًا هذه الصفحة مشاركة في "المنتدى" حول استخدام سياسة إعادة ضبط الحصة.

نماذج

توضّح نماذج رموز السياسة كيفية إعادة ضبط عدّادات الحصص:

إعادة ضبط العدّاد التلقائي

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

تحدد سياسة إعادة ضبط الحصة سياسة الحصة المستهدفة باستخدام السمة name للعلامة < تحصل>. في المثال أعلاه، تكون سياسة MySharePolicy هي الهدف.

تتطلب جميع سياسات حصة إعادة الضبط استخدام العلامة &lt;Identifier&gt; لتحديد في سياسة الحصة لتحديثها. بشكل افتراضي، تشتمل سياسة الحصة على عدّاد واحد، ما لم تكن سياسة الحصة تتضمّن أيضًا العلامة &lt;Identifier&gt;. في هذا المثال، ألا تستخدم سياسة الحصة المستهدفة علامة &lt;Identifier&gt;، لذا يمكنك تحديد السمة name على النحو التالي _default.

العنصر &lt;Allow&gt; تحدّد القيمة المستخدمة لخفض عدد الحصص الحالية في السياسة الهدف. في هذه الدورة، على سبيل المثال، يتم خفض عدد الحصص بمقدار 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>

إذا كانت سياسة الحصة المستهدفة تحدد العلامة &lt;Identifier&gt;، يمكنك عندئذٍ تحديد القيمة نفسها إلى العلامة &lt;Identifier&gt; في حصة إعادة الضبط لتعديل عدد حصص معيّنة. لاحظ كيف أن العلامة &lt;Identifier&gt; في الاستهداف تتطابق سياسة الحصة أدناه مع القيمة المحدّدة في سياسة إعادة ضبط الحصة:

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

&lt;ResetQuota&gt; السمات

<ResetQuota async="false" continueOnError="false" enabled="true" name="Reset-Quota-1"> 

يصف الجدول التالي السمات المشتركة بين جميع العناصر الرئيسية للسياسة:

السمة الوصف تلقائي التواجد في المنزل
name

الاسم الداخلي للسياسة. يمكن لقيمة السمة name أن تحتوي على أحرف وأرقام ومسافات وواصلات وشرطات سفلية ونقاط. لا يمكن لهذه القيمة يتجاوز 255 حرفًا.

يمكنك، إذا أردت، استخدام العنصر <DisplayName> لتصنيف السياسة محرر الخادم الوكيل لواجهة مستخدم الإدارة باسم مختلف بلغة طبيعية.

لا ينطبق مطلوب
continueOnError

اضبط القيمة على false لعرض رسالة خطأ عند تعذُّر تنفيذ سياسة. هذا متوقّع السلوك في معظم السياسات.

يمكنك ضبط القيمة على true لمواصلة تنفيذ المسار حتى بعد تطبيق إحدى السياسات. فشل.

خطأ اختياري
enabled

اضبط القيمة على true لفرض السياسة.

اضبط القيمة على false من أجل إيقاف السياسة. لن تكون السياسة ويتم فرضها حتى لو ظلت مرتبطة بتدفق.

صحيح اختياري
async

تم إيقاف هذه السمة نهائيًا.

خطأ منهي العمل به

&lt;DisplayName&gt; عنصر

استخدِمه مع السمة name لتصنيف السياسة في إدارة خادم وكيل لواجهة المستخدم باسم مختلف بلغة طبيعية.

<DisplayName>Policy Display Name</DisplayName>
تلقائي

لا ينطبق

إذا لم تستخدم هذا العنصر، سيتم ضبط قيمة السمة name للسياسة على النحو التالي: استخدام البيانات المختلفة.

التواجد في المنزل اختياري
النوع سلسلة

&lt;Quota&gt; عنصر

تحدِّد سياسة الحصة المستهدفة التي يجب تعديل عدّادها.

<Quota name="quotaName"  ref="request.header.quotapolicy">
   <Identifier name="identifierName" ref="request.header.identifier">
      <Allow>100</Allow>
   </Identifier>
</Quota>
الإعداد التلقائي: لا ينطبق
الحضور: مطلوب
النوع: لا ينطبق

السمات

السمة الوصف تلقائي التواجد في المنزل
الاسم

تُحدِّد هذه السياسة اسم سياسة الحصة المستهدَفة.

لا ينطبق اختياري
المرجع يشير ذلك المصطلح إلى متغيّر تدفق يحتوي على اسم سياسة الحصة المستهدَفة. في حال حذف تم تحديد كل من ref وname، عندئذٍ تكون الأولوية للدالة ref. إذا فعلت ref لا يتم حلها في وقت التشغيل، يتم استخدام name. لا ينطبق اختياري

&lt;Quota&gt;/&lt;Identifier&gt; عنصر

متغيّر يُستخدَم لتحديد العدّاد بشكل فريد إذا كانت سياسة الحصة المستهدَفة تحدّد العلامة &lt;Identifier&gt;.

<Quota name="quotaName">
   <Identifier name="identifierName" ref="request.header.identifier">
      <Allow>100</Allow>
   </Identifier>
</Quota>
الإعداد التلقائي: لا ينطبق
الحضور: مطلوب
النوع: سلسلة

السمات

السمة الوصف تلقائي التواجد في المنزل
الاسم

تُحدِّد هذه السياسة اسم معرِّف العدد في سياسة الحصة المستهدَفة. للحصول على حصة التي لا تستخدم العلامة &lt;Identifier&gt;، ينبغي تحديد _default.

لا ينطبق اختياري
المرجع

متغيّر تدفق يحتوي على اسم معرّف العدد في الحصة المستهدَفة . إذا تم تحديد كل من ref وname، عندئذٍ تكون الأولوية للدالة ref. إذا لم يتم حلّ المشكلة ref في التشغيل، ثم يتم استخدام name.

لا ينطبق اختياري

&lt;Quota&gt;/&lt;Identifier&gt;/&lt;Allow&gt; عنصر

تحدِّد هذه السياسة مبلغ خفض عدّاد الحصة. يجب تحديد &lt;Allow&gt;، وإلا لن تتمكّن السياسة من تعديل الحصة.

<Identifier name="identifierName" ref="request.header.identifier">
   <Allow ref="request.header.allowquota">100</Allow>
</Identifier>
الإعداد التلقائي: لا ينطبق
الحضور: مطلوب
النوع: عدد صحيح

السمات

السمة الوصف تلقائي التواجد في المنزل
المرجع

يشير ذلك المصطلح إلى متغيّر تدفق يحتوي على التغيير في عدد الحصص في سياسة الحصة المستهدَفة.

لا ينطبق اختياري

&lt;Quota&gt;/&lt;Identifier&gt;/&lt;Class&gt; عنصر

تحدد الفئة التي يتم تحديث عدّاد الحصة لها. لمزيد من المعلومات حول استخدام الصف مع سياسة الحصة، راجع الحصة .

<Identifier name="_default">
   <Class ref="request.header.classIdentifier">
     <Allow>200</Allow>
   </Class>
</Identifier>
الإعداد التلقائي: لا ينطبق
الحضور: اختياري
النوع: لا ينطبق

السمات

السمة الوصف تلقائي التواجد في المنزل
المرجع

الإشارة إلى متغيّر التدفق الذي يحتوي على فئة الحصة المطلوب تعديلها

لا ينطبق اختياري

مرجع الخطأ

يصف هذا القسم رموز الأخطاء ورسائل الخطأ التي يتم عرضها ومتغيرات الأخطاء التي تضبطها Edge عندما تؤدي هذه السياسة إلى ظهور خطأ. هذه المعلومات مهمة لمعرفة ما إذا كنت تعمل على تطوير قواعد للأخطاء للتعامل معها. لمزيد من المعلومات، يمكنك الاطّلاع على المعلومات التي يجب معرفتها عن الأخطاء المتعلقة بالسياسات وأخطاء المعالجة.

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ رموز حالة HTTP السبب إصلاح
policies.resetquota.InvalidRLPolicy 500 لم يتم تحديد سياسة الحصة المحدّدة في العنصر <Quota> ضمن سياسة إعادة ضبط الحصة في الخادم الوكيل لواجهة برمجة التطبيقات، وبالتالي لا تتوفّر أثناء العملية. العنصر <Quota> إلزامي ويحدّد سياسة الحصة المستهدفة التي يجب تعديل عدّادها من خلال سياسة إعادة ضبط الحصة.
policies.resetquota.FailedToResolveAllowCountRef لا ينطبق لا يمكن تحويل المرجع إلى المتغيّر الذي يتضمّن عدد المسموح به في العنصر <Allow> في السياسة إلى قيمة. هذا العنصر إلزامي ويحدد المبلغ المطلوب لخفض عدّاد الحصة.
policies.resetquota.FailedToResolveRLPolicy 500 لا يمكن حلّ المتغيّر الذي تشير إليه السمة ref في العنصر <Quota>.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ السبب إصلاح
InvalidCount إذا لم تكن قيمة العدد المحدّدة في العنصر <Allow> في "سياسة إعادة ضبط الحصص" عددًا صحيحًا، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.

المخططات

مواضيع ذات صلة

سياسة الحصة