SetDeviceGroupTags - IoT Platform - Alibaba Cloud Documentation Center

Menambahkan, memperbarui, atau menghapus tag grup.

Catatan penggunaan

Satu kelompok perangkat dapat memiliki maksimal 100 tag.

Batas QPS

Setiap Akun Alibaba Cloud dapat menjalankan hingga 50 permintaan per detik (QPS).

Catatan Pengguna Manajemen Akses Sumber Daya (RAM) dari suatu Akun Alibaba Cloud berbagi kuota akun tersebut.

Debugging

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 untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Required	Contoh	Deskripsi
Action	String	Yes	SetDeviceGroupTags	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke SetDeviceGroupTags.
GroupId	String	Yes	W16X8Tvdosec****	ID kelompok. ID ini merupakan ID Unik Global (GUID) untuk kelompok tersebut.
IotInstanceId	String	No	iot_instc_pu***_c-v64********	ID instans. Di halaman Overview pada Konsol Platform IoT, Anda dapat melihat ID instans tersebut. Penting Jika instans Anda memiliki ID, Anda harus menentukan ID tersebut untuk parameter ini. Jika tidak, pemanggilan akan gagal. Jika halaman Overview atau ID instans tidak ditampilkan di Konsol Platform IoT, Anda tidak perlu mengonfigurasi parameter ini. Untuk informasi lebih lanjut tentang instans, lihat Overview.
TagString	String	No	[{"tagKey":"h1","tagValue":"rr"},{"tagKey":"7h","tagValue":"rr"}]	Data tag dalam format JSON. Parameter TagString menentukan beberapa tag dalam bentuk pasangan kunci-nilai. Anda harus menentukan tagKey dan tagValue untuk setiap tag. tagKey: kunci tag. Panjang kunci harus antara 2 hingga 30 karakter, dan dapat berisi huruf, angka, serta titik (.). tagValue: nilai tag. Setiap nilai dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-). Panjang nilai harus antara 1 hingga 128 karakter. Pisahkan beberapa tag dengan koma (,). Contoh: `[{"tagKey":"h1","tagValue":"rr"},{"tagKey":"7h","tagValue":"rr"}]` Jika Anda menentukan nilai baru untuk tag yang sudah ada, nilai tag baru akan menimpa nilai aslinya. Jika Anda ingin menghapus tag, Anda tidak perlu menentukan kunci dan nilainya. Penting `abc` adalah kunci yang dicadangkan oleh Platform IoT. Anda tidak dapat mengatur tagKey menjadi abc. Jika Anda mengatur `tagKey` menjadi abc, tag abc akan secara otomatis difilter saat Anda melakukan kueri tag.
GroupType	String	No	LINK_PLATFORM_DYNAMIC	Tipe kelompok. Anda tidak perlu mengonfigurasi parameter ini.

Selain parameter permintaan khusus operasi di atas, Anda harus menentukan parameter permintaan umum saat memanggil operasi ini. Untuk informasi lebih lanjut tentang parameter permintaan umum, lihat Common parameters.

Parameter respons

Parameter	Type	Contoh	Deskripsi
Code	String	iot.system.SystemException	Kode kesalahan yang dikembalikan jika pemanggilan gagal. Untuk informasi lebih lanjut tentang kode kesalahan, lihat Error codes.
ErrorMessage	String	A system exception occurred.	Pesan kesalahan yang dikembalikan jika pemanggilan gagal.
RequestId	String	12CFDAF1-99D9-42E0-8C2F-F281DA5E8953	ID permintaan.
Success	Boolean	true	Menunjukkan apakah pemanggilan berhasil. Nilai yang valid: true: Pemanggilan berhasil. false: Pemanggilan gagal.

Contoh

Contoh permintaan

https://iot.cn-shanghai.aliyuncs.com/?Action=SetDeviceGroupTags
&GroupId=W16X8Tvdosec****
&TagString=[{"tagKey":"h1","tagValue":"rr"},{"tagKey":"7h","tagValue":"rr"}]
&<Common request parameters>

Contoh respons sukses

XML format

<SetDeviceGroupTagsResponse>
      <RequestId>12CFDAF1-99D9-42E0-8C2F-F281DA5E8953</RequestId>
      <Success>true</Success>
</SetDeviceGroupTagsResponse>

JSON format

{
    "RequestId":"12CFDAF1-99D9-42E0-8C2F-F281DA5E8953",
    "Success":true
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi API Error Center.