Yönlendiricilere veya mesaj işlemcilerine doğrudan API isteği gönderme

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri. bilgi

Giriş

Sorun giderme sırasında API'leri doğrudan yönlendirici veya mesaj işlemcisi gibi Apigee bileşenleri üzerinde çalıştırmak isteyebilirsiniz. Örneğin, bunu şu amaçlarla yapmak isteyebilirsiniz:

  • Belirli bir API isteklerinde, belirli bir Apigee bileşeniyle (yönlendirici/mesaj işlemcisi) ilgili soruna işaret eden aralıklı sorunları ayıklayın.
  • Bir Apigee bileşeninin belirli bir örneğinde hata ayıklama modunu etkinleştirerek daha fazla teşhis bilgisi toplayın.
  • Sorunun belirli bir Apigee bileşeninden kaynaklandığını unutmayın.
  • Yeni bir örnek oluşturma veya örneği yeniden başlatma gibi işlemlerin istenen etkiye sahip olup olmadığını keşfedin.

Ön koşullar

  • API isteklerinin çalıştırılması gereken yönlendiriciye veya mesaj işlemci bileşenlerine doğrudan erişim.
  • cURL aracının, bileşenin belirli bir örneğine yüklenmesi gerekir.

  • cURL biçiminde test etmek istediğiniz API isteği.

    Örneğin, yerel makinenizden bir API proxy'sine istekte bulunmak için kullanabileceğiniz bir curl komutunu aşağıda görebilirsiniz:

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

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

Doğrudan Apigee yönlendiricilerinde API istekleri çalıştırma

1. Senaryo: Yönlendiricilere işaret eden takma ad barındırmaya yönelik API istekleri

Ana makine takma adının DNS girişi, Apigee Edge yönlendiricilerine işaret edecek şekilde yapılandırılmışsa (yani Esnek Yük Dengeleyici (ELB) yoksa) API isteklerini doğrudan bir yönlendiriciye göndermek için aşağıdaki curl komutlarını kullanabilirsiniz:

  • 80 numaralı bağlantı noktası üzerinden güvenli olmayan iletişim için yapılandırılmış sanal ana makine

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

    Örneğin:

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

  • Sanal ana makine, yönlendiricideki 443 numaralı bağlantı noktasında SSL'yi sonlandıracak şekilde yapılandırılmıştır

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

    Örneğin:

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

2. Senaryo: ELB'lere işaret eden takma ad barındırmaya yönelik API istekleri

Ana makine takma adının DNS girişi, Esnek Yük Dengeleyici'ye (ELB) işaret edecek şekilde yapılandırılmışsa API isteklerini doğrudan bir yönlendiriciye göndermek için aşağıdaki curl komutlarını kullanabilirsiniz:

  • 80 numaralı bağlantı noktası üzerinden güvenli olmayan iletişim için yapılandırılmış sanal ana makine

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

    Örneğin:

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

  • Yüksek bir bağlantı noktası için yapılandırılan sanal ana makine ve SSL, Apigee yönlendiricisinin önündeki bir yük dengeleyicide sonlandırılır

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

    Örneğin:

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

  • Yüksek bir bağlantı noktası için yapılandırılmış sanal ana makine ve SSL, Apigee yönlendiricide sonlanıyor

    Başka bir deyişle, yük dengeleyici Apigee yönlendiricisine TCP geçişini kullanacak şekilde yapılandırılmıştır.

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

    Örneğin:

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

Doğrudan Apigee mesaj işlemcilerine karşı istek çalıştırma

Senaryo 1: Varsayılan bağlantı noktası 8998 üzerinden mesaj işlemcisi için API isteği

Mesaj işlemcisinin, Apigee yönlendiricisinden gelen trafiği dinlediği varsayılan bağlantı noktası 8998'dir. Bu nedenle, bu bağlantı noktasının değiştirilmediği tüm durumlarda trafiğin, aşağıdaki örnekte olduğu gibi belirli bir mesaj işlemcisi örneğinde doğrudan bu bağlantı noktasına gönderilmesi gerekir. Curl isteğinin, aşağıdaki üç örnekte gösterildiği gibi, sanal ana makinelerde kullanılan bağlantı noktası da dahil olmak üzere ana makine değeriyle birlikte X-Apigee.Host başlığıyla birlikte http://INTERNAL_IP_OF_MP:8998 URL'sine gönderilmesi gerekir:

  • Sanal ana makine, yönlendiricide SSL sonlandırma için yapılandırıldı

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

    Örneğin:

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

  • Sanal ana makine "yüksek bağlantı noktası" için yapılandırılmış ve SSL sonlandırması bir yük dengeleyicide VEYA Apigee yönlendiricisinde gerçekleşir:

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

    Örneğin:

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

  • Sanal ana makine varsayılan http bağlantı noktası 80 olarak yapılandırıldı

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

    Örneğin:

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

Senaryo 2: SSL bağlantı noktası 8443 üzerinden mesaj işlemcisi için API isteği

Yönlendirici ile mesaj işlemcisi arasındaki SSL iletişiminin yapılandırılması mümkündür. Aşağıdaki örneklerde Apigee belgeleri tarafından önerilen bağlantı noktası olan 8443 kullanılmaktadır.

  • Sanal ana makine, yönlendiricide SSL sonlandırma için yapılandırıldı

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

    Örneğin:

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

  • Sanal ana makine, yük dengeleyicide SSL sonlandırma için yapılandırılır ve trafik, yönlendiriciye yüksek bir bağlantı noktasına yönlendirilir.

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

    Örneğin:

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