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

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

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

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

    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'