سياسة الحصة

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

الموضوع

يمكنك استخدام سياسة الحصة لضبط عدد رسائل الطلب التي يسمح بها الخادم الوكيل لواجهة برمجة التطبيقات على مدار فترة زمنية، مثل دقيقة أو ساعة أو يوم أو أسبوع أو شهر. يمكنك ضبط الحصة لتكون نفسها لجميع التطبيقات التي يمكنها الوصول إلى الخادم الوكيل لواجهة برمجة التطبيقات، أو يمكنك ضبط الحصة استنادًا إلى ما يلي:

• المنتج الذي يحتوي على الخادم الوكيل لواجهة برمجة التطبيقات
• التطبيق الذي يطلب واجهة برمجة التطبيقات
• مطوّر التطبيق
• معايير أخرى كثيرة

ولا تستخدم الحصة للحماية من الارتفاعات الإجمالية في عدد الزيارات. ولإجراء ذلك، عليك استخدام سياسة "إيقاف الموجِّهات المتزايدة". يمكنك الاطّلاع على سياسة الوقف المفاجئ.

الفيديوهات الطويلة

تتناول هذه الفيديوهات إدارة الحصص وفقًا لسياسة الحصص:

عيّنات

توضّح نماذج رموز السياسة هذه كيفية بدء فترات الحصص وإنهائها من خلال:

<Quota name="CheckQuota"> 
  <Interval ref="verifyapikey.verify-api-key.apiproduct.developer.quota.interval">1</Interval>
  <TimeUnit ref="verifyapikey.verify-api-key.apiproduct.developer.quota.timeunit">hour</TimeUnit>
  <Allow count="200" countRef="verifyapikey.verify-api-key.apiproduct.developer.quota.limit"/>
</Quota>

<Quota name="DeveloperQuota"> 
  <Identifier ref="verifyapikey.verify-api-key.client_id"/> 
  <Interval ref="verifyapikey.verify-api-key.developer.timeInterval"/> 
  <TimeUnit ref="verifyapikey.verify-api-key.developer.timeUnit"/> 
  <Allow countRef="verifyapikey.verify-api-key.developer.limit"/> 
</Quota>

<Quota name="QuotaPolicy" type="calendar">
  <StartTime>2017-02-18 10:30:00</StartTime>
  <Interval>5</Interval>
  <TimeUnit>hour</TimeUnit>
  <Allow count="99"/>
</Quota>

<Quota name="QuotaPolicy">
  <Interval>5</Interval>
  <TimeUnit>hour</TimeUnit>
  <Allow count="99"/>
</Quota>

<AssignMessage async="false" continueOnError="false" enabled="true" name="ReturnQuotaVars">
    <AssignTo createNew="false" type="response"/>
    <Set>
        <Headers>
            <Header name="QuotaLimit">{ratelimit.QuotaPolicy.allowed.count}</Header>
            <Header name="QuotaUsed">{ratelimit.QuotaPolicy.used.count}</Header>
            <Header name="QuotaResetUTC">{ratelimit.QuotaPolicy.expiry.time}</Header>
        </Headers>
    </Set>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
</AssignMessage>

<Quota name="MyQuota">
  <Interval>1</Interval>
  <TimeUnit>hour</TimeUnit>
  <Allow count="10000"/>
</Quota>

<Quota name="QuotaPolicy" type="calendar">
  <Identifier ref="request.header.clientId"/> 
  <StartTime>2017-02-18 10:00:00</StartTime>
  <Interval>5</Interval>
  <TimeUnit>hour</TimeUnit>
  <Allow count="99"/>
</Quota>

<Identifier ref="request.queryparam.id"/>

<Identifier ref="verifyapikey.verify-api-key.client_id"></Identifier>

<Quota name="QuotaPolicy">
  <Interval>1</Interval>
  <TimeUnit>day</TimeUnit>
  <Allow>
    <Class ref="request.header.developer_segment">
      <Allow class="platinum" count="10000"/>
      <Allow class="silver" count="1000" />
    </Class>
  </Allow>
</Quota>

لمحة عن سياسة الحصة

