All Products
Search
Document Center

IoT Platform:Buat beberapa perangkat sekaligus

Last Updated:Jun 16, 2026

Produk adalah kumpulan perangkat yang memiliki fitur yang sama. Setelah membuat produk, Anda harus menambahkan perangkat dan mendapatkan sertifikatnya. Anda dapat membuat beberapa perangkat sekaligus di Konsol IoT Platform.

Prasyarat

Produk telah dibuat. Untuk informasi selengkapnya, lihat Buat produk.

Prosedur

  1. Masuk ke Konsol IoT Platform.

  2. Pada halaman Overview, temukan instans yang ingin Anda kelola, lalu klik ID instans atau nama instans tersebut.

  3. Di panel navigasi sebelah kiri, pilih Devices > Devices.

  4. Pada halaman Devices, klik Batch Add.

  5. Pilih produk. Perangkat baru akan mewarisi fitur dari produk ini.

    Penting

    Jika produk tersebut dikaitkan dengan platform lain, pastikan akun Anda memiliki kuota kode aktivasi yang mencukupi untuk membuat perangkat.

    Atur Add Method ke Auto Generate, atur Device Quantity ke 100, lalu klik OK.

  6. Pilih metode untuk menentukan DeviceName.

    • Auto Generate: Masukkan jumlah perangkat. IoT Platform akan menghasilkan DeviceName acak yang terdiri dari huruf dan angka untuk setiap perangkat.

    • Batch Upload: Tentukan nama untuk setiap perangkat. Klik Download .csv Template, masukkan DeviceName dan Nickname untuk setiap perangkat dalam templat tersebut, lalu unggah file ke Konsol IoT Platform.

      Penting
      • Jangan ubah baris pertama. Mulai memasukkan data dari sel A2.

      • DeviceName harus terdiri dari 4 hingga 32 karakter dan dapat berisi huruf, angka, tanda hubung (-), garis bawah (_), tanda @, titik (.), dan titik dua (:). DeviceName harus unik dalam satu produk.

      • Nickname adalah alias opsional untuk perangkat. Alias harus terdiri dari 4 hingga 64 karakter dan dapat berisi karakter Tionghoa, Jepang, huruf, angka, serta garis bawah (_). Satu karakter Tionghoa atau Jepang dihitung sebagai dua karakter.

      • Satu file dapat berisi maksimal 10.000 catatan dan ukurannya tidak boleh melebihi 2 MB.

  7. Klik OK.

    Jika daftar yang diunggah berisi nama perangkat yang tidak valid, pesan kesalahan akan muncul. Klik Download Invalid Device Name List untuk melihat nama yang tidak valid, perbaiki, lalu unggah ulang file tersebut.

  8. Setelah perangkat dibuat, klik Download Device Certificate untuk mengunduh sertifikat perangkat. Anda dapat membakar sertifikat tersebut ke perangkat.

    Sertifikat perangkat terdiri dari ProductKey, DeviceName, dan DeviceSecret. Perangkat memerlukan kredensial ini untuk berkomunikasi dengan IoT Platform. Simpan sertifikat tersebut secara aman.

    Parameter

    Deskripsi

    ProductKey

    ProductKey dari produk tempat perangkat tersebut berada. ProductKey adalah GUID yang dikeluarkan oleh IoT Platform untuk produk tersebut.

    DeviceName

    DeviceName perangkat, yaitu pengidentifikasi unik perangkat dalam produk. Kombinasi DeviceName dan ProductKey digunakan sebagai pengidentifikasi perangkat. IoT Platform melakukan autentikasi dan berkomunikasi dengan perangkat berdasarkan pengidentifikasi tersebut.

    DeviceSecret

    DeviceSecret perangkat, yang dikeluarkan oleh IoT Platform untuk autentikasi dan enkripsi perangkat. DeviceSecret harus digunakan bersama dengan DeviceName.

Hasil

Setelah perangkat dibuat, buka tab Batch Management pada halaman Devices. Temukan produk yang sesuai, lalu klik salah satu opsi berikut:

  • Details: Lihat Number of Added Devices dan daftar perangkat untuk batch tersebut. Daftar tersebut mencakup informasi seperti sertifikat perangkat dan status.

    Jika beberapa perangkat gagal dibuat, kode kesalahan dan penyebabnya akan ditampilkan dalam daftar perangkat. Tabel berikut menjelaskan kode kesalahan tersebut.

    Kode kesalahan

    Pesan

    Deskripsi

    460

    duplicated deviceName

    Nama perangkat duplikat.

    invalid deviceName

    Nama perangkat tidak valid.

    6251

    device exist

    Perangkat sudah ada.

    6760

    insufficient activation code

    Kuota kode aktivasi Anda tidak mencukupi.

    64003

    device creation failed

    Perangkat gagal dibuat karena operasi konkuren.

    6293

    device has been distributed

    Perangkat telah didistribusikan.

  • DownloadCSV: Unduh sertifikat perangkat dalam batch ini.

Langkah selanjutnya

Anda dapat melihat informasi perangkat. Untuk informasi selengkapnya, lihat Lihat informasi perangkat.

Setelah membuat perangkat, status perangkat tersebut adalah Inactive. Untuk mengaktifkan perangkat, Anda harus menggunakan SDK perangkat untuk menghubungkan perangkat ke IoT Platform. Untuk informasi selengkapnya, lihat Gunakan SDK perangkat untuk menghubungkan perangkat ke IoT Platform.设备未激活

Untuk informasi lebih lanjut tentang cara menghubungkan perangkat ke IoT Platform, lihat topik berikut:

Operasi API terkait

BatchRegisterDevice: Mendaftarkan beberapa perangkat sekaligus.