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

يتم الآن عرض مستندات 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))، يمكنك استخدام أوامر 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: طلبات واجهة برمجة التطبيقات لاستضافة اسم مستعار يشير إلى ELBs

إذا تم ضبط إدخال نظام أسماء النطاقات للاسم المستعار للمضيف بحيث يشير إلى جهاز موازنة حمل المرونة (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'

  • يتم ضبط المضيف الافتراضي لـ "منفذ عالٍ"، ويتم إنهاء طبقة المقابس الآمنة على جهاز موازنة الحمل أو على جهاز توجيه 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: طلب واجهة برمجة التطبيقات إلى معالج الرسائل عبر منفذ طبقة المقابس الآمنة 8443

يمكن إعداد اتصال طبقة المقابس الآمنة بين جهاز التوجيه ومعالج الرسائل. تستخدم الأمثلة التالية المنفذ 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'

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

    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'