एक्सटेंशन क्या होते हैं?

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

एक्सटेंशन का इस्तेमाल करके, बाहरी संसाधनों को अपनी एपीआई प्रॉक्सी में इंटिग्रेट किया जा सकता है. उदाहरण के लिए, Google Cloud Storage जैसी Google Cloud Platform की सेवाओं को इंटिग्रेट किया जा सकता है. रन टाइम के दौरान, एपीआई प्रॉक्सी इस एक्सटेंशन का इस्तेमाल करके, बाहरी रिसॉर्स के साथ अनुरोध और जवाबों का आदान-प्रदान करती है.

एक्सटेंशन रनटाइम फ़्रेमवर्क

रनटाइम के दौरान, एक्सटेंशन एक इंटरमीडियरी के तौर पर काम करता है. यह एपीआई प्रॉक्सी और बाहरी संसाधन के बीच अनुरोधों और जवाबों को प्रोसेस करता है.

एक्सटेंशन के ज़रिए प्रोसेसिंग, रनटाइम में कैसे काम करती है, इस बारे में खास जानकारी यहां दी गई है.

  1. क्लाइंट का अनुरोध, एपीआई प्रॉक्सी तक पहुंचता है. इसके बाद, अनुरोध का फ़्लो प्रॉक्सी की नीतियों के हिसाब से आगे बढ़ता है.
  2. अनुरोध का फ़्लो, प्रॉक्सी में मौजूद एक्सटेंशन कॉलआउट नीति तक पहुंचता है. इस प्रॉक्सी को, एनवायरमेंट में डिप्लॉय किए गए एक्सटेंशन को डेटा पास करने के लिए कॉन्फ़िगर किया जाता है. डेटा में ऐसी वैल्यू शामिल होती हैं जिनकी ज़रूरत, एक्सटेंशन के तौर पर काम करने वाले बाहरी संसाधन को अनुरोध भेजने के लिए होती है.
  3. एक्सटेंशन, बाहरी संसाधन को अनुरोध भेजता है. इसके बाद, उसे जवाब मिलता है.
  4. एक्सटेंशन, अपने जवाब को एक्सटेंशन कॉलआउट नीति पर वापस भेजता है. यहां इसे प्रॉक्सी कोड से मैनेज किया जाता है.
  5. अनुरोध का फ़्लो, प्रॉक्सी के ज़रिए तब तक जारी रहता है, जब तक वह क्लाइंट को जवाब नहीं दे देता.

एक्सटेंशन का इस्तेमाल करना

हर एक्सटेंशन को किसी खास बाहरी संसाधन को ध्यान में रखकर बनाया और कॉन्फ़िगर किया जाता है. किसी एक्सटेंशन का इस्तेमाल करने के लिए, Apigee Edge एडमिन और एपीआई प्रॉक्सी डेवलपर को यह तरीका अपनाना होगा:

  • Apigee Edge का संगठन का एडमिन, एक्सटेंशन को कॉन्फ़िगर और डिप्लॉय करता है. वे इसे कारोबार की ज़रूरतों के हिसाब से वैल्यू के साथ कॉन्फ़िगर करते हैं. इस कॉन्फ़िगरेशन से, एपीआई प्रॉक्सी डेवलपर के इस्तेमाल के लिए एक एक्सटेंशन इंस्टेंस बनता है. उदाहरण के लिए, वे Google Cloud Storage में किसी बकेट को ऐक्सेस करने के लिए एक्सटेंशन कॉन्फ़िगर कर सकते हैं. इसमें पुष्टि करने के लिए ज़रूरी क्रेडेंशियल भी शामिल हैं.
  • एपीआई प्रॉक्सी डेवलपर, एपीआई प्रॉक्सी में कॉन्फ़िगर किए गए एक्सटेंशन का इस्तेमाल करता है. इसके लिए, वह प्रॉक्सी में एक्सटेंशन कॉलआउट नीति जोड़ता है. नीति के कॉन्फ़िगरेशन में यह तय किया जाता है कि
    • कॉन्फ़िगर किए गए किस एक्सटेंशन का इस्तेमाल करना है.
    • एक्सटेंशन की कार्रवाइयां (इन्हें एक्सटेंशन के लिए फ़ंक्शन कॉल के तौर पर समझें) शुरू करने के लिए.
    • ऐक्शन कॉल के साथ पास किए जाने वाले ऐक्शन पैरामीटर. रन टाइम पर, नीति इस एक्सटेंशन का इस्तेमाल करके बाहरी संसाधन को ऐक्सेस करती है. ऐसा प्रॉक्सी के फ़्लो के तहत किया जाता है.

एक्सटेंशन के बारे में दस्तावेज़

यहां दिए गए विषयों में एक्सटेंशन के बारे में ज़्यादा जानकारी दी गई है: