مشاركة عبر

تعيين الحصة النسبية للاستخدام حسب المفتاح

  • مقالة

ينطبق على: المطور | أساسي | قياسي | قسط

يفرض النهج quota-by-key حجم استدعاءات متجددة أو لمدة بقاء معينة و/أو الحصة النسبية لعرض النطاق الترددي، على أساس كل مفتاح. يمكن أن يتضمن المفتاح قيمة سلسلة إجبارية، ويتم توفيرها عادةً باستخدام التعبير عن النهج. يمكن إضافة شرط الزيادة الاختيارية لتحديد الطلبات التي ينبغي حسابها ضمن الحصة النسبية. في حالة وجود نُهج متعددة تعمل على زيادة قيمة المفتاح نفسها، يتم زيادتها مرة واحدة فقط لكل طلب. عند تجاوز الحصة النسبية، يتلقى المتصل 403 Forbiddenرمز حالة استجابة، وتتضمن الاستجابة Retry-After عنوانًا تكون قيمته هي الفاصل الزمني لإعادة المحاولة الموصى به بالثواني.

لفهم الفرق بين حدود المعدلات والحصص، راجع حدود المعدلات والحصص النسبية.

إشعار

عند إعادة تشغيل موارد الحوسبة الأساسية في النظام الأساسي للخدمة، قد تستمر APIM برمجة التطبيقات في معالجة الطلبات لفترة قصيرة بعد الوصول إلى الحصة النسبية.

إشعار

تعيين عناصر النهج والعناصر التابعة بالترتيب الوارد في بيان النهج. لمساعدتك في تكوين هذا النهج، يتيح المدخل محررًا موجهًا يستند إلى النموذج. تعلم كيفية إعداد نُهج APIM أو تعديلها.

نهج السياسة

<quota-by-key calls="number"
              bandwidth="kilobytes"
              renewal-period="seconds"
              increment-condition="condition"
              increment-count="number"
              counter-key="key value"
              first-period-start="date-time" />

سمات

السمة ‏‏الوصف مطلوبة افتراضي
bandwidth الحدّ الأقصى لإجمالي عدد المكالمات المسموح بها خلال الفاصل الزمني المحدد في renewal-period. تعبيرات النهج غير مسموح بها. يجب تحديد إما calls، أو bandwidth، أو كلاهما معًا. ‏‫غير متوفر‬
calls الحد الأقصى لإجمالي عدد المكالمات المسموح بها خلال الفاصل الزمني المحدد في renewal-period. تعبيرات النهج غير مسموح بها. يجب تحديد إما calls، أو bandwidth، أو كلاهما معًا. ‏‫غير متوفر‬
counter-key المفتاح الذي يجب استخدامه ل quota policy. لكل قيمة مفتاح، يتم استخدام عداد واحد لجميع النطاقات التي يتم تكوين النهج بها. يتم السماح بتعبيرات النهج. ‏‏نعم‬ غير متوفر
increment-condition التعبير المنطقي الذي يحدد ما إذا كان يجب حساب الطلب نحو الحصة النسبية (true). يتم السماح بتعبيرات النهج. لا ‏‫غير متاح
زيادة العد الرقم الذي يتم من خلاله زيادة العداد لكل طلب. يتم السماح بتعبيرات النهج. لا 1
renewal-period الطول بالثواني للإطار الثابت الذي يتم بعده إعادة تعيين الحصة النسبية. يتم حساب بداية كل فترة بالنسبة إلى first-period-start. الحد الأدنى للفترة: 300 ثانية. عندما renewal-period يتم تعيين إلى 0، يتم تعيين الفترة إلى لانهائية. تعبيرات النهج غير مسموح بها. ‏‏نعم‬ غير متوفر
بداية الفترة الأولى تاريخ ووقت بدء فترات تجديد الحصص، بالتنسيق التالي: yyyy-MM-ddTHH:mm:ssZ كما هو محدد بواسطة معيار ISO 8601. تعبيرات النهج غير مسموح بها. لا 0001-01-01T00:00:00Z

الاستخدام

ملاحظات الاستخدام

counter-key يجب أن تكون قيمة السمة فريدة عبر جميع واجهات برمجة التطبيقات في مثيل APIM إذا كنت لا تريد مشاركة الإجمالي بين واجهات برمجة التطبيقات الأخرى.

مثال

<policies>
    <inbound>
        <base />
        <quota-by-key calls="10000" bandwidth="40000" renewal-period="3600"
                      increment-condition="@(context.Response.StatusCode >= 200 && context.Response.StatusCode < 400)"
                      counter-key="@(context.Request.IpAddress)" />
    </inbound>
    <outbound>
        <base />
    </outbound>
</policies>

للحصول على مزيدٍ من المعلومات والأمثلة على هذا النهج، راجع تقييد الطلب المتقدم باستخدام APIM في Azure.

المحتوى ذو الصلة

لمزيد من المعلومات حول العمل مع النُهج، راجع: