<ph type="x-smartling-placeholder"></ph>
현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서. 정보
소개
문제를 해결할 때는 라우터 또는 메시지 프로세서와 같은 Apigee 구성요소에 대해 직접 API를 실행해야 할 수 있습니다. 예를 들어 다음과 같이 할 수 있습니다.
- 특정 Apigee 구성요소 (라우터/메시지 프로세서)의 문제를 가리키는 특정 API 요청의 간헐적인 문제를 디버그합니다.
- Apigee 구성요소의 특정 인스턴스에서 디버그 모드를 사용 설정하여 더 많은 진단 정보를 수집하세요.
- 특정 Apigee 구성요소로 인해 발생한 문제인지는 배제합니다.
- 새 인스턴스 생성 또는 인스턴스 다시 시작과 같은 작업이 원하는 영향을 주는지 확인합니다.
기본 요건
- API 요청을 실행해야 하는 라우터 또는 메시지 프로세서 구성요소에 직접 액세스합니다.
- cURL 도구는 구성요소의 특정 인스턴스에 설치해야 합니다.
cURL 형식으로 테스트할 API 요청입니다.
예를 들어 다음은 로컬 머신에서 API 프록시에 요청하는 데 사용할 수 있는
curl명령어입니다.curl https://myorg-test.mycompany.com/v1/customers -H 'Authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2'curl https://myorg-test.mycompany.com/v1/customers
Apigee 라우터에서 직접 API 요청을 실행하는 방법
시나리오 1: 라우터를 가리키는 호스트 별칭에 대한 API 요청
호스트 별칭의 DNS 항목이 Apigee Edge 라우터를 가리키도록 구성된 경우 (즉, Elastic Load Balancer (ELB)가 없음) 다음 curl 명령어를 사용하여 API를 라우터에 직접 요청할 수 있습니다.
포트 80을 통한 비보안 통신을 위해 구성된 가상 호스트
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'가상 호스트가 라우터의 포트 443에서 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'
시나리오 2: ELB를 가리키는 호스트 별칭에 대한 API 요청
호스트 별칭의 DNS 항목이 Elastic Load Balancer (ELB)를 가리키도록 구성된 경우 다음 curl 명령어를 사용하여 API를 라우터에 직접 요청할 수 있습니다.
포트 80을 통한 비보안 통신을 위해 구성된 가상 호스트
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 라우터에서 종료됨
즉, 부하 분산기는 Apigee 라우터에 대한 TCP 패스 스루를 사용하도록 구성되어 있습니다.
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 메시지 프로세서에 대해 직접 요청을 실행하는 방법
시나리오 1: 기본 포트 8998을 통해 메시지 프로세서에 대한 API 요청
메시지 프로세서가 Apigee 라우터의 트래픽을 리슨하는 기본 포트는 8998입니다. 따라서 이 포트가 변경되지 않은 모든 경우에 트래픽을 다음 예와 같이 특정 메시지 프로세서 인스턴스의 이 포트로 직접 전송해야 합니다. curl 요청은 다음 3개의 예에 나와 있는 것처럼 가상 호스트에 사용되는 포트를 포함한 호스트 이름 값과 함께 X-Apigee.Host 헤더와 함께 URL http://INTERNAL_IP_OF_MP:8998로 전송해야 합니다.
가상 호스트가 라우터에서 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 포트 80으로 구성됨
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'
시나리오 2: SSL 포트 8443을 통해 메시지 프로세서에 대한 API 요청
라우터와 메시지 프로세서 간에 SSL 통신을 구성할 수 있습니다. 다음 예시에서는 Apigee 문서에서 권장하는 포트인 포트 8443을 사용합니다.
가상 호스트가 라우터에서 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'