Halaman ini diterjemahkan oleh Cloud Translation API.

Contoh

Dalam contoh berikut, kami mengasumsikan bahwa Anda telah mendapatkan token dengan akun layanan Anda:

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

Kami juga mengasumsikan bahwa Anda telah menetapkan ${CLIENT_PROJECT} ke project ID Project Google Cloud.

Mencantumkan pelanggan saat ini

Perintah berikut menampilkan semua pelanggan yang aksesnya dimiliki pemanggil:

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"

Untuk mempermudah, simpan Nama pelanggan yang ditampilkan ke dalam variabel:

CUSTOMER_NAME=customers/...

Membuat konfigurasi perangkat baru

Pertama, tetapkan ${FCCID} dan ${SN} perangkat yang ingin Anda buat:

FCCID=f1
SN=sn1

Kemudian, buat konfigurasi perangkat dengan perintah berikut:

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\"}}"

Perintah ini menampilkan konfigurasi perangkat yang baru dibuat. Untuk mempermudah, simpan nama perangkat ke dalam variabel:

DEVICE_NAME=customers/.../devices/...

Mencantumkan perangkat saat ini

Perintah berikut mencantumkan perangkat yang ada.

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"

Mengambil perangkat berdasarkan nama

Perintah berikut mengambil perangkat berdasarkan nama.

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}"

Memperbarui perangkat yang ada

Perintah berikut akan mengupdate perangkat yang ada.

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}" \

Memvalidasi identitas dan sertifikasi CPI Anda

Gunakan contoh berikut untuk membuat string rahasia:

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 "{}"

Tindakan ini menampilkan nilai dengan bentuk berikut:

{
  "secret": "<generated secret>"
}

String rahasia kemudian harus dienkode ke dalam JWT. Gunakan format Token Web JSON. Kami mengasumsikan bahwa Anda telah menetapkan ${SECRET} ke string rahasia, ${ENCODED_SECRET} ke string JWT, dan ${CPI_ID} ke ID CPI yang akan divalidasi.

Perintah berikut memvalidasi identitas dan sertifikasi CPI.

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}\" }"

CPI kini dapat menginstal CBSD yang memiliki semua parameter yang diperlukan.

Pendaftaran CBSD multi-langkah

Ada dua cara untuk melakukan pendaftaran CBSD multi-langkah yang dibahas di dua bagian berikut. Anda dapat melakukan pendaftaran CBSD multi-langkah dengan parameter yang sebelumnya ditandatangani oleh CPI atau dengan akun CPI.

Dengan parameter perangkat yang sebelumnya ditandatangani oleh CPI

Contoh ini menunjukkan cara membuat konfigurasi perangkat tidak aktif dengan parameter penginstalan CBSD yang sebelumnya dienkode oleh CPI, sehingga konfigurasi dapat dibuat bahkan oleh pengguna non-CPI. Gunakan kunci pribadi CPI untuk mengenkode parameter CBSD. Kami menggunakan format Token Web JSON untuk melakukannya. Kami mengasumsikan bahwa Anda telah menetapkan ${ENCODED_DEVICE} ke string JWT dan ${CPI_ID} ke ID CPI.

Konfigurasi perangkat tidak aktif kemudian dapat dibuat dengan perintah berikut:

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}\" }"

Kemudian, CBSD harus mengirim permintaan pendaftaran ke SAS untuk menyelesaikan pendaftarannya.

Dengan akun CPI

Pertama, identitas CPI harus divalidasi sebelum Anda mencoba memvalidasi konfigurasi perangkat. Setelah selesai, gunakan perintah berikut untuk membuat konfigurasi perangkat tidak aktif:

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}"

Kami mengasumsikan bahwa Anda telah menetapkan ${DEVICE} sebagai representasi JSON dari parameter pendaftaran CBSD dalam format ini.