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