استخدام واجهة برمجة التطبيقات API Monitoring Management

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

استخدِم واجهة برمجة التطبيقات API Monitoring management API لتنفيذ المهام التالية:

المهمة مزيد من المعلومات
إدارة التنبيهات لميزة "مراقبة واجهة برمجة التطبيقات"
إدارة المجموعات لتتبُّع واجهة برمجة التطبيقات
عرض سجلّات مراقبة واجهة برمجة التطبيقات على مستويات مختلفة
عرض مقاييس مراقبة واجهة برمجة التطبيقات

حصص طلبات البيانات من واجهة برمجة التطبيقات

تفرض جميع واجهات برمجة التطبيقات لمراقبة واجهة برمجة التطبيقات حصة تحدّ من عدد المرات التي يمكنك فيها طلب البيانات من واجهة برمجة التطبيقات كل دقيقة. على سبيل المثال، تسمح لك واجهة برمجة التطبيقات Create collections بإجراء ستة طلبات بيانات في الدقيقة.

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

استخدام curl

تستخدِم أمثلة واجهة برمجة التطبيقات في هذا المستند curl لشرح كيفية استخدام ميزة "مراقبة واجهة برمجة التطبيقات" باستخدام واجهة برمجة التطبيقات. وcurl هي أداة سطر أوامر مفتوحة المصدر لنقل البيانات باستخدام بنية URL، وهي متوافقة مع البروتوكولات الشائعة مثل HTTP وHTTPS. للحصول على معلومات عن تنزيل أداة curl واستخدامها، يُرجى الاطّلاع على https://curl.haxx.se/.

يلخّص الجدول التالي خيارات سطر الأوامر curl المستخدَمة في الأمثلة.

الخيار الوصف
-d '{}'

--data @filename

يحدِّد نص الطلب الذي يتم تمريره مباشرةً أو من خلال تحديد اسم ملف.
-H

--header

تُحدِّد عنوان طلب. يجب إدخال المعلومات التالية في رأس الطلب:
  • رمز OAuth 2.0 المميّز لمصادقة المستخدم باستخدام الرأس Authorization، كما هو موضّح في مقالة الحصول على رمز وصول OAuth 2.0.
  • أنواع المحتوى المتوافقة مع العميل باستخدام العنوان Accept
  • نوع المحتوى لنص الطلب الذي يتم إرساله عند إنشاء مرجع (POST أو PATCH أو PUT) أو تعديله باستخدام الرأس Content-Type.
-i تعرِض هذه الطريقة المزيد من المعلومات في الاستجابة، مثل الرؤوس.
-X تُحدِّد نوع الطلب (GET وPOST وما إلى ذلك).

الحصول على رمز دخول عبر OAuth 2.0

يتيح Apigee Edge استخدام بروتوكول OAuth 2.0 لمصادقة المستخدمين. باستخدام بروتوكول OAuth 2.0، يمكنك استبدال بيانات اعتمادك في Apigee Edge برمز وصول ورمز إعادة تحميل يمكنك استخدامهما بعد ذلك لإجراء طلبات آمنة إلى واجهة برمجة التطبيقات Apigee Edge API. بعد الحصول على رمز مميّز، لن تحتاج إلى تبادل بيانات الاعتماد مرة أخرى إلى أن تنتهي صلاحية الرمز المميّز. يتيح لك رمز إعادة التنشيط إبقاء "جلستك" مع الخادم نشطة لفترة أطول بدون تقديم بيانات اعتمادك. لمزيد من المعلومات عن الرموز المميّزة للوصول، يُرجى الاطّلاع على استخدام بروتوكول OAuth2 للوصول إلى Management API.

باستخدام بيانات اعتماد Apigee Edge، يمكنك الحصول على رموز الوصول وإعادة التنشيط من OAuth 2.0 للوصول إلى موارد Apigee Edge باستخدام الأداة get_token من Apigee.

