كيفية تقديم طلبات مباشرة من واجهة برمجة التطبيقات إلى أجهزة التوجيه أو معالِجات الرسائل

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X. معلومات

مقدمة

عند تحديد المشاكل وحلّها، قد تحتاج إلى تنفيذ واجهات برمجة التطبيقات مباشرةً على مكونات Apigee، مثل جهاز التوجيه أو معالج الرسائل. على سبيل المثال، قد ترغب في إجراء ذلك من أجل:

  • يمكنك تصحيح الأخطاء المتقطّعة في بعض طلبات البيانات من واجهة برمجة التطبيقات التي تشير إلى مشكلة في مكوّن معيّن في Apigee (جهاز التوجيه/معالج الرسائل).
  • اجمع المزيد من معلومات التشخيص من خلال تفعيل وضع تصحيح الأخطاء على مثيل معيّن لمكوِّن Apigee.
  • استبعِد أن تكون المشكلة ناتجة عن مكوِّن معيّن في Apigee.
  • تعرَّف على ما إذا كانت هناك عمليات، مثل بدء مثيل جديد أو إعادة تشغيل المثيل، التأثير المطلوب.

المتطلبات الأساسية

  • الوصول المباشر إلى مكونات جهاز التوجيه أو معالج الرسائل التي يجب تشغيل طلبات واجهة برمجة التطبيقات عليها.
  • يجب تثبيت أداة cURL على المثيل المحدّد من المكوِّن.

  • طلب البيانات من واجهة برمجة التطبيقات الذي تريد اختباره بتنسيق cURL

    على سبيل المثال، إليك أمر curl الذي يمكنك استخدامه لتقديم طلب إلى خادم وكيل لواجهة برمجة التطبيقات من جهازك المحلي:

    curl https://myorg-test.mycompany.com/v1/customers -H 'Authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2'

    curl https://myorg-test.mycompany.com/v1/customers

كيفية تنفيذ طلبات البيانات من واجهة برمجة التطبيقات مباشرةً على أجهزة توجيه Apigee

السيناريو 1: طلبات البيانات من واجهة برمجة التطبيقات إلى العنوان البديل للبريد الإلكتروني الذي يشير إلى أجهزة التوجيه

إذا تم ضبط إدخال نظام أسماء النطاقات للاسم المستعار للمضيف على التوجيه إلى أجهزة توجيه Apigee Edge (بعبارة أخرى، لا يتوفر جهاز موازنة الحمل (ELB))، يمكنك استخدام أوامر التجعيد التالية لإرسال طلبات واجهة برمجة التطبيقات مباشرةً إلى الموجه:

  • تم ضبط المضيف الافتراضي للاتصال غير الآمن عبر المنفذ 80

    curl -v --resolve HOST_ALIAS:80:127.0.0.1 http://HOST_ALIAS/PROXY_BASE_PATH/ -H 'HEADER: VALUE'

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

    curl -v --resolve myorg-test.mycompany.com:80:127.0.0.1 http://myorg-test.mycompany.com/v1/customers -H 'Authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2'

  • تم ضبط المضيف الافتراضي على إنهاء طبقة المقابس الآمنة (SSL) عبر المنفذ 443 على جهاز التوجيه

    curl -v --resolve HOST_ALIAS:443:127.0.0.1 https://HOST_ALIAS/PROXY_BASE_PATH/ -H 'HEADER: VALUE'

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

    curl -v --resolve myorg-test.mycompany.com:443:127.0.0.1 https://myorg-test.mycompany.com/v1/customers -H 'Authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2'

السيناريو 2: طلبات البيانات من واجهة برمجة التطبيقات لمضيف أسماء النطاقات المستعارة الذي يشير إلى ملفات ELB

إذا تم ضبط إدخال نظام أسماء النطاقات للاسم المستعار للمضيف على التوجيه إلى جهاز موازنة الحمل المرن (ELB)، فيمكنك استخدام أوامر curl التالية لإرسال طلبات واجهة برمجة التطبيقات مباشرةً إلى الموجه:

  • تم ضبط المضيف الافتراضي للاتصال غير الآمن عبر المنفذ 80

    curl -v --resolve HOST_ALIAS:80:127.0.0.1 http://HOST_ALIAS/PROXY_BASE_PATH/ -H 'HEADER: VALUE'

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

    curl -v --resolve myorg-test.mycompany.com:80:127.0.0.1 http://myorg-test.mycompany.com/v1/customers -H 'Authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2'

  • المضيف الافتراضي الذي تم إعداده لمنفذ عالي وطبقة المقابس الآمنة ينتهي على جهاز موازنة الحمل أمام جهاز توجيه Apigee

    curl -v --resolve HOST_ALIAS:PORT_NUMBER:127.0.0.1 http:/HOST_ALIAS:PORT_NUMBER/PROXY_BASE_PATH/ -H 'HEADER: VALUE'

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

    curl -v --resolve myorg-test.mycompany.com:19001:127.0.0.1 http://myorg-test.mycompany.com/v1/customers -H 'authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2'

  • المضيف الافتراضي الذي تم ضبطه على منفذ عالي وإنهاء طبقة المقابس الآمنة على جهاز توجيه Apigee

    بمعنى آخر، تم ضبط جهاز موازنة الحمل على استخدام تمرير بروتوكول التحكم بالنقل إلى جهاز توجيه Apigee.

    curl -v --resolve HOST_ALIAS:PORT_NUMBER:127.0.0.1 https:/HOST_ALIAS:PORT_NUMBER/PROXY_BASE_PATH/ -H 'HEADER: VALUE'

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

    curl -v --resolve myorg-test.mycompany.com:19001:127.0.0.1 https://myorg-test.mycompany.com/v1/customers -H 'authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2'

