إدارة المجموعات باستخدام واجهة برمجة التطبيقات

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

تتيح لك المجموعات تجميع العناصر الوكيلة لواجهات برمجة التطبيقات أو الاستهدافات أو تطبيقات المطوّرين، و ضبط قيم الحدود الدنيا المناسبة لجميع أعضاء المجموعة لتشخيص المشاكل بشكل أسرع.

توضّح الأقسام التالية كيفية إدارة المجموعات باستخدام واجهة برمجة التطبيقات.

اطّلِع على Collections API للمزيد من المعلومات حول واجهة برمجة التطبيقات هذه.

إنشاء مجموعات باستخدام واجهة برمجة التطبيقات

أنشئ مجموعة من الوكلاء لـ API من خلال إرسال طلب POST إلى المورد التالي: https://apimonitoring.enterprise.apigee.com/collections

يوضّح المثال التالي كيفية إنشاء مجموعة. 

curl 'https://apimonitoring.enterprise.apigee.com/collections' \
  -X POST \
  -H 'Accept: application/json, text/plain, */*' -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -d '{
     "organization":"myorg",
     "name":"My Collection",
     "description":"My collection for critical APIs",
     "environment": "prod",
     "type": "proxy",
     "members":["proxy1", "proxy2"]
    }'

اضبط $ACCESS_TOKEN على رمز الوصول عبر OAuth 2.0، كما هو موضّح في مقالة الحصول على رمز وصول عبر OAuth 2.0.

للحصول على معلومات عن خيارات cURL المستخدَمة في هذا المثال، اطّلِع على مقالة استخدام cURL.

يمكنك تحديد قيمة type على أنّها proxy أو target أو developerApp. على سبيل المثال، لإنشاء مجموعة من تطبيقات المطوّرين:

curl 'https://apimonitoring.enterprise.apigee.com/collections' \
  -X POST \
  -H 'Accept: application/json, text/plain, */*' -H "Content-Type: application/json"\
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -d '{
     "organization":"myorg",
     "name":"My Dev App Collection",
     "description":"My collection for critical apps",
     "environment": "prod",
     "type": "developerApp",
     "members":["app1", "app2"]
    }'

عرض جميع المجموعات باستخدام واجهة برمجة التطبيقات

يمكنك الاطّلاع على جميع التنبيهات والإشعارات من خلال إرسال طلب GET إلى المرجع التالي: https://apimonitoring.enterprise.apigee.com/collections.

يجب إدخال اسم مؤسستك باستخدام مَعلمة طلب البحث org.

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

curl 'https://apimonitoring.enterprise.apigee.com/collections?org=myorg' 
  -X GET
  -H 'Accept: application/json, text/plain, */*' 
  -H "Authorization: Bearer $ACCESS_TOKEN"

في ما يلي مثال على الردّ: 

[{
     "uuid":"1234abcd",
     "organization":"myorg",
     "environment": "prod",
     "name":"My Collection",
     "type": "proxy",
     "members":["proxy1", "proxy2"],
     "description":"My collection for critical APIs",
     "updatedAt":"2018-07-13T16:25:15Z",
     "updatedBy":"joe@acme.com"
}]

اضبط $ACCESS_TOKEN على رمز الوصول عبر OAuth 2.0، كما هو موضّح في مقالة الحصول على رمز وصول عبر OAuth 2.0.

للحصول على معلومات عن خيارات cURL المستخدَمة في هذا المثال، اطّلِع على مقالة استخدام cURL.

يمكنك إلحاق uuid المجموعة بمصدر /collections لعرض المجموعة المحدّدة:

curl 'https://apimonitoring.enterprise.apigee.com/collections/1234abcd?org=myorg'
  -X GET
  -H 'Accept: application/json, text/plain, */*' 
  -H "Authorization: Bearer $ACCESS_TOKEN"