أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى
مستندات Apigee X. info
تُستخدَم سياسة الحصة لاحتساب عدد الطلبات التي يتلقّاها خادم وكيل لواجهة برمجة التطبيقات. تتيح هذه الإمكانية لمقدّمي واجهات برمجة التطبيقات فرض حدود على عدد طلبات البيانات من واجهة برمجة التطبيقات التي ترسلها التطبيقات خلال فترة زمنية معيّنة.
يمكن أن تتضمّن سياسة الحصة عنصر
identifier الذي يحدّد "حزمة" الحصة التي يتم احتساب كل طلب فيها.
نمط مضاد
عند استخدام سياسة "الحصة"، لا تستخدِم معرّفات ذات عدد كبير من القيم.
يشير عدد القيم الفريدة إلى عدد قيم البيانات الفريدة في مجموعة. المعرّف الذي يتضمّن عددًا كبيرًا من القيم الفريدة المحتملة يُعرف باسم المعرّف ذو العدد الكبير من القيم. تتضمّن المعرّفات ذات عدد القيم الممكنة الكبير معرّفات طلبات أو معرّفات جلسات فريدة تتغيّر مع كل طلب من واجهة برمجة التطبيقات.
يمكن أن يؤدي استخدام المعرّفات التي تتضمّن عددًا كبيرًا من القيم إلى تقليل فعالية تطبيق الحصص بشكل كبير.
التأثير
يؤدي استخدام معرّفات ذات عدد كبير من القيم الممكنة لعنصر المعرّف في سياسة الحصة إلى حدوث ما يلي:
- فرض الحصة غير الفعّال: يتم التعامل مع كل معرّف فريد على أنّه عدّاد منفصل. إذا كان لكل طلب معرّف جديد وفريد، سيؤدي نظام الحصص إلى إنشاء "حزمة" جديدة لكل طلب بيانات من واجهة برمجة التطبيقات. وهذا يعني أنّ الحد الأقصى للحصة الإجمالية يتم قياسه استنادًا إلى عدّادات فردية ذات استخدام واحد، بدلاً من مجموعات طلبات فعلية تريد الحدّ منها، ما يجعل السياسة غير مفيدة للتحكّم في عدد الزيارات.
- زيادة استهلاك الموارد: يؤدي إنشاء عدد كبير من عدّادات الحصص الفريدة وإدارتها إلى إجهاد منصة Apigee بشكل غير ضروري، ما يؤدي إلى زيادة استخدام الموارد وحدوث مشاكل محتملة في الأداء.
- صعوبات المراقبة: يصبح من الصعب مراقبة مؤشرات الاستخدام الفعلي لواجهة برمجة التطبيقات وفهمها عندما تكون البيانات مقسّمة على عدد كبير من المعرّفات الفريدة. لن يعود بإمكانك معرفة التطبيقات أو المطوّرين أو المنتجات التي تستخدم موارد واجهة برمجة التطبيقات.
أفضل ممارسة
اختَر معرّفات ذات عدد مميز منخفض إلى متوسط تمثّل أيضًا تجميعًا ثابتًا ومفيدًا لفرض الحصة. تساعدك هذه المقاييس في إدارة استخدام واجهة برمجة التطبيقات بفعالية والحصول على إحصاءات حول عدد الزيارات. تشمل الأمثلة ما يلي:
- developer.app.name
- client_id
- apiproduct.name
باستخدام المعرّفات المناسبة، يمكن أن تدير سياسة الحصة حركة بيانات واجهة برمجة التطبيقات بشكل أكثر فعالية، وتمنع تجاوز الحصة غير المقصود، وتقدّم إحصاءات واضحة حول أنماط الاستخدام.