سياسة الحصة

يتم الآن عرض مستندات Apigee Edge.
يمكنك الاطّلاع على وثائق Apigee X.

الموضوع

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

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

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

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

تقدم الفيديوهات التالية إدارة الحصة مع سياسة الحصة:

عيّنات

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

<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، يُرجى الاطّلاع على سياسة توقّف شركة Spike.

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

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

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

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

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

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

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

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

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

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

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

• تم تنفيذ التدفق "أ" -> تم تنفيذ MyQuotaPolicy والعدّاد = 1
• تم تنفيذ مسار "ب" -> يتم تنفيذ MyQuotaPolicy والعدّاد = 2
• تم تنفيذ العملية "أ" -> يتم تنفيذ MyQuotaPolicy والعدّاد = 3
• تم تنفيذ العملية "ج" -> تم تنفيذ MyQuotaPolicy وعداده = 4
• تم تنفيذ التدفق "أ" -> تم تنفيذ MyQuotaPolicy وعدّاده = 5

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

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

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

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

تدوين الوقت

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

يتّبع تدوين وقت الحصة تدوين التاريخ المعياري الدولي كما هو محدّد في المعيار 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.* تلقائيًا في حال استخدام سياسة "التحقّق من مفتاح واجهة برمجة التطبيقات" المعروفة باسم "VerifyAPIKey" للتحقّق من مفتاح واجهة برمجة التطبيقات في الطلب. تأتي قيم المتغيّرات من إعدادات الحصة لمنتج واجهة برمجة التطبيقات التي يرتبط بها المفتاح، كما هو موضّح في الحصول على إعدادات الحصة من إعدادات منتج واجهة برمجة التطبيقات.

<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 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> لتحديد العدد المسموح به للسياسة. تتطابق شبكة Edge مع قيمة متغيّر التدفق مع السمة 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>

عنصر <الموزّع>

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

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

<Distributed>true</Distributed>

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

<Distributed>true</Distributed>
<Synchronous>true</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> لضبط السياسة من أجل إنشاء عدّادات فريدة استنادًا إلى متغيّر تدفق.

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

تتم أيضًا مناقشة هذا العنصر في مشاركة "منتدى 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

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