BatchAddDeviceGroupRelations - IoT Platform - Alibaba Cloud Documentation Center

Menambahkan satu atau beberapa perangkat ke dalam kelompok.

Batasan

Setiap Akun Alibaba Cloud dapat menjalankan maksimal 500 permintaan 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 kenyamanan 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	BatchAddDeviceGroupRelations	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke BatchAddDeviceGroupRelations.
Device.N.DeviceName	String	Ya	ZHuPo6sZzv7pOzYh****	Nama perangkat yang akan ditambahkan. Anda dapat menentukan maksimal 200 perangkat.
Device.N.ProductKey	String	Ya	a1kORrK****	ProductKey produk tempat perangkat tersebut terdaftar. Anda dapat menentukan maksimal 200 ProductKey.
GroupId	String	Ya	6VfhebLg5iUe****	ID kelompok. ID ini merupakan ID Unik Global (GUID) untuk kelompok tersebut.
IotInstanceId	String	Tidak	iot_instc_pu***_c-v64********	ID instans. Anda dapat melihat ID instans pada halaman Overview di Konsol IoT Platform. Penting Jika instans Anda memiliki ID, Anda harus mengonfigurasi parameter ini. Jika 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 khusus 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
AlreadyRelatedGroupDeviceCount	Integer	0	Jumlah perangkat yang sudah ada dalam kelompok.
Code	String	iot.system.SystemException	Kode kesalahan yang dikembalikan jika pemanggilan gagal. Untuk informasi selengkapnya, lihat Kode kesalahan.
ErrorMessage	String	A system exception occurred.	Pesan kesalahan yang dikembalikan jika pemanggilan gagal.
ExceedTenGroupDeviceCount	Integer	0	Jumlah perangkat yang ditentukan dan telah ditambahkan ke 10 kelompok atau lebih. Anda hanya dapat menambahkan satu perangkat ke maksimal 10 kelompok.
RequestId	String	671D0F8F-FDC7-4B12-93FA-336C079C965A	ID permintaan.
Success	Boolean	true	Menunjukkan apakah pemanggilan berhasil. true: Pemanggilan berhasil. false: Pemanggilan gagal.
SuccessAddedDeviceCount	Integer	2	Jumlah perangkat yang berhasil ditambahkan ke kelompok.
ValidDeviceCount	Integer	2	Jumlah perangkat valid yang Anda tentukan.

Contoh

Contoh permintaan

https://iot.cn-shanghai.aliyuncs.com/?Action=BatchAddDeviceGroupRelations
&Device.1.DeviceName=ZHuPo6sZzv7pOzYh****
&Device.1.ProductKey=a1kORrK****
&Device.2.DeviceName=rB4V9PDW2FCPmwuf****
&Device.2.ProductKey=a1kORrK****
&GroupId=6VfhebLg5iUe****
&<Common request parameters>

Contoh respons sukses

XML format

<BatchAddDeviceGroupRelationsResponse>
      <SuccessAddedDeviceCount>2</SuccessAddedDeviceCount>
      <ExceedTenGroupDeviceCount>0</ExceedTenGroupDeviceCount>
      <ErrorMessage>2 devices have been added, and 0 devices failed to be added.</ErrorMessage>
      <ValidDeviceCount>2</ValidDeviceCount>
      <AlreadyRelatedGroupDeviceCount>0</AlreadyRelatedGroupDeviceCount>
      <RequestId>671D0F8F-FDC7-4B12-93FA-336C079C965A</RequestId>
      <Success>true</Success>
</BatchAddDeviceGroupRelationsResponse>

JSON format

{
    "SuccessAddedDeviceCount":2,
    "ExceedTenGroupDeviceCount":0,
    "ErrorMessage":"2 devices have been added, and 0 devices failed to be added.",
    "ValidDeviceCount":2,
    "AlreadyRelatedGroupDeviceCount":0,
    "RequestId":"671D0F8F-FDC7-4B12-93FA-336C079C965A",
    "Success":true   
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi API Error Center.