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

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

مقدمة

عند تحديد المشاكل وحلّها، قد تحتاج إلى تنفيذ واجهات برمجة التطبيقات مباشرةً على مكوّنات 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))، يمكنك استخدام أوامر 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'

  • تم ضبط المضيف الافتراضي على إنهاء طبقة المقابس الآمنة (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'

  • تم إعداد المضيف الافتراضي لمنفذ عالي المستوى، ويتم إنهاء بروتوكول SSL على أداة موازنة الحمل أمام موجّه 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

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

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

    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'

  • تم ضبط المضيف الظاهري على "منفذ عالي" ويتم إنهاء بروتوكول أمان طبقة النقل (TLS) على جهاز موازنة الحمل أو على جهاز توجيه 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'

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

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

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

    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'