إضافة سياسة إيقاف الحدّ الأقصى المسموح به إلى واجهة برمجة التطبيقات

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

ما ستتعرّف عليه

من خلال هذا البرنامج التعليمي، ستتعرّف على ما يلي:

• إضافة سياسة تؤثّر في الطلب والردّ
• الاطّلاع على تأثيرات السياسة

المتطلبات

• سياسة واحدة على الأقل في الخادم الوكيل (وهي أيضًا جزء من البرنامج التعليمي "البدء")
• curl تثبيت على جهازك لتقديم طلبات البيانات من واجهة برمجة التطبيقات من سطر الأوامر

إضافة سياسة Spike Arrest

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

لإضافة سياسة Spike Arrest إلى خادم وكيل لواجهة برمجة التطبيقات، اتّبِع الخطوات التالية:

1. سجِّل الدخول إلى apigee.com/edge.
2. انقر على تطوير > الخوادم الوكيلة لواجهة برمجة التطبيقات في شريط التنقّل الأيمن.
3. اختَر الخادم الوكيل لواجهة برمجة التطبيقات الذي تريد إضافة سياسة Spike Arrest إليه.

   إذا اتّبعت البرنامج التعليمي "البدء"، يمكنك إضافته إلى الـ "getstarted" الوكيل الذي أنشأته في إنشاء خادم وكيل لواجهة برمجة التطبيقات.

4. في محرّر الخادم الوكيل الجديد لواجهة برمجة التطبيقات، انقر على علامة التبويب تطوير:

   

   يتيح لك "محرّر الخادم الوكيل لواجهة برمجة التطبيقات" الاطّلاع على بنية الخادم الوكيل لواجهة برمجة التطبيقات وإعداد مساره. يعرض المحرّر تمثيلاً مرئيًا لمسار طلبات الخادم الوكيل ورسائل الردّ بالإضافة إلى عرض قابل للتعديل لملف XML الأساسي الذي يحدّد الخادم الوكيل.

5. في لوحة "المستكشف" على يمين الشاشة، انقر على PreFlow ضِمن نقاط نهاية الخادم الوكيل > تلقائي. (ستتناول البرامج التعليمية الأخرى مفهوم المسارات.)
6. انقر على الزر +الخطوة في أعلى الصفحة، والذي يتوافق مع PreFlow للطلب. يؤدي ذلك إلى عرض قائمة مصنّفة بجميع السياسات التي يمكنك إنشاؤها.

   

7. اختَر Spike Arrest في فئة "إدارة عدد الزيارات". يظهر مربّع الحوار "سياسة جديدة" :

   

8. اترك الأسماء التلقائية وانقر على إضافة. يتم إرفاق السياسة الجديدة بـ مسار PreFlow لطلب معيّن.
9. في "المستكشف"، تأكَّد من أنّ PreFlow ضِمن نقاط نهاية الخادم الوكيل > تلقائي لا يزال محدّدًا، ولاحِظ ما يلي في "محرّر الخادم الوكيل لواجهة برمجة التطبيقات":
   • تتم إضافة سياسة Spike Arrest-1 الجديدة ضِمن السياسات في المستكشف على يمين "محرّر الخادم الوكيل لواجهة برمجة التطبيقات".
   • تتم إضافة رمز Spike Arrest-1 إلى عرض "المصمّم" في أعلى منتصف "محرّر الخادم الوكيل لواجهة برمجة التطبيقات"، وهو تمثيل مرئي لـ مسارات رسائل الخادم الوكيل.
   • يظهر ملف XML للسياسة في طريقة عرض الرمز في أسفل منتصف "محرّر الخادم الوكيل لواجهة برمجة التطبيقات".

   

10. في "المستكشف"، اختَر Spike Arrest-1 ضِمن "السياسات" ولاحِظ ما يلي في "محرّر الخادم الوكيل لواجهة برمجة التطبيقات":
    • تظهر تفاصيل السياسة في عرض "المصمّم" في أعلى منتصف "محرّر الخادم الوكيل لواجهة برمجة التطبيقات".
    • يظهر ملف XML للسياسة في طريقة عرض الرمز في أسفل منتصف "محرّر الخادم الوكيل لواجهة برمجة التطبيقات".
    • تظهر قيم عناصر XML وسماتها للسياسة في أداة فحص السمات على يمين "محرّر الخادم الوكيل لواجهة برمجة التطبيقات".

    

11. في ملف XML للسياسة، غيِّر قيمة العنصر <Rate> إلى 1pm (ما يعني السماح بطلبَين تقريبًا كل 60 ثانية في السحابة الإلكترونية).

    يمكنك تحديد المعدّل كقيمة عددية صحيحة في الدقيقة (pm) أو في الثانية (ps). هذا حدّ منخفض جدًا ولا يُستخدم إلا في هذا البرنامج التعليمي لتوضيح السياسة. عادةً ما يتم ضبطه على حدّ أعلى بكثير.

    لاحِظ أنّ قيمة Rate في "أداة فحص السمات" تتغيّر أيضًا إلى "1pm". بدلاً من ذلك، يمكنك تغيير قيمة Rate في "أداة فحص السمات" وستظهر في عرض XML.

12. انقر على حفظ لحفظ المراجعة الحالية مع التغييرات.

13. يمكنك طلب واجهة برمجة التطبيقات باستخدام curl، مع استبدال اسم مؤسستك على Apigee بالاسم org_name:

    curl "http://org_name-test.apigee.net/getstarted"

    على سبيل المثال:

    curl "http://ahamilton-eval-test.apigee.net/getstarted" | python -m json.tool

    تأكَّد من نجاح الطلب وظهور استجابة XML نفسها التي ظهرت لك سابقًا. (يمكنك أيضًا إدخال عنوان URL فقط في متصفّح ويب.)

14. نفِّذ الأمر curl (أو أعِد تحميل نافذة المتصفّح) مرّتَين أو ثلاث مرّات إضافية خلال دقيقة واحدة، ولاحِظ ظهور الرسالة التالية لأنّك تجاوزت الحدّ الأقصى لمعدّل الطلبات في السياسة:

    {
    "fault": {
      "faultstring":"Spike arrest violation. Allowed rate : 1pm",
      "detail": {
        "errorcode":"policies.ratelimit.SpikeArrestViolation"}
      }
    }

    إذا حاولت إجراء المزيد من الطلبات خلال دقيقة واحدة، من المفترض أن تستمر في تلقّي رسالة الخطأ.

15. عدِّل سياستك لضبط الحدّ الأقصى لـ <Rate> على 15pm (ما يعني السماح بطلبَين تقريبًا كل 4 ثوانٍ في الـ سحابة الإلكترونية)، ثم احفظ الخادم الوكيل لواجهة برمجة التطبيقات.
16. نفِّذ أمر curl أو أعِد تحميل المتصفّح بشكل متكرّر (curl أسرع). لاحِظ أنّه إذا أجريت طلبًا واحدًا أو طلبَين خلال فترات زمنية مدّتها 4 ثوانٍ، ستنجح طلباتك. إذا أجريت الطلبات بسرعة، أي أكثر من طلبَين خلال 4 ثوانٍ، من المفترض أن يظهر لك الخطأ. ولكن بعد كل فترة زمنية مدّتها 4 ثوانٍ، يمكنك مواصلة إجراء الطلبات، بدلاً من حظرها لمدة دقيقة كاملة (مع الإعداد 1pm).