سياسة الحصة

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

ما هي الإعلانات الترويجية؟

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

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

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

الفيديوهات

تعرِض هذه الفيديوهات كيفية إدارة الحصة من خلال سياسة الحصة:

نماذج

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

<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. تعمل الحصص في "النافذة المتغيّرة" من خلال ضبط حجم "نافذة" الحصة، مثل نافذة ساعة واحدة أو يوم واحد. عند تلقّي طلب جديد، تحدّد السياسة ما إذا تم تجاوز الحصة في "فترة" زمنية سابقة.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مرجع العنصر

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

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

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

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

&lt;DisplayName&gt; عنصر

استخدِمه مع السمة 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> لتحديد العدد المسموح به للسياسة. تطابق 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 الذي تحدّده (دقيقة أو ساعة أو يوم أو أسبوع أو شهر) لتحديد ملف شخصي زمني يتم خلاله احتساب استخدام الحصة.

على سبيل المثال، إذا كان 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>2017-7-16 12:00:00</StartTime>

عنصر <Distributed>

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

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

<Distributed>true</Distributed>

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

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

متغيّرات مسار الإحالة الناجحة

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

مرجع الخطأ

يصف هذا القسم رموز الخطأ ورسائل الخطأ التي يتم عرضها ومتغيرات الأخطاء التي تم ضبطها من خلال 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

مقارنة بين سياسات الحصة ومنع الارتفاعات المفاجئة في عدد الطلبات وحدود معدّل عمليات التنفيذ المتزامنة