الحصة هي حصة من رسائل الطلبات التي يمكن للخادم الوكيل لواجهة برمجة التطبيقات معالجتها خلال فترة زمنية، مثل دقيقة أو ساعة أو يوم أو أسبوع أو شهر. تحتفظ السياسة بالعدّادات التي تُسجِّل عدد الطلبات التي يتلقّاها الخادم الوكيل لواجهة برمجة التطبيقات. وتتيح هذه الإمكانية لموفّري واجهات برمجة التطبيقات فرض حدود على عدد طلبات البيانات من واجهة برمجة التطبيقات التي تجريها التطبيقات على مدار فترة زمنية. باستخدام سياسات الحصص، يمكنك على سبيل المثال، فرض قيود على طلب واحد في الدقيقة للتطبيقات، أو إلى 10,000 طلب في الشهر.

على سبيل المثال، إذا تم تحديد الحصة على أنها 10,000 رسالة في الشهر، يبدأ تحديد المعدّل بعد الرسالة رقم 10,000. ولا يهم ما إذا كان قد تم احتساب 10,000 رسالة في اليوم الأول أو اليوم الأخير من تلك الفترة، ولا يُسمح بمنطقة طلبات إضافية حتى تتم إعادة ضبط عدّاد الحصص تلقائيًا في نهاية الفاصل الزمني المحدد، أو حتى تتم إعادة ضبط الحصة صراحةً باستخدام سياسة إعادة ضبط الحصة.

إنّ اختلاف في الحصة يُسمّى SpikeArrest يمنع تكدس البيانات (أو تكدسات البيانات) التي يمكن أن تنتج عن الزيادة المفاجئة في الاستخدام أو برامج الأخطاء أو الهجمات الضارة. لمزيد من المعلومات حول SpikeArrest، يُرجى الاطّلاع على سياسة إيقاف SpikeArrest.

تنطبق الحصص على الخوادم الوكيلة الفردية لواجهة برمجة التطبيقات ولا يتم توزيعها بين الخوادم الوكيلة لواجهة برمجة التطبيقات. على سبيل المثال، إذا كان لديك ثلاثة خوادم وكيلة لواجهة برمجة التطبيقات في منتج من منتجات واجهة برمجة التطبيقات، لا تتم مشاركة حصة واحدة على مستوى هذه الخوادم الثلاثة حتى إذا كانت هذه الخوادم تستخدم إعدادات سياسة الحصة نفسها.

أنواع سياسة الحصص

تتوافق سياسة الحصص مع عدّة أنواع مختلفة من السياسات: السياسات التلقائية وcalendar وflexi وrollingwindow. يحدّد كل نوع وقت بدء عدّاد الحصة ووقت إعادة ضبطه، كما هو موضّح في الجدول التالي:

بالنسبة إلى type="calendar"، عليك تحديد قيمة <StartTime>.

لا يدرج الجدول قيمة النوع rollingwindow. تعمل حصص الفترات المتعاقبة من خلال ضبط حجم "فترة" الحصص، مثل فترة ساعة واحدة أو يوم واحد. وعند تلقّي طلب جديد، تحدِّد السياسة ما إذا تم تجاوز الحصة المسموح بها في "الفترة" الزمنية السابقة.

على سبيل المثال، يمكنك تحديد فترة ساعتين تسمح بـ 1000 طلب. يصل طلب جديد في الساعة 4:45 بعد الظهر.تحتسب السياسة الحصة المسموح بها خلال فترة الساعتَين الماضيتَين، ما يعني عدد الطلبات منذ الساعة 2:45 بعد الظهر. إذا لم يتم تجاوز حدّ الحصة المسموح بها خلال الساعتين، سيتم السماح بالطلب.

بَعْدَ دَقِيقَة وَاحِدَة، السَّاعَة 4:46 بَعْدِ الضُّهْرْ، وصلَ طلب آخر. تحسب السياسة الآن عدد الحصص منذ الساعة 2:46 بعد الظهر لتحديد ما إذا تم تجاوز الحدّ الأقصى.

بالنسبة إلى النوع rollingwindow، لا تتم إعادة ضبط العدّاد مطلقًا، ولكن تتم إعادة حسابه حسب كل طلب.

فهم عدّادات الحصص

تحتفظ سياسة الحصة تلقائيًا بعدّاد واحد، بغض النظر عن عدد المرات التي تشير إليه فيها في خادم وكيل لواجهة برمجة التطبيقات. يستند اسم عدّاد الحصص إلى السمة name الخاصة بالسياسة.

