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

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Giriş

Sorun giderirken API'leri doğrudan yönlendirici veya mesaj işlemcisi gibi Apigee bileşenlerine karşı yürütmek isteyebilirsiniz. Örneğin, bu işlemi şu amaçlarla yapmak isteyebilirsiniz:

  • Belirli API istekleriyle ilgili aralıklı sorunları ayıklayın. Bu sorunlar, belirli bir Apigee bileşeniyle (yönlendirici/mesaj işleyici) ilgili bir soruna işaret eder.
  • 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 kaynaklanmadığından emin olun.
  • Yeni bir örnek oluşturma veya örneği yeniden başlatma gibi işlemlerin istenen etkiyi sağlayıp sağlamadığını öğrenin.

Ön koşullar

  • API isteklerinin çalıştırılması gereken yönlendirici veya mesaj işlemcisi bileşenlerine doğrudan erişim.
  • cURL aracı, bileşenin ilgili örneğine yüklenmelidir.

  • 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 komutu aşağıda verilmiştir:

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

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

API isteklerini doğrudan Apigee yönlendiricilere karşı çalıştırma

Senaryo 1: Yönlendiricileri işaret eden ana makine takma adına yönelik API istekleri

Ana makine takma adının DNS girişi Apigee Edge yönlendiricilerine yönlendirilecek şekilde yapılandırılmışsa (diğer bir deyişle, Elastic Load Balancer (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ış

    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'leri işaret eden ana makine takma adlarına yönelik API istekleri

Ana makine takma adının DNS girişi bir Elastic Load Balancer'a (ELB) yönlendirilecek ş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 bağlantı noktası için yapılandırılmış sanal ana makine ve SSL, Apigee yönlendiricisinin önündeki bir yük dengeleyicide sonlandırılıyor

    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 bağlantı noktası için yapılandırılmış sanal ana makine ve SSL, Apigee yönlendiricide sonlandırılıyor

    Başka bir deyişle, yük dengeleyici, Apigee yönlendiricisine TCP geçişini kullanacak şekilde yapılandırılı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'

İstekleri doğrudan Apigee mesaj işlemcilerine karşı çalıştırma

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

İleti işlemcinin 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, trafik aşağıdaki örnekte olduğu gibi belirli bir ileti işlemci örneğindeki bu bağlantı noktasına doğrudan gönderilmelidir. Curl isteği, aşağıdaki üç örnekte gösterildiği gibi sanal ana makinede kullanılan bağlantı noktası da dahil olmak üzere ana makine adı değerine sahip X-Apigee.Host başlığıyla birlikte http://INTERNAL_IP_OF_MP:8998 URL'sine gönderilmelidir:

  • Sanal ana makine, yönlendiricide SSL sonlandırma için yapılandırılmış olmalıdır.

    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 bir Apigee yönlendiricide gerçekleşiyor:

    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ılır.

    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'

2. Senaryo: SSL bağlantı noktası 8443 üzerinden ileti işlemcisine API isteği

Yönlendirici ile ileti işlemcisi arasında SSL iletişimi yapılandırılabilir. Aşağıdaki örneklerde, Apigee belgelerinde önerilen bağlantı noktası olan 8443 numaralı bağlantı noktası kullanılmaktadır.

  • Sanal ana makine, yönlendiricide SSL sonlandırma için yapılandırılmış olmalıdır.

    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'