BatchRegisterDevice - IoT Platform - Alibaba Cloud Documentation Center

Mendaftarkan beberapa perangkat dalam satu Produk. NamaPerangkat (DeviceNames) dari perangkat tersebut dihasilkan secara acak.

Catatan Penggunaan

Anda dapat menggunakan salah satu metode berikut untuk mendaftarkan beberapa perangkat:

Jika Anda ingin menghasilkan NamaPerangkat (DeviceNames) secara acak, panggil operasi BatchRegisterDevice.
Lakukan langkah-langkah berikut untuk mendaftarkan perangkat dan melihat hasilnya:
1. Panggil operasi BatchRegisterDevice untuk mendaftarkan beberapa perangkat. Respons yang berhasil menunjukkan bahwa permintaan pendaftaran telah diajukan. Proses pendaftaran aktual diimplementasikan secara asinkron dan memerlukan beberapa menit.
2. Panggil operasi QueryBatchRegisterDeviceStatus untuk menanyakan hasil pendaftaran perangkat.
3. Panggil operasi QueryPageByApplyId untuk melihat detail perangkat yang telah terdaftar. Detail tersebut mencakup parameter NamaPerangkat (DeviceName), RahasiaPerangkat (DeviceSecret), dan IotId.
Jika Anda ingin menentukan NamaPerangkat (DeviceNames) kustom, panggil operasi BatchRegisterDeviceWithApplyId. Untuk informasi selengkapnya, lihat BatchRegisterDeviceWithApplyId.

Batasan

Anda dapat membuat maksimal 10.000 perangkat dalam satu panggilan.
Setiap Akun Alibaba Cloud dapat menjalankan maksimal 10 kueri per detik (QPS).
Catatan Pengguna RAM dari suatu Akun Alibaba Cloud berbagi kuota akun tersebut.

Debugging

Alibaba Cloud menyediakan OpenAPI Explorer untuk menyederhanakan penggunaan API. OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kemudahan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

Parameter Permintaan

Parameter	Tipe	Wajib	Contoh	Deskripsi
Action	String	Ya	BatchRegisterDevice	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke BatchRegisterDevice.
Count	Integer	Ya	100	Jumlah perangkat yang akan didaftarkan. Catatan Anda dapat mendaftarkan hingga 10.000 perangkat dalam satu panggilan.
ProductKey	String	Ya	a1BwAGV****	ProductKey dari Produk tempat perangkat tersebut berada.
IotInstanceId	String	Tidak	iot_instc_pu***_c-v64********	ID instans. Anda dapat melihat ID instans pada halaman Overview di Konsol Platform IoT. Penting Jika instans Anda memiliki ID, Anda harus mengonfigurasi parameter ini. Jika Anda tidak menyetel parameter ini, pemanggilan akan gagal. Jika instans Anda tidak memiliki halaman Overview atau ID, Anda tidak perlu menyetel parameter ini. Untuk informasi selengkapnya, lihat Overview.

Selain parameter permintaan spesifik operasi di atas, Anda harus menentukan parameter permintaan umum saat memanggil operasi ini. Untuk informasi selengkapnya, lihat Parameter permintaan umum.

Parameter Respons

Parameter	Tipe	Contoh	Deskripsi
Code	String	iot.system.SystemException	Kode kesalahan yang dikembalikan jika pemanggilan gagal. Untuk informasi selengkapnya, lihat Kode kesalahan.
Data	Struct		Data yang dikembalikan jika pemanggilan berhasil.
ApplyId	Long	1295006	ID aplikasi (ApplyId) yang dikembalikan untuk permintaan jika pemanggilan berhasil.
ErrorMessage	String	A system exception occurred.	Pesan kesalahan yang dikembalikan jika pemanggilan gagal.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	ID permintaan.
Success	Boolean	true	Menunjukkan apakah pemanggilan berhasil. true: Pemanggilan berhasil. false: Pemanggilan gagal.

Contoh

Contoh permintaan

https://iot.cn-shanghai.aliyuncs.com/?Action=BatchRegisterDevice
&ProductKey=a1BwAGV****
&Count=10
&<Common request parameters>

Contoh respons sukses

XML format

<BatchRegisterDeviceResponse>
  <Data>
        <ApplyId>12345678</ApplyId>
  </Data>
  <RequestId>92C67DC1-41B5-45F8-9AFD-1FB42448D405</RequestId>
  <Success>true</Success>
</BatchRegisterDeviceResponse>

JSON format

{
    "Data": {
        "ApplyId": 12345678
    },
    "RequestId": "92C67DC1-41B5-45F8-9AFD-1FB42448D405",
    "Success": true
}

Kode Kesalahan

Untuk daftar kode kesalahan, kunjungi API Error Center.