على سبيل المثال، يمكنك إنشاء سياسة حصة باسم MyQuotaPolicy بحد أقصى 5 طلبات ووضعها في تدفقات متعددة (التدفق أ وب وج) في الخادم الوكيل لواجهة برمجة التطبيقات. على الرغم من استخدامها في مسارات متعدّدة، إلّا أنّها تحتوي على عدّاد واحد يتم تعديله في جميع مثيلات السياسة:

• يتم تنفيذ التدفق A -> يتم تنفيذ MySharePolicy وعدّاده = 1
• يتم تنفيذ التدفق B -> يتم تنفيذ MyDataPolicy وعدّاده = 2
• يتم تنفيذ التدفق A -> يتم تنفيذ MyDataPolicy وعدّاده = 3
• يتم تنفيذ التدفق C -> يتم تنفيذ My غرفPolicy وعدّاده = 4
• يتم تنفيذ التدفق A -> يتم تنفيذ MyPortPolicy وعدّاده = 5

يتم رفض الطلب التالي لأي من المسارات الثلاثة لأنّ عدّاد الحصة قد بلغ الحدّ الأقصى.

يُعدّ استخدام سياسة الحصة نفسها في أكثر من مكان واحد خلال تدفّق الخادم الوكيل لواجهة برمجة التطبيقات، ما قد يؤدي بدون قصد إلى نفاد الحصة بشكل أسرع مما كنت تتوقع، هو نمط غير متوقَّع في كتاب Apigee Edge Antipatterns.

يمكنك بدلاً من ذلك تحديد سياسات "حصة" متعددة في الخادم الوكيل لواجهة برمجة التطبيقات واستخدام سياسة مختلفة في كل مسار. تحتفظ كل سياسة حصة بعدّادها الخاص، استنادًا إلى السمة name للسياسة.

أو يمكنك استخدام العنصرَين <Class> أو <Identifier> في سياسة الحصة لتحديد عدّادات فريدة ومتعدِّدة في سياسة واحدة. وباستخدام هذه العناصر، يمكن لسياسة واحدة الاحتفاظ بعدّادات مختلفة استنادًا إلى التطبيق الذي يقدّم الطلب، أو مطوّر التطبيق الذي يقدّم الطلب، أو معرّف العميل أو معرّف عميل آخر، وغير ذلك. راجِع الأمثلة أعلاه للحصول على مزيد من المعلومات حول استخدام العنصرَين <Class> أو <Identifier>.

الترميز الزمني

ويتم ضبط جميع أوقات الحصة على المنطقة الزمنية للتوقيت العالمي المنسَّق.

يتّبع طريقة كتابة وقت الحصة طريقة تدوين التاريخ المعياري الدولي المحدّد في المعيار الدولي ISO 8601.

يتم تحديد التواريخ بالسنة والشهر واليوم بالتنسيق التالي: YYYY-MM-DD. على سبيل المثال، يمثّل الرمز 2015-02-04 4 شباط (فبراير) 2015.

ويتم تحديد الوقت من اليوم بالساعات والدقائق والثواني بالتنسيق التالي: hours:minutes:seconds. على سبيل المثال، تمثّل السمة 23:59:59 الوقت قبل ثانية واحدة من منتصف الليل.

يُرجى العلم أنّ الترميزَين 00:00:00 و24:00:00 متوفّران للتمييز بين منتصف الليل واللذين يمكن ربطهما بتاريخ واحد. لذلك، فإن 2015-02-04 24:00:00 هو نفس التاريخ والوقت في 2015-02-05 00:00:00. والأسلوب الثاني هو عادةً الترميز المفضّل.

الحصول على إعدادات الحصة من إعدادات منتج واجهة برمجة التطبيقات

ويمكنك ضبط حدود الحصة في إعدادات منتج واجهة برمجة التطبيقات. ولا تفرض هذه الحدود الحصة تلقائيًا. بدلاً من ذلك، يمكنك الرجوع إلى إعدادات حصة المنتج في سياسة الحصة. في ما يلي بعض مزايا ضبط حصة على المنتج للرجوع إليها لسياسات الحصص:

• ويمكن لسياسات الحصة استخدام إعداد موحد على مستوى جميع الخوادم الوكيلة لواجهة برمجة التطبيقات في منتج واجهة برمجة التطبيقات.
• يمكنك إجراء تغييرات في وقت التشغيل على إعدادات الحصة لأحد منتجات واجهة برمجة التطبيقات، وسياسات الحصص التي تشير إلى القيمة يتم تعديلها تلقائيًا لقيم الحصص.

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

