Apigee Edge का दस्तावेज़ देखा जा रहा है.
Apigee X दस्तावेज़ पर जाएं. जानकारी
Apigee Edge में संगठन, टॉप-लेवल कंटेनर होता है. इसमें आपके सभी एपीआई प्रॉक्सी और उनसे जुड़े संसाधन शामिल होते हैं. इस विषय के बाकी हिस्से में, संगठनों के बारे में ज़्यादा जानकारी दी गई है. हालांकि, यहां कुछ काम की बातें दी गई हैं:
- डिफ़ॉल्ट रूप से, आपके संगठन का नाम उस यूआरएल में होता है जिसका इस्तेमाल आपके एपीआई प्रॉक्सी को कॉल करने के लिए किया जाता है. इस बारे में वर्चुअल होस्ट के बारे में जानकारी में बताया गया है.
उदाहरण के लिए:
http(s)://your_org_name-environment.apigee.net/proxy_base_path/...
- आपके संगठन का नाम, Edge के मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) के यूआरएल में मौजूद होता है. उदाहरण के लिए, यह यूआरएल
docsसंगठन के लिए एपीआई प्रॉक्सी दिखाता है:
- ऐसा हो सकता है कि आपने सिर्फ़ एक संगठन बनाया हो, लेकिन आपके पास किसी दूसरे संगठन के उपयोगकर्ता या एडमिन के तौर पर, खास अनुमतियां हो सकती हैं. Edge मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में, अगर आप एक से ज़्यादा संगठनों के सदस्य हैं, तो आपके पास किसी दूसरे संगठन पर स्विच करने का विकल्प होता है. इसके बारे में, अपने संगठनों के बीच स्विच करना सेक्शन में बताया गया है.
- जब संगठन के एडमिन की भूमिका में उपयोगकर्ता के तौर पर, मैनेजमेंट एपीआई का इस्तेमाल करके कॉल किए जाते हैं, तो ज़्यादातर कॉल में संगठन, पाथ का ज़रूरी हिस्सा होता है. उदाहरण के लिए, नीचे दिया गया
Management API cURL अनुरोध, किसी संगठन में सभी एपीआई प्रॉक्सी की सूची दिखाता है:
curl https://api.enterprise.apigee.com/v1/organizations/your_org_name/apis -u org_admin_email_address
वीडियो: यह जानने के लिए छोटा वीडियो देखें कि संगठन एपीआई मैनेजमेंट के लिए, मल्टी-टेनेंसी आर्किटेक्चर को कैसे काम करते हैं.
संगठन के कॉम्पोनेंट
Edge खाता बनाने पर, Edge आपके लिए अपने-आप एक संगठन बना देता है. संगठन बनाने के बाद, अपने संगठन में उपयोगकर्ता जोड़े जा सकते हैं, एपीआई प्रॉक्सी और एपीआई प्रॉडक्ट बनाए जा सकते हैं, और डेवलपर और ऐप्लिकेशन रजिस्टर किए जा सकते हैं.
नीचे दी गई इमेज में, Edge के संगठनात्मक मॉडल के मुख्य कॉम्पोनेंट दिखाए गए हैं. इस मॉडल से यह तय होता है कि आपके एपीआई, एपीआई प्रॉडक्ट, ऐप्लिकेशन, और ऐप्लिकेशन डेवलपर कैसे Edge में जुड़े हैं.
इस मॉडल में Apigee Edge की सभी सुविधाएं नहीं हैं. अगर कमाई करने की सुविधा का इस्तेमाल किया जाता है, तो मॉडल में अतिरिक्त कॉम्पोनेंट होंगे. ज़्यादा जानकारी के लिए, कमाई करने की सुविधा के बारे में खास जानकारी देखें. कमाई करने के लिए कंपनियों और डेवलपर को मैनेज करने के बारे में जानने के लिए, कंपनियों और डेवलपर को मैनेज करना लेख पढ़ें.
संगठन के नाम
संगठन का नाम:
- मूल्यांकन करने वाली संस्था:
username-eval - पैसे चुकाकर बने संगठन: उपयोगकर्ता, शुरुआती प्रोविज़निंग के समय यह तय करता है
संगठन बनाने के बाद, उसका नाम नहीं बदला जा सकता.
संगठन का नाम, एपीआई प्रॉक्सी के यूआरएल का हिस्सा बन जाता है. साथ ही, Edge Management API को अनुरोध करते समय भी यह यूआरएल का हिस्सा बन जाता है. उदाहरण के लिए, एपीआई प्रॉक्सी को ऐक्सेस करने के लिए इस्तेमाल किए जाने वाले सामान्य यूआरएल का फ़ॉर्मैट यह है:
http://org-name-env.apigee.net/v1/weather/forecastrss
कहां:
- org-name आपके संगठन का नाम है.
- env, एपीआई प्रॉक्सी का डिप्लॉयमेंट एनवायरमेंट है, जो टेस्ट या प्रॉडक्शन में से कोई एक होता है.
उदाहरण के लिए:
http://myorg-test.apigee.net/v1/weather/forecastrss
संगठन के कॉम्पोनेंट
नीचे दी गई टेबल में, संगठन के मॉडल के कॉम्पोनेंट के बारे में ज़्यादा जानकारी दी गई है:
| कॉम्पोनेंट | ब्यौरा |
|---|---|
|
संगठन |
हर Apigee खाता, Apigee Edge पर एक या एक से ज़्यादा संगठनों से मैप होता है. संगठन में सभी कॉम्पोनेंट शामिल होते हैं. इनमें एपीआई प्रॉक्सी, एपीआई प्रॉडक्ट, एपीआई पैकेज, ऐप्लिकेशन, और डेवलपर शामिल हैं. खाते के मालिक, किसी एक संगठन तक सीमित नहीं होते. कुछ खाता मालिक ऐसे कई संगठनों के सदस्य हो सकते हैं या वे ऐसे संगठन के सदस्य हो सकते हैं जो अलग-अलग ऐप्लिकेशन डेवलपर के समुदायों के साथ काम करते हैं. |
| परिवेश | किसी संगठन में एपीआई प्रॉक्सी के लिए, रनटाइम एक्सीक्यूशन कॉन्टेक्स्ट. एनवायरमेंट के बारे में ज़्यादा जानने के लिए, यहां दिया गया सेक्शन देखें. |
|
उपयोगकर्ता |
किसी संगठन में, खाता बनाने वाला व्यक्ति अपने-आप एडमिन बन जाता है. ऐसे संगठन में, ज़्यादा उपयोगकर्ता बनाए जा सकते हैं. उपयोगकर्ता, संगठन की एपीआई टीम बनाते हैं. इसमें एडमिन, एपीआई प्रॉक्सी, और एपीआई प्रॉडक्ट क्रिएटर्स जैसे लोग शामिल हो सकते हैं. साथ ही, इसमें आंकड़ों और अन्य आंकड़ों को मॉनिटर करने वाले उपयोगकर्ता और अन्य लोग भी शामिल हो सकते हैं. अलग-अलग उपयोगकर्ताओं के पास अलग-अलग भूमिकाएं और ऐक्सेस के अधिकार हो सकते हैं. उदाहरण के लिए, कुछ उपयोगकर्ताओं को संगठन के एडमिन और ऑपरेशंस एडमिन के तौर पर तय करें. इनके पास संगठन और उसके कॉम्पोनेंट में बदलाव करने की अनुमतियां होंगी. अन्य उपयोगकर्ताओं को एपीआई प्रॉक्सी और एपीआई प्रॉडक्ट बनाने की अनुमतियां दें. हालांकि, उन्हें अन्य उपयोगकर्ताओं में बदलाव करने की अनुमतियां न दें. उपयोगकर्ता, एक से ज़्यादा संगठनों के सदस्य हो सकते हैं. उदाहरण के लिए, आपकी कंपनी अलग-अलग डेवलपर कम्यूनिटी की मदद करने के लिए, Apigee Edge पर कई संगठनों को तय कर सकती है. हालांकि, संगठन के अंदर सभी एपीआई प्रॉक्सी और एपीआई प्रॉडक्ट एक ही व्यक्ति बनाते हैं. इसलिए, वे आपके सभी संगठनों के सदस्य होते हैं. उपयोगकर्ता बनने के लिए, आपको Apigee खाता यानी Apigee संगठन बनाना ज़रूरी नहीं है. कोई एडमिन, आपको किसी मौजूदा संगठन में जोड़ सकता है. सभी उपयोगकर्ता, Apigee Edge में यहां लॉग इन करते हैं: https://enterprise.apigee.com. |
|
एपीआई प्रॉक्सी |
किसी संगठन के उपयोगकर्ता एक या उससे ज़्यादा API प्रॉक्सी बनाते हैं. एपीआई प्रॉक्सी, सार्वजनिक तौर पर उपलब्ध एचटीटीपी एंडपॉइंट को बैकएंड सेवा से मैप करने की सुविधा देता है. एपीआई प्रॉक्सी को सुरक्षा (जैसे कि OAuth) को शामिल करने, मैसेज को बदलने (जैसे कि एक्सएमएल से JSON) में बदलाव करने, ट्रैफ़िक को बैकएंड सेवाओं तक सीमित करने, और अनुरोध, रिस्पॉन्स, और सेवा कॉलआउट के साथ अन्य अहम काम करने के लिए भी कॉन्फ़िगर किया जा सकता है. Edge, एपीआई प्रॉक्सी पर आंकड़े जुटाने के लिए डेटा इकट्ठा करता है. |
|
एपीआई प्रॉडक्ट |
किसी संगठन के उपयोगकर्ता एक या उससे ज़्यादा एपीआई प्रॉडक्ट बनाते हैं. एपीआई प्रॉडक्ट, सेवा प्लान के साथ एपीआई प्रॉक्सी का बंडल होता है. सेवा के उस प्लान में, एपीआई प्रॉक्सी के लिए ऐक्सेस की सीमाएं सेट की जा सकती हैं, सुरक्षा की सुविधा दी जा सकती है, निगरानी और आंकड़ों की सुविधा दी जा सकती है, और अन्य सुविधाएं दी जा सकती हैं. Edge, एपीआई प्रॉडक्ट के आंकड़े इकट्ठा करता है. |
|
डेवलपर |
किसी संगठन में एक या उससे ज़्यादा डेवलपर होते हैं. ये ऐसे ऐप्लिकेशन बनाते हैं जो आपके संगठन के तय किए गए एपीआई (एपीआई प्रॉडक्ट में इकट्ठा किए गए) का इस्तेमाल करते हैं. डेवलपर, एपीआई का इस्तेमाल कर सकते हैं, लेकिन वे एपीआई नहीं बना सकते या संगठन में कोई दूसरी कार्रवाई नहीं कर सकते. डेवलपर, आपकी कंपनी के कर्मचारी हो सकते हैं, पार्टनर हो सकते हैं या ऐसे बाहरी डेवलपर हो सकते हैं जो आपके एपीआई के ऐक्सेस के लिए पैसे चुकाते हैं. डेवलपर को आपके संगठन में रजिस्टर करना होगा, ताकि वे ऐप्लिकेशन रजिस्टर कर सकें और आपके एपीआई ऐक्सेस करने के लिए एपीआई पासकोड पा सकें. एपीआई की सेवा देने वाली कंपनी के तौर पर, यह तय करना आपके ऊपर है कि अपने संगठन में डेवलपर को कैसे जोड़ें, अपडेट करें या हटाएं. इन्हें Edge मैनेजमेंट के यूज़र इंटरफ़ेस (यूआई) से मैन्युअल तरीके से जोड़ा जा सकता है. इसके अलावा, वेबसाइट पर रजिस्टर करने के लिए डेवलपर पोर्टल बनाया जा सकता है या Edge management API का इस्तेमाल करके, रजिस्ट्रेशन का अपना तरीका बताया जा सकता है. डेवलपर के पास Edge पर खाता होना ज़रूरी नहीं है. साथ ही, ज़्यादातर डेवलपर को Edge के बारे में कुछ भी जानने की ज़रूरत नहीं होगी. अगर डेवलपर के पास Edge पर खाता है, तो आम तौर पर यह किसी दूसरे संगठन के उपयोगकर्ता के तौर पर या Edge API सेवाओं का इस्तेमाल करने के लिए होता है. |
|
ऐप्लिकेशन |
डेवलपर, एक या उससे ज़्यादा क्लाइंट ऐप्लिकेशन बनाते हैं, जो आपके एपीआई का इस्तेमाल करते हैं. डेवलपर को अपने ऐप्लिकेशन आपके संगठन के साथ रजिस्टर करने होंगे. Edge में मौजूद ऐप्लिकेशन, डेवलपर के असल ऐप्लिकेशन का प्रतिनिधि होता है. इससे डेवलपर को एपीआई पासकोड मिलता है, ताकि वह आपके एपीआई के हर अनुरोध के साथ उसे पास कर सके. आपके संगठन में सभी ऐप्लिकेशन रजिस्टर होते हैं. इसलिए, Edge का इस्तेमाल करके ऐप्लिकेशन और उसके एपीआई के इस्तेमाल से जुड़ी विश्लेषण की जानकारी को मॉनिटर और इकट्ठा किया जा सकता है. |
|
एपीआई पासकोड/OAuth टोकन |
आपने अपने एपीआई के लिए जो अनुमति देने का तरीका तय किया है उसके आधार पर, ऐप्लिकेशन आपके एपीआई को हर अनुरोध के साथ एक एपीआई पासकोड भेजता है. अगर वह कुंजी मान्य है, तो अनुरोध को अनुमति दी जाती है. Edge, पुष्टि करने के अलग-अलग तरीकों के साथ काम करता है. जैसे, आसान एपीआई पासकोड, दो लेग वाला OAuth, तीन लेग वाला OAuth वगैरह. एपीआई सेवा देने वाली कंपनी के तौर पर, आपको डेवलपर के लिए अपने ऐप्लिकेशन रजिस्टर करने का तरीका तय करना होगा. डेवलपर के ऐप्लिकेशन को रजिस्टर करने पर, आपको अपने एपीआई को ऐक्सेस करने के लिए ज़रूरी पासकोड वापस मिल जाता है. ऐप्लिकेशन को रजिस्टर करते समय, डेवलपर के पास एक एपीआई प्रॉडक्ट या एक से ज़्यादा एपीआई प्रॉडक्ट को ऐक्सेस करने का विकल्प होता है. डेवलपर का असल ऐप्लिकेशन, ऐप्लिकेशन से जुड़े सभी एपीआई प्रॉडक्ट को ऐक्सेस करने के लिए एक ही कुंजी का इस्तेमाल करता है (Edge में डेवलपर के ऐप्लिकेशन का रजिस्टर किया गया वर्शन). आपके पास किसी भी समय पासकोड रद्द करने का विकल्प होता है, ताकि डेवलपर के ऐप्लिकेशन के पास आपके एपीआई का ऐक्सेस न रहे. भले ही, डेवलपर के ऐप्लिकेशन का रजिस्टर किया गया प्रतिनिधि अब भी आपके संगठन में मौजूद हो. इसके अलावा, किसी कुंजी के लिए समयसीमा तय की जा सकती है, ताकि डेवलपर को किसी तय समय के बाद कुंजी को रीफ़्रेश करना पड़े. |
एनवायरमेंट के बारे में जानकारी
एनवायरमेंट, किसी संगठन में एपीआई प्रॉक्सी के लिए रनटाइम को लागू करने का संदर्भ होता है. एपीआई प्रॉक्सी को ऐक्सेस करने से पहले, आपको उसे किसी एनवायरमेंट में डिप्लॉय करना होगा. एपीआई प्रोक्सी को एक या एक से ज़्यादा एनवायरमेंट में डिप्लॉय किया जा सकता है.
एक संगठन में कई एनवायरमेंट हो सकते हैं. उदाहरण के लिए, किसी संगठन में dev,
test, और prod एनवायरमेंट को तय किया जा सकता है.
संगठन, Apigee की कुछ सुविधाओं के लिए स्कोप उपलब्ध कराता है. उदाहरण के लिए, संगठन के लेवल पर की-वैल्यू-मैप (KVM) का डेटा उपलब्ध कराया जा सकता है. इसका मतलब है कि किसी भी एनवायरमेंट में डिप्लॉय की गई एपीआई प्रॉक्सी को KVM से एक ही डेटा मिलेगा. कैश मेमोरी जैसी कुछ सुविधाओं को संगठन या संगठन के किसी खास एनवायरमेंट के लिए तय किया जा सकता है. Apigee के आंकड़ों के डेटा को संगठन और एनवायरमेंट के कॉम्बिनेशन के हिसाब से बांटा जाता है.
यहां उन मुख्य इकाइयों के बारे में बताया गया है जिन्हें संगठन में मैनेज किया जाता है. इनमें, संगठन में दुनिया भर के लिए तय की गई इकाइयां और किसी खास एनवायरमेंट के लिए तय की गई इकाइयां शामिल हैं:
