नीचे दिए गए उदाहरणों में, हम मानते हैं कि आपने पहले ही अपने सेवा खाते के साथ एक टोकन हासिल कर लिया है:
TOKEN=$(gcloud auth print-access-token)
हम यह भी मानते हैं कि आपने पहले ही ${CLIENT_PROJECT}
को Google Cloud प्रोजेक्ट का प्रोजेक्ट आईडी सेट कर दिया है.
मौजूदा ग्राहकों की सूची बनाएं
नीचे दिए गए निर्देश से उन सभी ग्राहकों के बारे में पता चलता है जिनके पास कॉल करने वाले का ऐक्सेस है:
curl -X GET -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${TOKEN}" \"https://sasportal.googleapis.com/v1alpha1/customers"
सुविधा के लिए, वैरिएबल में लौटाया गया ग्राहक नाम सेव करें:
CUSTOMER_NAME=customers/...
नए डिवाइस का कॉन्फ़िगरेशन बनाना
सबसे पहले, उस डिवाइस का ${FCCID}
और ${SN}
सेट करें जिसे आप बनाना चाहते हैं:
FCCID=f1 SN=sn1
इसके बाद, इस निर्देश की मदद से डिवाइस कॉन्फ़िगरेशन बनाएं:
curl -X POST -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${TOKEN}" \ "https://sasportal.googleapis.com/v1alpha1/${CUSTOMER_NAME}/devices" \ -d "{ \"fcc_id\": \"$FCCID\", \"serial_number\": \"$SN\", \"preloaded_config\": { \"call_sign\": \"cs1\", \"category\": \"DEVICE_CATEGORY_A\"}}"
इस निर्देश से डिवाइस का नया कॉन्फ़िगरेशन दिखता है. सुविधा के लिए, डिवाइस के नाम को एक वैरिएबल में सेव करें:
DEVICE_NAME=customers/.../devices/...
मौजूदा डिवाइसों की सूची बनाएं
नीचे दिए गए निर्देश में मौजूदा डिवाइसों की सूची दी गई है.
curl -X GET -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $TOKEN" \ "https://sasportal.googleapis.com/v1alpha1/${CUSTOMER_NAME}/devices"
डिवाइस को नाम के आधार पर फिर से पाएं
यह निर्देश डिवाइसों को उनके नाम के हिसाब से हासिल करता है.
curl -X GET -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $TOKEN" \ "https://sasportal.googleapis.com/v1alpha1/${DEVICE_NAME}"
मौजूदा डिवाइस को अपडेट करें
नीचे दिए गए निर्देश से मौजूदा डिवाइस अपडेट होते हैं.
curl -X PATCH -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $TOKEN" \ "https://sasportal.googleapis.com/v1alpha1/${DEVICE_NAME}" \
सीपीआई की पहचान और सर्टिफ़िकेशन की पुष्टि करना
सीक्रेट स्ट्रिंग जनरेट करने के लिए, नीचे दिए गए उदाहरण का इस्तेमाल करें:
curl -X POST -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $TOKEN" \ "https://sasportal.googleapis.com/v1alpha1/installer:generateSecret" \ -d "{}"
इससे यह मान नीचे दिया गया होता है:
{ "secret": "<generated secret>" }
इसके बाद, सीक्रेट स्ट्रिंग को JWT में एन्कोड करना ज़रूरी है. JSON वेब टोकन फ़ॉर्मैट का इस्तेमाल करें. हम यह मान लेते हैं कि आपने
#39; सीक्रेट स्ट्रिंग पर ${SECRET}
, JWT स्ट्रिंग पर ${ENCODED_SECRET}
, और पुष्टि करने के लिए ${CPI_ID}
को सीपीआई के आईडी पर सेट किया है.
यह निर्देश, सीपीआई की पहचान और सर्टिफ़िकेशन की पुष्टि करता है.
curl -X POST -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $TOKEN" \ "https://sasportal.googleapis.com/v1alpha1/installer:validate" \ -d "{ \"installer_id\": \"${CPI_ID}\", \"secret\": \"${SECRET}\", \"encoded_secret\": \"${ENCODED_SECRET}\" }"
सीपीआई में अब सीबीएसडी इंस्टॉल करने की सुविधा है, जिसमें सभी ज़रूरी पैरामीटर शामिल हैं.
कई चरणों वाला सीबीएसडी रजिस्ट्रेशन
इन दो सेक्शन में, सीबीएसएस के ज़रिए दो चरणों में रजिस्ट्रेशन करने के दो तरीके हैं. आप सीपीआई पर हस्ताक्षर किए गए पैरामीटर या सीपीआई खाते की मदद से, कई चरणों वाला सीबीएसडी रजिस्ट्रेशन कर सकते हैं.
सीपीआई की मदद से पहले से साइन किए गए डिवाइस पैरामीटर के साथ
इस नमूने में दिखाया गया है कि सीबीएस इंस्टॉल करने वाले उन पैरामीटर के साथ डिवाइस का नया कॉन्फ़िगरेशन कैसे बनाया जाता है जिन्हें पहले सीपीआई से कोड में बदला गया हो. इससे, सीपीआई उपयोगकर्ताओं के अलावा, अन्य कॉन्फ़िगरेशन भी बनाए जा सकते हैं.
सीपीआई's की निजी कुंजी का इस्तेमाल करके सीबीएसडी पैरामीटर को कोड में बदलें. ऐसा करने के लिए, हम JSON वेब टोकन फ़ॉर्मैट का इस्तेमाल करते हैं.
हम मान लेते हैं कि आपने
${ENCODED_DEVICE}
को JWT स्ट्रिंग और
${CPI_ID}
को सीपीआई के आईडी पर सेट किया है.
इसके बाद, बंद किए गए डिवाइस का कॉन्फ़िगरेशन, नीचे दिए गए निर्देश से बनाया जा सकता है:
curl -X POST -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${TOKEN}" \ "https://sasportal.googleapis.com/v1alpha1/${CUSTOMER_NAME}/devices:createSigned" \ -d "{ \"installer_id\": \"${CPI_ID}\", \"encoded_device\": \"${ENCODED_DEVICE}\", \"parent\": \"${CUSTOMER_NAME}\" }"
इसके बाद, सीएसएडी को रजिस्ट्रेशन पूरा करने के लिए, SAS में रजिस्ट्रेशन का अनुरोध भेजना होगा.
सीपीआई खाते के साथ
सबसे पहले, डिवाइस कॉन्फ़िगरेशन की पुष्टि करने से पहले, सीपीआई की पहचान की पुष्टि करना ज़रूरी है. डिवाइस सेट अप हो जाने के बाद, नीचे दिए गए निर्देश का इस्तेमाल करके, बंद डिवाइस कॉन्फ़िगरेशन बनाएं:
curl -X POST -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $TOKEN" \ "https://sasportal.googleapis.com/v1alpha1/${DEVICE_NAME}:signDevice" \ -d "${DEVICE}"
हम मानते हैं कि आपने ${DEVICE} को इस फ़ॉर्मैट में सीबीएस रजिस्ट्रेशन पैरामीटर के JSON प्रज़ेंटेशन के तौर पर सेट किया है.
इसके बाद, सीएसएडी को रजिस्ट्रेशन पूरा करने के लिए, SAS में रजिस्ट्रेशन का अनुरोध भेजना होगा.