सैंपल

यहां दिए गए उदाहरणों में, हम यह मानकर चल रहे हैं कि आपने अपने सेवा खाते से टोकन पहले ही हासिल कर लिया है:

TOKEN=$(gcloud auth print-access-token)

हम यह भी मान लेते हैं कि आपने Google Cloud प्रोजेक्ट के प्रोजेक्ट आईडी के लिए, ${CLIENT_PROJECT} को पहले ही सेट कर दिया है.

मौजूदा ग्राहकों की सूची

नीचे दिए गए निर्देश से, उन सभी ग्राहकों की जानकारी मिलती है जिनका ऐक्सेस कॉलर के पास है:

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 वेब टोकन फ़ॉर्मैट का इस्तेमाल करें. हम मानते हैं कि आपने ${SECRET} को सीक्रेट स्ट्रिंग, ${ENCODED_SECRET} को 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/installer:validate" \
  -d "{ \"installer_id\": \"${CPI_ID}\", \"secret\": \"${SECRET}\", \"encoded_secret\": \"${ENCODED_SECRET}\" }"

अब सीपीआई के पास, सभी ज़रूरी पैरामीटर वाला सीबीएसडी इंस्टॉल करने की सुविधा है.

सीबीएसडी को रजिस्टर करने की कई चरणों वाली प्रोसेस

सीबीएसडी को कई चरणों में रजिस्टर करने के दो तरीके हैं. इनके बारे में यहां बताया गया है. आपके पास, एक से ज़्यादा चरणों में CBSD रजिस्टर करने का विकल्प होता है. इसके लिए, उन पैरामीटर का इस्तेमाल किया जा सकता है जिन पर पहले किसी सीपीआई ने हस्ताक्षर किए हों या किसी सीपीआई खाते का इस्तेमाल किया जा सकता है.

डिवाइस के उन पैरामीटर के साथ जिन्हें पहले किसी सीपीआई ने साइन किया हो

इस सैंपल में, ऐसे डिवाइस कॉन्फ़िगरेशन को बनाने का तरीका बताया गया है जिसमें CBSD इंस्टॉलेशन पैरामीटर शामिल नहीं हैं. इन पैरामीटर को पहले सीपीआई ने कोड किया था, ताकि सीपीआई के अलावा अन्य उपयोगकर्ता भी कॉन्फ़िगरेशन बना सकें. सीबीएसडी पैरामीटर को एन्कोड करने के लिए, सीपीआई की निजी कुंजी का इस्तेमाल करें. इसके लिए, हम 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}\" }"

इसके बाद, CBSD को रजिस्ट्रेशन पूरा करने के लिए, एसएएस को रजिस्ट्रेशन का अनुरोध भेजना होगा.

सीपीआई खाते के साथ

डिवाइस के कॉन्फ़िगरेशन की पुष्टि करने से पहले, यह ज़रूरी है कि सीपीआई की पहचान की पुष्टि हो गई हो. इसके बाद, डिवाइस के ऐसे कॉन्फ़िगरेशन को बनाने के लिए यहां दिया गया निर्देश इस्तेमाल करें जो चालू नहीं है:

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 फ़ॉर्मैट के तौर पर सेट किया है.

इसके बाद, CBSD को रजिस्ट्रेशन पूरा करने के लिए, एसएएस को रजिस्ट्रेशन का अनुरोध भेजना होगा.