لمزيد من المعلومات حول ضبط منتجات واجهة برمجة التطبيقات مع حدود الحصة، يُرجى الاطّلاع على إنشاء منتجات واجهة برمجة التطبيقات.

مرجع العنصر

في ما يلي العناصر والسمات التي يمكنك ضبطها في هذه السياسة. ويُرجى العِلم بأنّ بعض تركيبات العناصر تكون حصرية أو غير مطلوبة. راجِع النماذج لاستخدامات معيّنة. تتوفر متغيّرات verifyapikey.VerifyAPIKey.apiproduct.* الواردة أدناه تلقائيًا عند استخدام سياسة "التحقّق من مفتاح واجهة برمجة التطبيقات" التي تُسمى "CheckAPIKey" للتحقّق من مفتاح واجهة برمجة التطبيقات الخاص بالتطبيق في الطلب. تأتي قيم المتغيّر من إعدادات الحصة على منتج واجهة برمجة التطبيقات المرتبط بالمفتاح، كما هو موضّح في المقالة الحصول على إعدادات الحصة من ضبط منتج واجهة برمجة التطبيقات.

<Quota async="false" continueOnError="false" enabled="true" name="Quota-3" type="calendar">
   <DisplayName>Quota 3</DisplayName>
   <Allow count="2000" countRef="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.limit"/>
   <Allow>
      <Class ref="request.queryparam.time_variable">
        <Allow class="peak_time" count="5000"/>
        <Allow class="off_peak_time" count="1000"/>
      </Class>
   </Allow>
   <Interval ref="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.interval">1</Interval> 
   <TimeUnit ref="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.timeunit">month</TimeUnit>
   <StartTime>2017-7-16 12:00:00</StartTime> 
   <Distributed>false</Distributed> 
   <Synchronous>false</Synchronous> 
   <AsynchronousConfiguration> 
      <SyncIntervalInSeconds>20</SyncIntervalInSeconds> 
      <SyncMessageCount>5</SyncMessageCount> 
   </AsynchronousConfiguration> 
   <Identifier/> 
   <MessageWeight/> 
</Quota>

سمات <حصة>

<Quota async="false" continueOnError="false" enabled="true" name="Quota-3" type="calendar">

السمات التالية خاصة بهذه السياسة.

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

العنصر <DisplayName>

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

<DisplayName>Policy Display Name</DisplayName>

عنصر <Allow>

تُحدِّد هذه السياسة الحدّ الأقصى لعدد الحصص. وفي حال وصول عدّاد السياسة إلى قيمة الحد هذه، يتم رفض الطلبات اللاحقة إلى أن تتم إعادة ضبط العدّاد.

في ما يلي ثلاث طرق لضبط عنصر <Allow>:

<Allow count="2000"/> 

<Allow countRef="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.limit"/> 

<Allow count="2000" countRef="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.limit"/> 

إذا حدّدت كل من count وcountRef، تصبح الأولوية للحقل countRef. إذا لم يتم حل countRef في وقت التشغيل، يتم استخدام القيمة count.

السمات

العنصر <Allow>/<Class>

يتيح لك العنصر <Class> إمكانية فرض شروط على قيمة العنصر <Allow> استنادًا إلى قيمة متغيّر التدفق. بالنسبة إلى كل علامة <Allow> فرعية مختلفة من <Class>، تحتفظ السياسة بعدّاد مختلف.

لاستخدام العنصر <Class>، حدِّد متغيّرًا للتدفق باستخدام السمة ref للعلامة <Class>. بعد ذلك، يستخدم Edge قيمة متغيّر التدفق لاختيار إحدى علامات <Allow> الفرعية لتحديد العدد المسموح به لهذه السياسة. تتطابق الحافة قيمة متغيّر التدفق مع السمة class للعلامة <Allow>، كما هو موضّح أدناه:

<Allow>
  <Class ref="request.queryparam.time_variable">
    <Allow class="peak_time" count="5000"/>
    <Allow class="off_peak_time" count="1000"/>
  </Class>
</Allow>

في هذا المثال، يتم تحديد عدّاد الحصص الحالية من خلال قيمة معلَمة طلب البحث time_variable التي يتم تمريرها مع كل طلب. ويمكن أن تكون قيمة هذا المتغيّر peak_time أو off_peak_time. إذا كانت مَعلمة طلب البحث تحتوي على قيمة غير صالحة، تعرِض السياسة خطأ بسبب انتهاك الحصة.

