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 giderme sırasında API'leri doğrudan yönlendirici veya mesaj işlemcisi gibi Apigee bileşenlerinde yürütmek isteyebilirsiniz. Örneğin, bunu aşağıdaki amaçlarla yapmak isteyebilirsiniz:

  • Belirli bir Apigee bileşeniyle (yönlendirici/mesaj işlemci) ilgili bir soruna işaret eden, belirli API isteklerinde ara sıra ortaya çıkan sorunlarda hata 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ı belirtin.
  • Yeni bir örnek oluşturma veya örneği yeniden başlatma gibi işlemlerin istenen etkiyi yaratıp yaratmadığını keşfedin.

Ön koşullar

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

  • Test etmek istediğiniz API isteği cURL biçimindedir.

    Örneğin, yerel makinenizden bir API proxy'sine istek göndermek 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önlendiricilerde çalıştırma

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

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

  • Bağlantı noktası 80 ü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, SSL'yi yönlendiricideki 443 numaralı bağlantı noktasında sonlandıracak şekilde yapılandırıldı

    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 ana makine takma adına API istekleri

Ana makine takma adının DNS girişi bir Elastik Yük Dengeleyiciyi (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:

  • Bağlantı noktası 80 ü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ı ve SSL için yapılandırılan sanal ana makine, Apigee yönlendiricinin önündeki 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 son buluyor

    Başka bir deyişle, yük dengeleyici, Apigee yönlendiriciye 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 yönelik istek çalıştırma

Senaryo 1: 8998 numaralı varsayılan bağlantı noktası üzerinden mesaj işleyiciye API isteği

Mesaj işlemcisinin, Apigee yönlendiriciden 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 durumlar için trafiğin belirli bir mesaj işleyici örneğinde aşağıdaki örnekte olduğu gibi doğrudan bu bağlantı noktasına gönderilmesi gerekir. Curl isteği, aşağıdaki üç örnekte gösterildiği gibi, sanal ana makinelerde kullanılan bağlantı noktası da dahil olmak üzere ana makine adı değerini içeren X-Apigee.Host başlığıyla birlikte http://INTERNAL_IP_OF_MP:8998 URL'sine gönderilmelidir:

  • Sanal ana makine, yönlendiricide SSL sonlandırılacak şekilde yapılandırılmış

    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ılır. SSL sonlandırma işlemi bir yük dengeleyicide VEYA Apigee yönlendiricide 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: 8443 numaralı SSL bağlantı noktası üzerinden mesaj işleyiciye API isteği

Yönlendirici ve mesaj işlemcisi arasındaki SSL iletişimini yapılandırmak mümkündür. Aşağıdaki örneklerde, Apigee belgeleri tarafından önerilen bağlantı noktası olan 8443 numaralı bağlantı noktası kullanılmıştır.

  • Sanal ana makine, yönlendiricide SSL sonlandırılacak şekilde yapılandırılmış

    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'yi sonlandıracak şekilde yapılandırılır ve trafik, yönlendiriciye giden 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'