SaveDeviceProp - IoT Platform - Alibaba Cloud Documentation Center

Menetapkan tag untuk perangkat.

Catatan penggunaan

Satu perangkat dapat memiliki maksimal 100 tag.
Anda dapat memodifikasi atau menambahkan hingga 100 tag sekaligus.

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

Parameter permintaan

Parameter	Tipe	Wajib	Contoh	Deskripsi
Action	String	Ya	SaveDeviceProp	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke SaveDeviceProp.
Props	String	Ya	{"color":"red"}	Tag yang ingin Anda tentukan untuk perangkat. Anda dapat menentukan beberapa tag. Tag harus berupa data JSON dalam format Key:Value. Key menunjukkan nama tag, dan Value menunjukkan nilai tag. Pisahkan beberapa tag dengan koma (,). Contoh: Props={"color":"red","shape":"round"} Penting Ukuran maksimum parameter Props adalah 5 KB. `abc` adalah key yang dicadangkan oleh Platform IoT. Anda tidak dapat menetapkan Key ke abc. Jika Anda menetapkan `Key` ke abc, tag abc akan secara otomatis difilter saat Anda melakukan kueri tag.
IotInstanceId	String	Tidak	iot_instc_pu***_c-v64********	ID instans. Di halaman Overview di 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 selengkapnya tentang instans, lihat Overview.
ProductKey	String	Tidak	a1BwAGV****	ProductKey produk tempat perangkat tersebut terdaftar. Catatan Jika Anda menentukan parameter ini, Anda juga harus menentukan parameter DeviceName.
DeviceName	String	Tidak	light	DeviceName perangkat. Catatan Jika Anda menentukan parameter ini, Anda juga harus menentukan parameter ProductKey.
IotId	String	Tidak	Q7uOhVRdZRRlDnTLv****00100	ID perangkat. ID ini merupakan pengenal unik yang dikeluarkan oleh Platform IoT untuk perangkat tersebut. Catatan Jika Anda menentukan parameter ini, Anda tidak perlu menentukan parameter ProductKey atau DeviceName. Parameter IotId menentukan ID Unik Global (GUID) untuk perangkat tersebut. Nilai parameter IotId berkorespondensi dengan kombinasi nilai parameter ProductKey dan DeviceName. Jika Anda menentukan parameter IotId, ProductKey, dan DeviceName, nilai parameter IotId akan diutamakan.

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

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
Code	String	iot.system.SystemException	Kode kesalahan yang dikembalikan jika pemanggilan gagal. Untuk informasi selengkapnya tentang kode kesalahan, lihat Kode kesalahan.
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=SaveDeviceProp
&ProductKey=a1BwAGV****
&DeviceName=device1
&Props=%7B%22color%22%3A%22red%22%7D
&<Common request parameters>

Contoh respons sukses

Format XML

<SaveDevicePropResponse>
  <RequestId>57b144cf-09fc-4916-a272-a62902d5b207</RequestId>
  <Success>true</Success>
</SaveDevicePropResponse>

Format JSON

{
    "RequestId":"57b144cf-09fc-4916-a272-a62902d5b207",
    "Success": true
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi API Error Center.