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

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

परिचय

समस्या हल करते समय, आपको 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'

दूसरा उदाहरण: ईएलबी की ओर इशारा करने वाले होस्ट एलियास के लिए एपीआई अनुरोध

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

  • पोर्ट 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 राऊटर पर एसएसएल खत्म हो जाता है

    दूसरे शब्दों में, लोड बैलेंसर को 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 के ज़रिए मैसेज प्रोसेसर को एपीआई अनुरोध भेजना

डिफ़ॉल्ट पोर्ट 8998 पर, मैसेज प्रोसेसर Apigee राऊटर से आने वाले ट्रैफ़िक को सुनता है. इसलिए, जिन मामलों में इस पोर्ट को नहीं बदला गया है उनमें ट्रैफ़िक को सीधे तौर पर किसी खास मैसेज प्रोसेसर इंस्टेंस पर इस पोर्ट पर भेजना होगा. उदाहरण के लिए, यहां दिया गया तरीका अपनाएं. curl अनुरोध को यूआरएल 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'