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

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

الأدوات المستخدمة

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

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

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

نماذج

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

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

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

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

&lt;DisplayName&gt; عنصر

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

<DisplayName>Policy Display Name</DisplayName>

العنصر <Quota>

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

<Quota name="quotaName"  ref="request.header.quotapolicy">
   <Identifier name="identifierName" ref="request.header.identifier">
      <Allow>100</Allow>
   </Identifier>
</Quota>

السمات

العنصر <Quota>/<Identifier>

متغيّر يُستخدَم لتحديد العداد بشكلٍ فريد إذا كانت سياسة الحصة المستهدَفة تحدّد العلامة <Identifier>.

<Quota name="quotaName">
   <Identifier name="identifierName" ref="request.header.identifier">
      <Allow>100</Allow>
   </Identifier>
</Quota>

السمات

العنصر <Quota>/<Identifier>/<Allow>

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

<Identifier name="identifierName" ref="request.header.identifier">
   <Allow ref="request.header.allowquota">100</Allow>
</Identifier>

السمات

العنصر <Quota>/<Identifier>/<Class>

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

<Identifier name="_default">
   <Class ref="request.header.classIdentifier">
     <Allow>200</Allow>
   </Class>
</Identifier>

السمات

مرجع الخطأ

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

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

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

أخطاء النشر

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

المخططات

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

سياسة الحصص