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

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

الموضوع

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

على سبيل المثال، تفرض سياسة الحصة المستهدفة قيودًا على المطوّرين بـ 1000 طلب في الأسبوع. وبحلول اليوم الثاني من الأسبوع، يكون المطوِّر قد وصل إلى هذا الحدّ الأقصى. يمكن استخدام سياسة إعادة ضبط الحصة لطرح 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>

سمات <Resetحصة>

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

يوضِّح الجدول التالي السمات الشائعة لجميع العناصر الرئيسية للسياسة:

العنصر <DisplayName>

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

<DisplayName>Policy Display Name</DisplayName>

عنصر <حصة>

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

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

السمات

عنصر <حصة>/<معرّف>

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

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

السمات

العنصر <حصة>/<معرّف>/<السماح>

تحدِّد هذه السمة الكمية المطلوب تخفيضها في عدّاد الحصة. يجب تحديد <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>

السمات

مرجع الخطأ

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

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

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

أخطاء النشر

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

المخططات

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

سياسة الحصة