السمات

العنصر <Allow>/<Class>/<Allow>

يحدّد العنصر <Allow> الحدّ الأقصى لعدّاد الحصص، الذي يحدّده العنصر <Class>. لكل علامة <Allow> فرعية مختلفة في <Class>، تحتفظ السياسة بعدّاد مختلف.

مثال:

<Allow>
  <Class ref="request.queryparam.time_variable">
    <Allow class="peak_time" count="5000"/>
    <Allow class="off_peak_time" count="1000"/>
  </Class>
</Allow>

في هذا المثال، تحتفظ سياسة الحصة بعدّادَين للحصص باسم peak_time وoff_peak_time.

السمات

عنصر <Interval>

استخدِم هذه السمة لتحديد عدد صحيح (مثل 1 و2 و5 و60 وما إلى ذلك) الذي سيتم إقرانه مع TimeUnit الذي تحدّده (الدقيقة أو الساعة أو اليوم أو الأسبوع أو الشهر) لتحديد فترة زمنية تحسب خلالها Edge استخدام الحصة.

على سبيل المثال، إنّ عرض Interval للسمة 24 مع TimeUnit بقيمة hour يعني أنّه سيتم احتساب الحصة على مدار 24 ساعة.

<Interval ref="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.interval">1</Interval>

السمات

العنصر <TimeUnit>

استخدِم هذه السمة لتحديد الوحدة الزمنية السارية على الحصة.

على سبيل المثال، إنّ عرض Interval للسمة 24 مع TimeUnit بقيمة hour يعني أنّه سيتم احتساب الحصة على مدار 24 ساعة.

<TimeUnit ref="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.timeunit">month</TimeUnit>

السمات

عنصر <StartTime>

عند ضبط type على calendar,، يتم تحديد التاريخ والوقت اللذين سيبدأ فيهما عدّاد الحصص، بصرف النظر عمّا إذا كان قد تم تلقّي أي طلبات من أي تطبيقات أم لا.

يجب توفير StartTime صريحًا عندما يتم ضبط type بشكل صريح على calendar,، ولا يمكنك استخدام مرجع إلى متغيّر تدفق. وإذا حدّدت قيمة StartTime عندما لا يتم ضبط أي قيمة type، ستظهر لك رسالة خطأ.

مثال:

<StartTime>2017-7-16 12:00:00</StartTime>

العنصر <Distributed>

عند تثبيت Edge، يمكن استخدام معالج رسائل واحد أو أكثر لمعالجة الطلبات. يمكنك ضبط هذا العنصر على true لتحديد أنّ السياسة يجب أن تحتفظ بعدّاد مركزي ومزامنته باستمرار في جميع معالِجات الرسائل. ويمكن أن تعمل تلك الجهات على مستوى مناطق التوفّر و/أو المناطق المختلفة.

إذا كنت تستخدم القيمة التلقائية false، قد تتجاوز حصتك حصة لأنّه لا تتم مشاركة عدد كل معالج رسائل:

<Distributed>true</Distributed>

لضمان مزامنة العدّادات وتعديلها في كل طلب، اضبط <Distributed> و<Synchronous> على "صحيح":

<Distributed>true</Distributed>
<Synchronous>true</Synchronous>

عنصر <Synchronous>

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

اضبط القيمة على false لتعديل عدّاد الحصص بشكلٍ غير متزامن. وهذا يعني إمكانية معالجة بعض طلبات البيانات من واجهة برمجة التطبيقات التي تتجاوز الحصة المحددة، وذلك بناءً على الوقت الذي يتم فيه تحديث عدّاد الحصة في المستودع المركزي بشكل غير متزامن. ومع ذلك، لن تواجه تأثيرات الأداء المحتملة المرتبطة بالتحديثات المتزامنة.

الفترة الافتراضية للتحديث غير المتزامن هي 10 ثوانٍ. واستخدِم العنصر AsynchronousConfiguration لضبط هذا السلوك غير المتزامن.

<Synchronous>false</Synchronous>

العنصر <AsynchronousConfiguration>

تحدِّد هذه السياسة الفاصل الزمني للمزامنة بين عدّادات الحصص الموزعة عندما يكون عنصر ضبط السياسة <Synchronous> غير متوفّر أو غير متوفّر ويتم ضبطه على false.

