نحوه ایجاد درخواست‌های مستقیم API به مسیریاب‌ها یا پردازشگرهای پیام

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید. اطلاعات

مقدمه

هنگام عیب‌یابی، ممکن است بخواهید «میاناهای برنامه‌سازی کاربردی» را مستقیماً دربرابر عناصر Apigee مثل مسیریاب یا پردازشگر پیام اجرا کنید. برای مثال، ممکن است بخواهید این کار را برای موارد زیر انجام دهید:

  • عیب‌یابی کردن مشکلات متناوب با درخواست‌های API خاص که به مشکلی در یک عنصر Apigee خاص (روتر/پردازشگر پیام) اشاره دارند.
  • با فعال کردن حالت اشکال‌زدایی در نمونه خاصی از عنصر Apigee، اطلاعات تشخیصی بیشتری جمع‌آوری کنید.
  • مطمئن شوید که مشکل ناشی از یک عنصر خاص Apigee نیست.
  • ببینید آیا عملیاتی مثل ایجاد نمونه جدید یا بازراه‌اندازی نمونه تأثیر مطلوب را دارد یا نه.

پیش‌نیازها

  • دسترسی مستقیم به مؤلفه‌های پردازشگر پیام یا مسیریاب که درخواست‌های API باید در آن‌ها اجرا شود.
  • ابزار cURL باید در نمونه خاص عنصر نصب شود.

  • درخواست API که می‌خواهید در قالب cURL آزمایش کنید.

    برای مثال، در اینجا curl فرمانی وجود دارد که می‌توانید از آن برای درخواست به یک پراکسی API از دستگاه محلی خود استفاده کنید:

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

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

نحوه اجرای مستقیم درخواست‌های API دربرابر مسیریاب‌های Apigee

سناریو ۱: درخواست‌های API به نام مستعار میزبان که به روترها اشاره می‌کند

اگر ورودی «دی‌ان‌اس» نام مستعار میزبان پیکربندی شده باشد تا به مسیریاب‌های Apigee Edge اشاره کند (به‌عبارت دیگر، «ترازکننده بار انعطاف‌پذیر» (ELB) وجود ندارد)، می‌توانید از دستورات curl زیر برای ایجاد درخواست‌های API مستقیماً به مسیریاب استفاده کنید:

  • میزبان مجازی برای ارتباط غیرامن ازطریق درگاه ۸۰ پیکربندی شده است

    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 را در درگاه ۴۴۳ در روتر خاتمه دهد

    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'

سناریو ۲: درخواست‌های میانای برنامه‌سازی کاربردی به نام مستعار میزبان که به ELB اشاره می‌کند

اگر ورودی ساناد نام مستعار میزبان پیکربندی شده باشد تا به «ترازکننده بار انعطاف‌پذیر» (ELB) اشاره کند، می‌توانید از دستورات curl زیر برای ارسال مستقیم درخواست‌های میانای برنامه‌سازی کاربردی به مسیریاب استفاده کنید:

  • میزبان مجازی برای ارتباط غیرامن ازطریق درگاه ۸۰ پیکربندی شده است

    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'

  • میزبان مجازی برای درگاه بالا پیکربندی شده است و SSL در روتر 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

سناریو ۱: درخواست میانای برنامه‌سازی کاربردی به پردازشگر پیام ازطریق درگاه پیش‌فرض ۸۹۹۸

درگاه پیش‌فرض که پردازشگر پیام در آن به ترافیک از مسیریاب Apigee گوش می‌دهد ۸۹۹۸ است. بنابراین، در همه مواردی که این درگاه تغییر نکرده است، ترافیک باید مستقیماً به این درگاه در نمونه پردازشگر پیام خاصی ارسال شود، همان‌طور که در مثال زیر نشان داده شده است. درخواست curl باید به نشانی وب 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 یعنی ۸۰ پیکربندی شده است

    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'

سناریو ۲: درخواست API به پردازشگر پیام ازطریق درگاه SSL 8443

می‌توانید ارتباط SSL را بین مسیریاب و پردازشگر پیام پیکربندی کنید. مثال‌های زیر از درگاه ۸۴۴۳، درگاهی که در مستندات 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'