आपके पास Earth Engine की सुविधा वाले प्रोजेक्ट की ऐसेट या कंप्यूट कोटा को, Earth Engine के अन्य उपयोगकर्ताओं के साथ प्रोजेक्ट लेवल पर शेयर करने का विकल्प होता है. Earth Engine की ऐसेट या कंप्यूट को किसी दूसरे उपयोगकर्ता या उपयोगकर्ताओं के ग्रुप के साथ शेयर किया जा सकता है. अगर आपको उपयोगकर्ताओं के किसी ग्रुप के साथ शेयर करना है, तो एक नया Google ग्रुप बनाएं और उसका ईमेल नोट करें. यह ईमेल, ग्रुप पेज पर मौजूद 'इसके बारे में जानकारी' लिंक पर उपलब्ध होता है. इस पेज पर, किसी व्यक्ति या ग्रुप को संसाधनों का ऐक्सेस देने का तरीका बताया गया है. साथ ही, अलग-अलग गतिविधियों के लिए ज़रूरी भूमिकाओं और अनुमतियों के बारे में बताया गया है.
Earth Engine सेवा के इस्तेमाल को सेट करना
किसी क्लाउड प्रोजेक्ट पर Earth Engine API का इस्तेमाल करने के लिए, एपीआई को प्रोजेक्ट पर चालू करना ज़रूरी है. साथ ही, उपयोगकर्ता के पास कम से कम Earth Engine रिसॉर्स व्यूअर की भूमिका वाली अनुमतियां होनी चाहिए. पहले से तय की गई Earth Engine IAM भूमिकाओं के बारे में ज़्यादा जानें.
इसके अलावा, उपयोगकर्ता के पास प्रोजेक्ट के लिए कम से कम serviceusage.services.use अनुमति होनी चाहिए. यह अनुमति, प्रोजेक्ट के मालिक या एडिटर की भूमिकाओं के ज़रिए या सेवा उपयोग के उपभोक्ता की भूमिका के ज़रिए दी जा सकती है. अगर उपयोगकर्ता के पास चुने गए प्रोजेक्ट के लिए, Earth Engine और सेवा के इस्तेमाल की ज़रूरी अनुमतियां नहीं हैं, तो गड़बड़ी का मैसेज दिखेगा.
ऐसेट की अनुमतियां सेट करना
ऐसेट-लेवल पर अनुमतियां सेट करना
ऐसेट लेवल पर अनुमतियां अपडेट करने के लिए, कई विकल्प मौजूद हैं.
- कोड एडिटर में ऐसेट मैनेजर का इस्तेमाल करना.
- Earth Engine की कमांड लाइन का इस्तेमाल करें.
- किसी क्लाइंट लाइब्रेरी का इस्तेमाल करें, जैसे कि
ee.data.setAssetAcl(). - इसके अलावा, सीधे तौर पर REST API को कॉल करें.
प्रोजेक्ट-लेवल पर ऐसेट की अनुमतियां सेट करना
प्रोजेक्ट लेवल पर शेयर करने से, Earth Engine की सुविधा वाले Cloud प्रोजेक्ट की सभी ऐसेट पर एक साथ अनुमतियां सेट हो जाती हैं.
अपने प्रोजेक्ट के आईएएम एडमिन पेज पर, सही पहचान और ऐक्सेस मैनेजमेंट (आईएएम) भूमिका असाइन करके, प्रोजेक्ट लेवल पर ऐसेट शेयर की जा सकती हैं. Earth Engine की ऐसेट और संसाधनों को शेयर करने के लिए, Earth Engine के लिए पहले से तय किए गए आईएएम रोल मौजूद हैं. आईएएम की भूमिकाओं के बारे में सामान्य जानकारी पाने के लिए, भूमिकाओं को समझना लेख पढ़ें.
जब कोई दूसरा उपयोगकर्ता आपकी किसी ऐसेट को ऐक्सेस करने की कोशिश करता है, तो सबसे पहले ऐसेट लेवल पर अनुमतियों की जांच की जाती है. अगर एसेट लेवल पर अनुमतियां सेट नहीं की गई हैं या जांच पूरी नहीं हो पाती है (यानी कि ऐक्सेस नहीं है), तो प्रोजेक्ट लेवल पर अनुमतियों की जांच की जाएगी.
प्रोजेक्ट लेवल पर अनुमतियां सेट करना
प्रोजेक्ट लेवल पर अनुमतियां सेट करने के लिए, किसी उपयोगकर्ता या उपयोगकर्ताओं के ग्रुप को प्रोजेक्ट IAM की भूमिका असाइन करें:
- Google Cloud Console में IAM पेज खोलें
IAM पेज खोलें
इसके अलावा, कोड एडिटर के ऐसेट टैब पर जाकर, अपने प्रोजेक्ट के नाम पर पॉइंटर को रखें और आइकॉन पर क्लिक करें. - कोई प्रोजेक्ट चुनें पर क्लिक करें और अपना प्रोजेक्ट चुनें. अगर आपने कोड एडिटर से IAM पेज खोला है, तो आपको पहले से ही वहां होना चाहिए.
- सबसे ऊपर मौजूद, जोड़ें पर क्लिक करें. इसके बाद, किसी व्यक्ति या ग्रुप के ईमेल पते को नए सदस्य के तौर पर जोड़ें. इसके अलावा, प्रोजेक्ट में पहले से मौजूद सदस्य के बगल में मौजूद, आइकॉन पर क्लिक करें.
- भूमिका ड्रॉप-डाउन में, Earth Engine संसाधन की वह भूमिका खोजें जो आपको देनी है. ज़्यादा जानकारी के लिए, पहले से तय किए गए Earth Engine IAM रोल देखें.
- सेव करें बटन पर क्लिक करें.
वीपीसी सर्विस कंट्रोल
Earth Engine, वीपीसी सर्विस कंट्रोल के साथ काम करता है. यह Google Cloud की सुरक्षा से जुड़ी सुविधा है. इससे उपयोगकर्ताओं को अपने संसाधनों को सुरक्षित रखने और डेटा बाहर निकाले जाने के जोखिम को कम करने में मदद मिलती है. वीपीसी सर्विस पेरीमीटर में संसाधन जोड़ने से, डेटा को पढ़ने और उसमें बदलाव करने की कार्रवाइयों पर ज़्यादा कंट्रोल मिलता है.
वीपीसी-एससी की सुविधाओं और कॉन्फ़िगरेशन के बारे में ज़्यादा जानें.
सीमाएं
अपने संसाधनों के लिए वीपीसी सर्विस कंट्रोल चालू करने पर, कुछ सीमाएं लागू होती हैं. इन सीमाओं को हल करने के लिए, हमने कुछ उदाहरण दिए हैं:
| पाबंदी | उदाहरण के लिए, |
|---|---|
| कोड एडिटर का इस्तेमाल नहीं किया जा सकता. साथ ही, वीपीसी सर्विस कंट्रोल, सर्विस पेरीमीटर में मौजूद संसाधनों और क्लाइंट के साथ इसका इस्तेमाल करने की अनुमति नहीं देगा. |
Earth Engine Python API का इस्तेमाल,
geemap लाइब्रेरी के साथ करें.
|
| लेगसी ऐसेट को वीपीसी सर्विस कंट्रोल से सुरक्षित नहीं किया जाता. | क्लाउड प्रोजेक्ट में सेव की गई एसेट इस्तेमाल करें. |
| Google Drive में एक्सपोर्ट करने की सुविधा, वीपीसी सर्विस कंट्रोल के साथ काम नहीं करती. |
|
| Earth Engine ऐप्लिकेशन, सर्विस पेरीमीटर में मौजूद संसाधनों और क्लाइंट के लिए काम नहीं करते. | कोई समाधान उपलब्ध नहीं है. |
सुरक्षित वीपीसी सर्विस पेरीमीटर में मौजूद संसाधनों के साथ Earth Engine का इस्तेमाल करने की सुविधा, सिर्फ़ Professional और Premium प्लान के लिए उपलब्ध है. अगर बेसिक प्लान से जुड़े वीपीसी-एससी की मदद से सुरक्षित किए गए प्रोजेक्ट के साथ Earth Engine API का इस्तेमाल करने की कोशिश की जाती है, तो गड़बड़ी का मैसेज दिखेगा. Earth Engine की कीमत के बारे में ज़्यादा जानने के लिए, आधिकारिक दस्तावेज़ पर जाएं.
वीपीसी सर्विस कंट्रोल और इसकी सीमाओं के बारे में ज़्यादा जानकारी, इस्तेमाल किए जा सकने वाले प्रॉडक्ट और सीमाएं पेज पर मिल सकती है.
भूमिकाएं और अनुमतियां
यहां दिए गए सेक्शन में, Earth Engine के संसाधनों को ऐक्सेस करने और गतिविधियां करने के लिए ज़रूरी अनुमतियों और भूमिकाओं के बारे में बताया गया है. क्लाउड प्रोजेक्ट की अनुमतियों और भूमिकाओं के बारे में ज़्यादा जानने के लिए, Google Cloud का दस्तावेज़ देखें.
Earth Engine के लिए पहले से तय किए गए IAM रोल
Earth Engine में पहले से तय भूमिकाएं होती हैं. इनकी मदद से, किसी प्रोजेक्ट में Earth Engine के संसाधनों पर अलग-अलग लेवल का कंट्रोल मिलता है. ये भूमिकाएं हैं:
| भूमिका | शीर्षक | ब्यौरा |
|---|---|---|
roles/earthengine.viewer |
Earth Engine रिसॉर्स व्यूअर | इससे ऐसेट और टास्क देखने और उनकी सूची बनाने की अनुमति मिलती है. |
roles/earthengine.writer |
Earth Engine रिसॉर्स राइटर | इससे ऐसेट को पढ़ने, बनाने, उनमें बदलाव करने, और उन्हें मिटाने की अनुमति मिलती है. साथ ही, इमेज और टेबल इंपोर्ट करने, टास्क पढ़ने और अपडेट करने, इंटरैक्टिव कंप्यूटेशन करने, और लंबे समय तक चलने वाले एक्सपोर्ट टास्क बनाने की अनुमति मिलती है. |
roles/earthengine.admin |
Earth Engine एडमिन | यह Earth Engine के सभी संसाधनों को ऐक्सेस करने की अनुमति देता है. इसमें Earth Engine की ऐसेट के लिए, ऐक्सेस कंट्रोल में बदलाव करना भी शामिल है. |
roles/earthengine.appsPublisher |
Earth Engine Apps Publisher | इस भूमिका से, Earth Engine ऐप्लिकेशन के साथ इस्तेमाल करने के लिए सेवा खाता बनाने की अनुमति मिलती है. साथ ही, क्लाउड प्रोजेक्ट के तहत, प्रोजेक्ट के मालिकाना हक वाले ऐप्लिकेशन में बदलाव करने और उन्हें मिटाने की अनुमति मिलती है. |
ध्यान दें कि अगर Earth Engine के लिए पहले से तय की गई भूमिकाएं आपकी ज़रूरतों के मुताबिक नहीं हैं, तो प्रिमिटिव या कस्टम भूमिका सेट की जा सकती है. आईएएम रोल पेज पर जाकर, हर रोल से जुड़ी अनुमतियों का बंडल देखा जा सकता है. इसके लिए, किसी रोल को फ़िल्टर करें और उस पर क्लिक करें.
Earth Engine API को चालू करना
किसी Cloud प्रोजेक्ट पर Earth Engine API को चालू करने के लिए, उपयोगकर्ता के पास सेवा के इस्तेमाल से जुड़े एडमिन (roles/serviceusage.serviceUsageAdmin) की भूमिका होनी चाहिए. इसके अलावा, उसके पास ऐसी कोई अन्य भूमिका होनी चाहिए जिसमें serviceusage.services.enable अनुमति शामिल हो. जैसे, प्रोजेक्ट का मालिक या एडिटर.
| अनुमतियां ज़रूरी हैं |
|
| सुझाई गई भूमिकाएं |
|
Earth Engine API का पूरा ऐक्सेस
उपयोगकर्ताओं को Earth Engine सेवा का पूरा ऐक्सेस देने के लिए, उन्हें कुछ कार्रवाइयां करने की अनुमति देनी होगी. जैसे: REST API, कोड एडिटर या क्लाइंट लाइब्रेरी के ज़रिए सीधे तौर पर ऐक्सेस देना.
- Earth Engine के एक्सप्रेशन लागू किए जा रहे हैं
- बैच कंप्यूटेशन (एक्सपोर्ट) चलाना
- इंटरैक्टिव नतीजे (ऑनलाइन मैप, थंबनेल, चार्ट वगैरह) पाना
- Earth Engine ऐसेट बनाना/मिटाना
- Earth Engine से कनेक्ट करने के लिए, क्लाइंट लाइब्रेरी की मदद से OAuth ऑथेंटिकेशन का इस्तेमाल करना
| अनुमतियां ज़रूरी हैं |
|
| सुझाई गई भूमिकाएं |
|
| नोट |
Google Cloud को सेवा उपयोग के उपभोक्ता की भूमिका की ज़रूरत होती है, ताकि एपीआई को कॉल करते समय प्रोजेक्ट को ऐक्टिव प्रोजेक्ट के तौर पर इस्तेमाल किया जा सके. साथ ही, प्रोजेक्ट X पर यह अनुमति न होने पर, ee.Initialize(project=X) |
सिर्फ़ ऐसेट शेयर करने की सुविधा
उपयोगकर्ता को पहले से तय Earth Engine IAM भूमिकाओं में से कोई एक भूमिका दें. साथ ही, ज़रूरी गतिविधि करने के लिए कम से कम अनुमतियां दें. ध्यान दें कि उपयोगकर्ता, ज़रूरी serviceusage अनुमतियों के बिना प्रोजेक्ट के संसाधनों का इस्तेमाल नहीं कर पाएंगे.
प्रोजेक्ट मैनेजमेंट
उपलब्ध प्रोजेक्ट की सूची बनाना और उन्हें दिखाना
ऐसा तब होता है, जब उपलब्ध प्रोजेक्ट ब्राउज़ करने के लिए कोड एडिटर का इस्तेमाल किया जाता है.
| अनुमतियां ज़रूरी हैं |
|
| सुझाई गई भूमिकाएं |
|
कोड एडिटर में इस्तेमाल करने के लिए कोई प्रोजेक्ट चुनें
| अनुमतियां ज़रूरी हैं |
अगर प्रोजेक्ट पहले से सेट अप नहीं किया गया हैकोड एडिटर की मदद से पहली बार कोई प्रोजेक्ट चुनने पर, उसे Earth Engine के साथ इस्तेमाल करने के लिए शुरू किया जाता है. अगर आपने पहले ऐसा नहीं किया है, तो सेटअप पूरा करने के लिए आपको इन भूमिकाओं की ज़रूरत होगी.
|
| सुझाई गई भूमिकाएं |
अन्य भूमिकाएं (अगर प्रोजेक्ट पहले से सेट अप नहीं किया गया है)
|
कोड एडिटर की मदद से प्रोजेक्ट बनाना
| अनुमतियां ज़रूरी हैं |
|
| सुझाई गई भूमिकाएं |
|
| नोट |
ऐसा हो सकता है कि आपका संगठन आपको एडिटर की भूमिका न दे. इसलिए, आपको ज़्यादा बारीकी से कंट्रोल करने वाली भूमिकाओं की ज़रूरत पड़ सकती है. projects.update की अनुमति देने के लिए, प्रोजेक्ट मूवर की ज़रूरत होती है.
|
गैर-व्यावसायिक टियर चुनना
यहां दी गई अनुमतियां और सुझाई गई भूमिकाएं, गैर-व्यावसायिक टियर कॉन्फ़िगरेशन से जुड़ी हैं.
टियर चुनना
| अनुमतियां ज़रूरी हैं |
|
| सुझाई गई भूमिकाएं |
|
किसी प्रोजेक्ट के साथ बिलिंग खाता जोड़ना
कॉन्ट्रीब्यूटर टियर के लिए, प्रोजेक्ट से जुड़ा एक मान्य बिलिंग खाता होना ज़रूरी है. बिलिंग से जुड़ी अनुमतियों और भूमिकाओं के बारे में ज़्यादा जानने के लिए, Cloud Billing ऐक्सेस पेज पर जाएं.
| अनुमतियां ज़रूरी हैं | |
|---|---|
| बिलिंग खाता |
|
| क्लाउड प्रोजेक्ट |
|
| सुझाई गई भूमिकाएं | |
| बिलिंग खाता |
|
| क्लाउड प्रोजेक्ट |
|
व्यावसायिक प्रोजेक्ट का रजिस्ट्रेशन
यहां दी गई अनुमतियां, पैसे चुकाकर इस्तेमाल किए जाने वाले प्रोजेक्ट को रजिस्टर करने से जुड़ी हैं.
| अनुमतियां ज़रूरी हैं | |
|---|---|
| बिलिंग खाता |
|
| क्लाउड प्रोजेक्ट |
|
| सुझाई गई भूमिकाएं | |
| बिलिंग खाता |
|
| क्लाउड प्रोजेक्ट |
|
Earth Engine के व्यावसायिक प्लान को मैनेज करना
ये अनुमतियां, Earth Engine के कीमत प्लान को मैनेज करने से जुड़ी हैं.
|
बिलिंग खाते पर ज़रूरी अनुमतियां |
|
|
बिलिंग खाते के लिए सुझाई गई भूमिकाएं |
|
बैच टास्क मैनेजमेंट
यहां दी गई अनुमतियां, एक साथ कई टास्क करने की सुविधा के लिए, हर प्रोजेक्ट के हिसाब से बैच टास्क की सीमाएं कॉन्फ़िगर करने से जुड़ी हैं. यह सुविधा सिर्फ़ Earth Engine के व्यावसायिक उपयोगकर्ताओं के लिए उपलब्ध है.
प्रोजेक्ट-लेवल पर बैच टास्क की सीमाएं देखना
|
Cloud खाते पर अनुमतियां ज़रूरी हैं |
earthengine.config.get
|
प्रोजेक्ट-लेवल पर बैच टास्क की सीमाएं सेट करना
|
Cloud खाते पर अनुमतियां ज़रूरी हैं |
earthengine.config.updateध्यान दें: इस अनुमति में, बिलिंग खाते पर कॉन्फ़िगर की गई प्लान-लेवल की सीमाएं देखने की अनुमति भी शामिल है. |
|
बिलिंग खाते पर ज़रूरी अनुमतियां |
billing.subscriptions.list
|
ऐप्लिकेशन मैनेज करना
ऐप्लिकेशन की जानकारी दिखाना
| अनुमतियां ज़रूरी हैं |
|
| सुझाई गई भूमिकाएं |
Viewer (roles/viewer) याEarth Engine Apps Publisher ( roles/earthengine.appsPublisher)
|
ऐप्लिकेशन पब्लिश/अपडेट करना
| अनुमतियां ज़रूरी हैं |
|
| सुझाई गई भूमिकाएं |
Earth Engine Apps Publisher (roles/earthengine.appsPublisher) याService Account Admin ( roles/iam.serviceAccountAdmin)
|
| नोट |
|
ऐप्लिकेशन मिटाना
| अनुमतियां ज़रूरी हैं | iam.serviceAccounts.disable |
| सुझाई गई भूमिकाएं |
Earth Engine Apps Publisher (roles/earthengine.appsPublisher) याService Account Admin ( roles/iam.serviceAccountAdmin)
|