سياسة الحصة

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

المزايا

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

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

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

الفيديوهات

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

نماذج

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• يتم تنفيذ التدفق A -> تم تنفيذ سياسة MyTrackingPolicy وعدّادها = 1
• يتم تنفيذ التدفق B -> تم تنفيذ سياسة MyTrackingPolicy وعدّادها = 2
• يتم تنفيذ التدفق A -> تم تنفيذ سياسة MyCategoryPolicy وعدّادها = 3
• يتم تنفيذ التدفق C -> تم تنفيذ سياسة MyTrackingPolicy وعدّادها = 4
• يتم تنفيذ التدفق A -> تم تنفيذ سياسة MyTrackingPolicy وعدّادها = 5

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

وباستخدام سياسة الحصة نفسها في أكثر من مكان واحد في مسار الخادم الوكيل لواجهة برمجة التطبيقات، ما يمكن أن تتسبب عن غير قصد في نفاد الحصة بشكل أسرع مما تتوقع، عبارة عن نمط مضاد مذكور في The Book of 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> السمات

<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> لتحديد القيمة المسموح بها عدد السياسات. تتطابق قيمة 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>

&lt;Synchronous&gt; عنصر

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

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

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

<Synchronous>false</Synchronous>

&lt;AsynchronousConfiguration&gt; عنصر

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

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

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

أو

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

&lt;AsynchronousConfiguration&gt;/&lt;SyncIntervalInSeconds&gt; عنصر

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

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

يجب أن يكون الفاصل الزمني للمزامنة أكبر من أو يساوي 10 ثوانٍ كما هو موضح في الحدود:

&lt;AsynchronousConfiguration&gt;/&lt;SyncMessageCount&gt; عنصر

تُحدِّد هذه السياسة عدد الطلبات على مستوى جميع معالِجات رسائل Apigee بين الحصة. التحديثات.

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

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

&lt;Identifier&gt; عنصر

يمكنك استخدام العنصر <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"/>

السمات

&lt;MessageWeight&gt; عنصر

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

على سبيل المثال، تريد احتساب رسائل POST على أنها ضعف "الرسائل الثقيلة" أو باهظة الثمن، كما أن GET الرسائل. لذلك، يمكنك ضبط MessageWeight على 2 لطلب POST و1. الحصول عليها. ويمكنك أيضًا ضبط السمة 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 السياسة

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