राऊटर या मैसेज प्रोसेसर से सीधे तौर पर एपीआई अनुरोध करने का तरीका

Apigee Edge दस्तावेज़ देखा जा रहा है.
Apigee X दस्तावेज़ पर जाएं. जानकारी

शुरुआती जानकारी

समस्या हल करते समय, हो सकता है कि आप राऊटर या मैसेज प्रोसेसर जैसे Apigee कॉम्पोनेंट पर सीधे एपीआई लागू करना चाहें. उदाहरण के लिए, हो सकता है कि आप इन कामों के लिए ऐसा करना चाहें:

  • कुछ एपीआई अनुरोधों में, रुक-रुककर होने वाली समस्याओं को डीबग करें, जो किसी खास Apigee कॉम्पोनेंट (राउटर/मैसेज प्रोसेसर) में आ रही समस्या की ओर इशारा करती हैं.
  • किसी Apigee कॉम्पोनेंट के किसी इंस्टेंस पर डीबग मोड चालू करके, गड़बड़ी की ज़्यादा जानकारी इकट्ठा करें.
  • किसी खास Apigee कॉम्पोनेंट की वजह से होने वाली समस्या के बारे में बताएं.
  • पता लगाएं कि नए इंस्टेंस को बनाने या इंस्टेंस को रीस्टार्ट करने जैसे ऑपरेशन से आपको मनमुताबिक नतीजे मिल रहे हैं या नहीं.

ज़रूरी शर्तें

  • राऊटर या मैसेज प्रोसेसर के उन कॉम्पोनेंट का सीधा ऐक्सेस जिनके लिए एपीआई अनुरोध चलाने की ज़रूरत है.
  • cURL टूल को कॉम्पोनेंट के किसी खास इंस्टेंस पर इंस्टॉल किया जाना चाहिए.

  • वह एपीआई अनुरोध जिसकी जांच आपको cURL फ़ॉर्मैट में करनी है.

    उदाहरण के लिए, यहां curl कमांड दिया गया है. इसका इस्तेमाल, अपने कंप्यूटर से एपीआई प्रॉक्सी का अनुरोध करने के लिए किया जा सकता है:

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

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

सीधे Apigee राऊटर से एपीआई अनुरोध चलाने का तरीका

पहली स्थिति: राऊटर को पॉइंट करने वाले होस्ट के उपनाम के लिए एपीआई अनुरोध

अगर होस्ट उपनाम की डीएनएस एंट्री को Apigee Edge के राऊटर (दूसरे शब्दों में कहें, तो कोई इलास्टिक लोड बैलेंसर (ईएलबी)) तक ले जाने के लिए कॉन्फ़िगर किया गया है, तो सीधे राऊटर पर एपीआई अनुरोध भेजने के लिए, इन कर्ल कमांड का इस्तेमाल किया जा सकता है:

  • वर्चुअल होस्ट को पोर्ट 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 पर एसएसएल को खत्म करने के लिए कॉन्फ़िगर किया गया है

    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'

दूसरी स्थिति: ईएलबी को पॉइंट करने वाले होस्ट के उपनाम के लिए एपीआई अनुरोध

अगर होस्ट उपनाम की डीएनएस एंट्री को इलास्टिक लोड बैलेंसर (ईएलबी) से कनेक्ट करने के लिए कॉन्फ़िगर किया गया है, तो सीधे राऊटर से एपीआई अनुरोध भेजने के लिए, इन कर्ल कमांड का इस्तेमाल किया जा सकता है:

  • वर्चुअल होस्ट को पोर्ट 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'

  • हाई पोर्ट के लिए कॉन्फ़िगर किया गया वर्चुअल होस्ट और 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'

  • हाई पोर्ट के लिए कॉन्फ़िगर किया गया वर्चुअल होस्ट और Apigee राऊटर पर SSL खत्म हो जाता है

    दूसरे शब्दों में कहें, तो लोड बैलेंसर को Apigee राऊटर पर टीसीपी पास-थ्रू का इस्तेमाल करने के लिए कॉन्फ़िगर किया गया है.

    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 मैसेज प्रोसेस करने वाली कंपनियों के ख़िलाफ़ सीधे तौर पर अनुरोध करने का तरीका

पहली स्थिति: डिफ़ॉल्ट पोर्ट 8998 के ज़रिए मैसेज प्रोसेसर को भेजा जाने वाला एपीआई अनुरोध

वह डिफ़ॉल्ट पोर्ट जिस पर मैसेज प्रोसेसर, Apigee राऊटर से आने वाले ट्रैफ़िक को सुनता है, 8998 है. इसलिए, ऐसे सभी मामलों में जहां इस पोर्ट में बदलाव नहीं किया गया है, वहां ट्रैफ़िक को सीधे इस पोर्ट पर किसी मैसेज प्रोसेसर इंस्टेंस पर भेजा जाना ज़रूरी है, जैसा कि इस उदाहरण में दिखाया गया है. कर्ल अनुरोध को यूआरएल http://INTERNAL_IP_OF_MP:8998 के साथ हेडर X-Apigee.Host के साथ वैल्यू होस्टनेम के साथ भेजा जाना चाहिए. इसमें वर्चुअल होस्ट में इस्तेमाल किया गया पोर्ट भी शामिल है, जैसा कि इन तीन उदाहरणों में दिखाया गया है:

  • वर्चुअल होस्ट को राऊटर पर एसएसएल बंद करने के लिए कॉन्फ़िगर किया गया है

    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'

  • वर्चुअल होस्ट को "हाई पोर्ट" के लिए कॉन्फ़िगर किया गया हो और एसएसएल हटने की प्रोसेस लोड बैलेंसर या 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'

  • वर्चुअल होस्ट को डिफ़ॉल्ट एचटीटीपी पोर्ट 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'

दूसरी स्थिति: एसएसएल पोर्ट 8443 के ज़रिए मैसेज प्रोसेसर को मैसेज भेजने के लिए एपीआई अनुरोध

राऊटर और मैसेज प्रोसेसर के बीच एसएसएल कम्यूनिकेशन को कॉन्फ़िगर करना संभव है. नीचे दिए गए उदाहरणों में पोर्ट 8443 का इस्तेमाल किया गया है. यह पोर्ट Apigee दस्तावेज़ के सुझाए गए है.

  • वर्चुअल होस्ट को राऊटर पर एसएसएल बंद करने के लिए कॉन्फ़िगर किया गया है

    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'

  • वर्चुअल होस्ट को लोड बैलेंसर पर एसएसएल बंद करने के लिए कॉन्फ़िगर किया गया है और ट्रैफ़िक को राऊटर पर हाई पोर्ट पर भेज दिया गया है

    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'