Cách gửi yêu cầu API trực tiếp đến bộ định tuyến hoặc bộ xử lý thông báo

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X.
thông tin

Giới thiệu

Khi khắc phục sự cố, bạn có thể muốn thực thi các API trực tiếp đối với các thành phần Apigee, chẳng hạn như bộ định tuyến hoặc trình xử lý thông báo. Ví dụ: bạn có thể muốn làm việc này để:

  • Gỡ lỗi các vấn đề không liên tục với một số yêu cầu API nhất định cho thấy vấn đề với một thành phần Apigee cụ thể (bộ định tuyến/trình xử lý thông báo).
  • Thu thập thêm thông tin chẩn đoán bằng cách bật chế độ gỡ lỗi trên một phiên bản cụ thể của thành phần Apigee.
  • Loại trừ trường hợp vấn đề do một thành phần Apigee cụ thể gây ra.
  • Khám phá xem các thao tác như tạo một phiên bản mới hoặc khởi động lại phiên bản có tác động như mong muốn hay không.

Điều kiện tiên quyết

  • Truy cập trực tiếp vào các thành phần bộ định tuyến hoặc bộ xử lý thông báo mà các yêu cầu API cần chạy.
  • Bạn cần cài đặt công cụ cURL trên một phiên bản cụ thể của thành phần.
  • Yêu cầu API mà bạn muốn kiểm thử ở định dạng cURL.

    Ví dụ: sau đây là một lệnh curl mà bạn có thể dùng để gửi yêu cầu đến một proxy API từ máy cục bộ:

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

Cách chạy các yêu cầu API trực tiếp đối với các bộ định tuyến Apigee

Tình huống 1: Yêu cầu API đến bí danh máy chủ trỏ đến các bộ định tuyến

Nếu mục DNS của bí danh máy chủ được định cấu hình để trỏ đến các bộ định tuyến Apigee Edge (nói cách khác, không có Bộ cân bằng tải linh hoạt (ELB)), thì bạn có thể sử dụng các lệnh curl sau để đưa ra yêu cầu API trực tiếp đến một bộ định tuyến:

  • Máy chủ ảo được định cấu hình để giao tiếp không an toàn qua cổng 80

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

    Ví dụ:

    curl -v --resolve myorg-test.mycompany.com:80:127.0.0.1 http://myorg-test.mycompany.com/v1/customers -H 'Authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2'
    
  • Máy chủ ảo được định cấu hình để chấm dứt SSL trên cổng 443 trên bộ định tuyến

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

    Ví dụ:

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

Tình huống 2: Yêu cầu API đến bí danh máy chủ trỏ đến ELB

Nếu mục DNS của bí danh máy chủ được định cấu hình để trỏ đến một Trình cân bằng tải linh hoạt (ELB), thì bạn có thể sử dụng các lệnh curl sau đây để gửi trực tiếp các yêu cầu API đến một bộ định tuyến:

  • Máy chủ ảo được định cấu hình để giao tiếp không an toàn qua cổng 80

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

    Ví dụ:

    curl -v --resolve myorg-test.mycompany.com:80:127.0.0.1 http://myorg-test.mycompany.com/v1/customers -H 'Authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2'
    
  • Máy chủ ảo được định cấu hình cho một cổng có số hiệu cao và SSL kết thúc trên một trình cân bằng tải ở phía trước bộ định tuyến Apigee

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

    Ví dụ:

    curl -v --resolve myorg-test.mycompany.com:19001:127.0.0.1 http://myorg-test.mycompany.com/v1/customers -H 'authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2'
    
  • Máy chủ ảo được định cấu hình cho một cổng có số hiệu lớn và SSL kết thúc trên bộ định tuyến Apigee

    Nói cách khác, bộ cân bằng tải được định cấu hình để sử dụng tính năng truyền trực tiếp TCP cho bộ định tuyến Apigee.

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

    Ví dụ:

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

Cách chạy các yêu cầu trực tiếp đối với trình xử lý thông báo Apigee

Tình huống 1: Yêu cầu API đến trình xử lý tin nhắn thông qua cổng mặc định 8998

Cổng mặc định mà trình xử lý thông báo theo dõi lưu lượng truy cập từ bộ định tuyến Apigee là 8998. Do đó, đối với tất cả các trường hợp mà cổng này không thay đổi, lưu lượng truy cập cần được gửi trực tiếp đến cổng này trên một phiên bản bộ xử lý thông báo cụ thể, như trong ví dụ sau. Bạn phải gửi yêu cầu curl đến URL http://INTERNAL_IP_OF_MP:8998 cùng với tiêu đề X-Apigee.Host có giá trị là tên máy chủ lưu trữ, bao gồm cả cổng được dùng trong máy chủ lưu trữ ảo như minh hoạ trong 3 ví dụ sau:

  • Máy chủ ảo được định cấu hình để chấm dứt SSL trên bộ định tuyến

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

    Ví dụ:

    curl -v http://10.10.53.115:8998/v1/customers -H 'Authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2' -H 'X-Apigee.Host: myorg-test.mycompany.com:443'
    
  • Máy chủ ảo được định cấu hình cho "cổng có số hiệu lớn" và việc chấm dứt SSL diễn ra trên một trình cân bằng tải HOẶC trên một bộ định tuyến Apigee:

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

    Ví dụ:

    curl -v http://10.10.53.115:8998/v1/customers -H 'Authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2' -H 'X-Apigee.Host: myorg-test.mycompany.com:19001'
    
  • Máy chủ ảo được định cấu hình thành cổng http mặc định 80

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

    Ví dụ:

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

Tình huống 2: Yêu cầu API đến trình xử lý thông báo thông qua cổng SSL 8443

Bạn có thể định cấu hình giao tiếp SSL giữa bộ định tuyến và trình xử lý thông báo. Các ví dụ sau đây sử dụng cổng 8443, là cổng được tài liệu của Apigee đề xuất.

  • Máy chủ ảo được định cấu hình để chấm dứt SSL trên bộ định tuyến

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

    Ví dụ:

    curl -v https://10.10.53.115:8443/v1/customers -H 'Authorization: Bearer AxLqyU09GA10lrAiVRQCGXzMi9W2' -H 'X-Apigee.Host: myorg-test.mycompany.com:80'
    
  • Máy chủ ảo được định cấu hình để chấm dứt SSL trên trình cân bằng tải và lưu lượng truy cập được chuyển tiếp đến một cổng có số hiệu cao đến bộ định tuyến

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

    Ví dụ:

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