كيفية تنفيذ الطلبات مباشرةً على معالِجات الرسائل في Apigee

السيناريو 1: طلب واجهة برمجة التطبيقات إلى معالج الرسائل عبر المنفذ الافتراضي 8998

المنفذ التلقائي الذي يراقب من خلاله معالج الرسائل حركة البيانات من جهاز توجيه Apigee هو 8998. لذلك، بالنسبة إلى جميع الحالات التي لم يتم فيها تغيير هذا المنفذ، يجب إرسال عدد الزيارات مباشرةً إلى هذا المنفذ على مثيل معيّن لمعالجة الرسائل، كما في المثال التالي. يجب إرسال طلب التمديد إلى عنوان URL http://INTERNAL_IP_OF_MP:8998 مع العنوان X-Apigee.Host مع اسم المضيف القيمة بما في ذلك المنفذ المستخدَم في المضيفات الافتراضية كما هو موضّح في الأمثلة الثلاثة التالية:

  • تم ضبط المضيف الافتراضي على إنهاء طبقة المقابس الآمنة (SSL) على جهاز التوجيه

    curl -v http://INTERNAL_IP_OF_MP:8998/PROXY_BASE_PATH/ -H 'HEADER: VALUE' -H 'X-Apigee.Host: HOST_ALIAS:443'

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

    curl -v http://10.10.53.115:8998/v1/customers -H 'Authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2' -H 'X-Apigee.Host: myorg-test.mycompany.com:443'

  • تم ضبط المضيف الافتراضي على "منفذ عالي". ويحدث إنهاء طبقة المقابس الآمنة (SSL) على جهاز موازنة الحمل أو على جهاز توجيه Apigee:

    curl -v http://INTERNAL_IP_OF_MP:8998/PROXY_BASE_PATH/ -H 'HEADER: VALUE' -H 'X-Apigee.Host: HOST_ALIAS:PORT_NUMBER'

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

    curl -v http://10.10.53.115:8998/v1/customers -H 'Authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2' -H 'X-Apigee.Host: myorg-test.mycompany.com:19001'

  • تم ضبط المضيف الافتراضي على منفذ http 80 التلقائي.

    curl -v http://INTERNAL_IP_OF_MP:8998/PROXY_BASE_PATH/ -H 'HEADER: VALUE' -H 'X-Apigee.Host: HOST_ALIAS:80'

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

    curl -v http://10.10.53.115:8998/v1/customers -H 'Authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2' -H 'X-Apigee.Host: myorg-test.mycompany.com:80'

السيناريو الثاني: طلب واجهة برمجة التطبيقات إلى معالج الرسائل عبر منفذ طبقة المقابس الآمنة 8443

يمكن تهيئة اتصال طبقة المقابس الآمنة بين الموجه ومعالج الرسائل. تستخدم الأمثلة التالية المنفذ 8443، وهو المنفذ الذي اقترحته المستندات في Apigee.

  • تم ضبط المضيف الافتراضي على إنهاء طبقة المقابس الآمنة (SSL) على جهاز التوجيه

    curl -v -k https://INTERNAL_IP_OF_MP:8443/PROXY_BASE_PATH/ -H 'HEADER: VALUE' -H 'X-Apigee.Host: HOST_ALIAS:443'

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

    curl -v https://10.10.53.115:8443/v1/customers -H 'Authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2' -H 'X-Apigee.Host: myorg-test.mycompany.com:80'

  • يتم ضبط المضيف الافتراضي حتى يتم إنهاء طبقة المقابس الآمنة (SSL) على جهاز موازنة الحمل، وتتم إعادة توجيه حركة البيانات إلى منفذ عالي إلى جهاز التوجيه.

    curl -v https://INTERNAL_IP_OF_MP:8443/PROXY_BASE_PATH/ -H 'HEADER: VALUE' -H 'X-Apigee.Host: HOST_ALIAS:PORT_NUMBER'

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

    curl -v https://10.10.53.115:8443/v1/customers -H 'Authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2' -H 'X-Apigee.Host: myorg-test.mycompany.com:19001'