Jak wysyłać bezpośrednie żądania do routerów lub procesorów

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X.
info

Wprowadzenie

Podczas rozwiązywania problemów możesz chcieć wykonywać wywołania interfejsów API bezpośrednio na komponentach Apigee, takich jak router lub procesor wiadomości. Możesz to zrobić, aby:

  • Debugowanie sporadycznych problemów z niektórymi żądaniami API, które wskazują na problem z określonym komponentem Apigee (routerem lub procesorem wiadomości).
  • Zbieraj więcej informacji diagnostycznych, włączając tryb debugowania w konkretnej instancji komponentu Apigee.
  • Wyklucz, że problem jest spowodowany przez konkretny komponent Apigee.
  • Sprawdź, czy operacje takie jak utworzenie nowej instancji lub ponowne uruchomienie instancji mają oczekiwany wpływ.

Wymagania wstępne

  • bezpośredni dostęp do komponentów routera lub procesora wiadomości, w przypadku których trzeba uruchamiać żądania interfejsu API;
  • Narzędzie cURL musi być zainstalowane w konkretnej instancji komponentu.
  • Żądanie do interfejsu API, które chcesz przetestować, w formacie cURL.

    Oto na przykład polecenie curl, którego możesz użyć, aby wysłać żądanie do proxy interfejsu API z komputera lokalnego:

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

Jak wysyłać żądania interfejsu API bezpośrednio do routerów Apigee

Scenariusz 1. Żądania do interfejsu API kierowane do aliasu hosta wskazującego routery

Jeśli wpis DNS aliasu hosta jest skonfigurowany tak, aby wskazywał routery Apigee Edge (czyli nie ma usługi Elastic Load Balancer (ELB)), możesz użyć tych poleceń curl, aby wysyłać żądania API bezpośrednio do routera:

  • Wirtualny host skonfigurowany do komunikacji niezabezpieczonej przez port 80

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

    Na przykład:

    curl -v --resolve myorg-test.mycompany.com:80:127.0.0.1 http://myorg-test.mycompany.com/v1/customers -H 'Authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2'
    
  • Wirtualny host jest skonfigurowany do kończenia połączeń SSL na porcie 443 na routerze.

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

    Na przykład:

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

Scenariusz 2. Żądania do interfejsu API kierowane do aliasu hosta wskazującego na ELB

Jeśli wpis DNS aliasu hosta jest skonfigurowany tak, aby wskazywał Elastic Load Balancer (ELB), możesz użyć tych poleceń curl, aby wysyłać żądania API bezpośrednio do routera:

  • Host wirtualny skonfigurowany do komunikacji niezabezpieczonej przez port 80

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

    Na przykład:

    curl -v --resolve myorg-test.mycompany.com:80:127.0.0.1 http://myorg-test.mycompany.com/v1/customers -H 'Authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2'
    
  • Host wirtualny skonfigurowany dla portu o wysokim numerze, a protokół SSL jest kończony na systemie równoważenia obciążenia przed routerem Apigee

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

    Na przykład:

    curl -v --resolve myorg-test.mycompany.com:19001:127.0.0.1 http://myorg-test.mycompany.com/v1/customers -H 'authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2'
    
  • Host wirtualny skonfigurowany dla portu o wysokim numerze, a protokół SSL jest kończony na routerze Apigee

    Innymi słowy, system równoważenia obciążenia jest skonfigurowany tak, aby używać przekazywania TCP do routera Apigee.

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

    Na przykład:

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

Jak wysyłać żądania bezpośrednio do procesorów wiadomości Apigee

Scenariusz 1. Żądanie do interfejsu API do procesora wiadomości przez domyślny port 8998

Domyślny port, na którym procesor wiadomości nasłuchuje ruchu z routera Apigee, to 8998. Dlatego we wszystkich przypadkach, w których ten port nie został zmieniony, ruch musi być wysyłany bezpośrednio do tego portu na konkretnej instancji procesora wiadomości, jak w tym przykładzie. Żądanie curl musi zostać wysłane na adres URL http://INTERNAL_IP_OF_MP:8998 wraz z nagłówkiem X-Apigee.Host o wartości nazwy hosta, w tym portu używanego w hostach wirtualnych, jak pokazano w tych 3 przykładach:

  • Host wirtualny jest skonfigurowany pod kątem zakończenia SSL na routerze.

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

    Na przykład:

    curl -v http://10.10.53.115:8998/v1/customers -H 'Authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2' -H 'X-Apigee.Host: myorg-test.mycompany.com:443'
    
  • Host wirtualny jest skonfigurowany dla „wysokiego portu”, a zakończenie SSL następuje w systemie równoważenia obciążenia LUB w routerze Apigee:

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

    Na przykład:

    curl -v http://10.10.53.115:8998/v1/customers -H 'Authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2' -H 'X-Apigee.Host: myorg-test.mycompany.com:19001'
    
  • Host wirtualny jest skonfigurowany na domyślny port HTTP 80.

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

    Na przykład:

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

Scenariusz 2. Żądanie do interfejsu API do procesora komunikatów przez protokół SSL port 8443

Można skonfigurować komunikację SSL między routerem a procesorem wiadomości. W przykładach poniżej użyto portu 8443, który jest sugerowany w dokumentacji Apigee.

  • Host wirtualny jest skonfigurowany pod kątem zakończenia SSL na routerze.

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

    Na przykład:

    curl -v https://10.10.53.115:8443/v1/customers -H 'Authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2' -H 'X-Apigee.Host: myorg-test.mycompany.com:80'
    
  • Host wirtualny jest skonfigurowany pod kątem zakończenia SSL w systemie równoważenia obciążenia, a ruch jest przekierowywany do routera na wysokim porcie.

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

    Na przykład:

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