للحصول على رمز دخول عبر OAuth 2.0:

  1. ثبِّت الأداة get_token. للحصول على معلومات عن كيفية تثبيت الأداة get_token، اطّلِع على مقالة استخدام get_token.

  2. نفِّذ get_token للحصول على رمز دخول عبر OAuth 2.0.

    في المرة الأولى التي تُدخل فيها الأمر أو إذا انتهت صلاحية رمز إعادة التنشيط، سيطلب منك get_token اسم المستخدم وكلمة المرور ورمز المصادقة الثنائية المكوّن من ستة أرقام. أدخِل كل قيمة عندما يُطلب منك ذلك. إذا لم تكن المصادقة الثنائية مفعّلة، ما عليك سوى الضغط على مفتاح Enter عند ظهور الطلب.

  3. انسخ الرمز المميّز لبروتوكول OAuth 2.0 واحفظه في متغيّر، مثل ACCESS_TOKEN: 

    export ACCESS_TOKEN=eyJhbGciOiJSUzI1NiJ9.eyJqdGkiOiI2NmQ4MTRiMC01YzZkLTQyZWUtYjlmYi05ZGVhODk5MGRiODIiLCJzdWIiOiJlZjc3YmRhMS05ZWIxLTQyZDgtODg5MC0zODQ3ODg0MzM1OWIiLCJzY29wZSI6WyJzY2ltLmVtYWlscy5yZWFkIiwicGFzc3dvcmQud3JpdGUiLCJhcHByb3ZhbHMubWUiLCJzY2ltLm1lIiwic2NpbS5pZHMucmVhZCIsIm9wZW5pZCIsIm9hdXRoLmFwcHJvdmFscyJdLCJjbGllbnRfaWQiOiJlZGdlY2xpIiwiY2lkIjoiZWRnZWNsaSIsImF6cCI6ImVkZ2VjbGkiLCJncmFudF90eXBlIjoicGFzc3dvcmQiLCJ1c2VyX2lkIjoiZWY3N2JkYTEtOWViMS00MmQ4LTg4OTAtMzg0Nzg4NDMzNTliIiwib3JpZ2luIjoidXNlcmdyaWQiLCJ1c2VyX25hbWUiOiJsbHluY2hAYXBpZ2VlLmNvbSIsImVtYWlsIjoibGx5bmNoQGFwaWdlZS5jb20iLCJyZXZfc2lnIjoiZTViZDc3NjIiLCJpYXQiOjE0NzA3NTMyMDksImV4cCI6MTQ3MDc5NjQwOSwiaXNzIjoiaHR0cHM6Ly9sb2dpbi5lMmUuYXBpZ2VlLm5ldC9vYXV0aC90b2tlbiIsInppZCI6InVhYSIsImF1ZCI6WyJzY2ltIiwicGFzc3dvcmQiLCJvcGVuaWQiLCJlZGdlY2xpIiwiYXBwcm92YWxzIiwic2NpbS5lbWFpbHMiLCJzY2ltLmlkcyIsIm9hdXRoIl19.FF3f1i9eHbBqYjnvBmt9nTtTcyNQBQRDDq2tQ3aRUAzUesLAet7qfBB9QVCvE-zVBn4BiPgRU-iturxPxRMAQ2a34-8oLvgff3x-aALBWkSwbc8PJdWTiPP9VYykoFSJtu9UIN5x0FQEQN_hyurO8D2SrS3uQKNwIyjoJPy4Bps7nb3WqJyKRfXAzf8UptdN7XE0TVqTyBcZGT3OQ2Was0VPfe_dr-wIrywvjNf6FczjdktB1lpKJ2oRXx1n8PuK5FhOQ4wE9VeSsNsMHVcGvJ5W6Tvi61fo2h1w1d4AKvGdERzuVf_XWN00mtcgwsUAuXV0r5H_i3vxcMuUym1XOg

عند طلب بيانات من واجهة برمجة التطبيقات API Monitoring API، عليك تمرير رمز الوصول OAuth 2.0 في رأس HTTP باستخدام الرأس Authorization. على سبيل المثال:


curl -X GET "https://apimonitoring.enterprise.apigee.com/alerts?org=myorg"
   -H "Authorization: Bearer $ACCESS_TOKEN" 
   ...