يمكنك المزامنة إما بعد فترة زمنية أو بعد عدد الرسائل، باستخدام العنصرَين SyncIntervalInSeconds أو SyncMessageCount الثانويَين. وتكون مقتصرة على كل فئة منهما. على سبيل المثال:

<AsynchronousConfiguration>
   <SyncIntervalInSeconds>20</SyncIntervalInSeconds>
</AsynchronousConfiguration>

أو

<AsynchronousConfiguration>
   <SyncMessageCount>5</SyncMessageCount>
</AsynchronousConfiguration>

العنصر <AsynchronousConfiguration>/<SyncIntervalInSeconds>

استخدِم هذا الزر لتجاوز السلوك التلقائي الذي يتم فيه إجراء التحديثات غير المتزامنة بعد 10 ثوانٍ.

<AsynchronousConfiguration>
   <SyncIntervalInSeconds>20</SyncIntervalInSeconds>
</AsynchronousConfiguration>

يجب أن تكون فاصل المزامنة أكبر من 10 ثوانٍ، كما هو موضّح في موضوع الحدود.

العنصر <AsynchronousConfiguration>/<SyncMessageCount>

يحدِّد هذا الإعداد عدد الطلبات من جميع معالِجات رسائل Apigee بين تعديلات الحصص.

<AsynchronousConfiguration>
   <SyncMessageCount>5</SyncMessageCount>
</AsynchronousConfiguration>

يحدد هذا المثال أنّ عدد الحصص يتم تعديله كل 5 طلبات على مستوى كل معالج رسائل Apigee Edge.

عنصر <identifier>

يمكنك استخدام العنصر <Identifier> لضبط السياسة لإنشاء عدّادات فريدة استنادًا إلى متغيّر التدفق.

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

تتم مناقشة هذا العنصر أيضًا في مشاركة منتدى Apigee التالية: http://community.apigee.com/questions/2807/how-does-the-edge-quota-policy-work-when-no-identi.html.

<Identifier ref="verifyapikey.verify-api-key.client_id"/>

السمات

عنصر <MessageWeight>

استخدِم هذا الخيار لتحديد الحجم المخصّص لكل رسالة. استخدِم حجم الرسالة لزيادة تأثير رسائل الطلب التي تستهلك، على سبيل المثال، موارد حسابية أكثر من غيرها.

على سبيل المثال، إذا أردت احتساب رسائل POST على أنّها "ثقيلة" أو باهظة الثمن، مثل رسائل GET. بالتالي، تم ضبط MessageWeight على 2 لطريقة POST و1 على GET. يمكنك أيضًا ضبط MessageWeight على 0 كي لا يؤثر الطلب في العدّاد. في هذا المثال، إذا كانت الحصة تبلغ 10 رسائل في الدقيقة وكانت قيمة MessageWeight لطلبات POST هي 2، تسمح هذه الحصة بإجراء 5 طلبات POST خلال أي فاصل زمني مدته 10 دقائق. أي طلب إضافي، POST أو GET، قبل أن يتم رفض عمليات إعادة ضبط العدّاد.

يجب تحديد القيمة التي تمثّل MessageWeight عن طريق متغيّر تدفق، ويمكن استخراجها من عناوين HTTP أو معلَمات طلب البحث أو حمولة بيانات طلب XML أو JSON أو أي متغيّر آخر للتدفق. على سبيل المثال، يمكنك ضبطه في عنوان باسم weight:

<MessageWeight ref="message_weight"/>

متغيرات التدفق

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

مرجع الخطأ

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

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

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

أخطاء النشر

متغيرات الخطأ

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

مثال على الردّ على الخطأ

{  
   "fault":{  
      "detail":{  
         "errorcode":"policies.ratelimit.QuotaViolation"
      },
      "faultstring":"Rate limit quota violation. Quota limit  exceeded. Identifier : _default"
   }
}

مثال لقاعدة خطأ

<FaultRules>
    <FaultRule name="Quota Errors">
        <Step>
            <Name>JavaScript-1</Name>
            <Condition>(fault.name Matches "QuotaViolation") </Condition>
        </Step>
        <Condition>ratelimit.Quota-1.failed=true</Condition>
    </FaultRule>
</FaultRules>

المخططات

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

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

سياسة SpikeArrest

مقارنة سياسات الحصص والحدّ الأقصى للارتفاع والحدّ الأقصى للسعر المتزامن