SetDevicesProperty - IoT Platform - Alibaba Cloud Documentation Center

Menetapkan nilai untuk beberapa properti perangkat sekaligus.

Catatan penggunaan

Jika data TSL bertipe float atau double, nilai parameter yang sesuai dengan data TSL tersebut harus mengandung setidaknya satu tempat desimal. Contoh: 10,0 dan 11,1.

Batas QPS

Anda dapat memanggil operasi API ini hingga 10 kali per detik per akun.

Catatan Pengguna 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	SetDevicesProperty	Operasi yang ingin Anda lakukan. Tetapkan nilai ke SetDevicesProperty.
DeviceName.N	RepeatList	Ya	light	Nama perangkat yang propertinya ingin Anda konfigurasikan. Nilai yang valid: 1 hingga 100.
Items	String	Ya	{"Switch":1,"Color":"blue"}	Properti yang ingin Anda konfigurasikan. Properti tersebut harus dalam format JSON. Setiap properti terdiri dari kombinasi pengenal properti dan nilai properti dalam format kunci:nilai. Pisahkan beberapa properti dengan koma (,). Sebagai contoh, Anda dapat mengonfigurasi properti berikut untuk lampu pintar: Properti sakelar dengan kunci Switch dan tipe data BOOLEAN. Nilainya adalah 1. Nilai 1 menunjukkan bahwa lampu menyala. Properti warna dengan kunci Color dan tipe data STRING. Nilainya adalah blue. Dalam kasus ini, Anda dapat mengonfigurasi properti berikut dalam format JSON: `Items={"Switch":1,"Color":"blue"}` Catatan Jika Anda mengonfigurasi properti untuk modul kustom testFb, tentukan `Items={"testFb:Switch":1,"testFb:Color":"blue"}`. Modul testFb bukan modul default.
ProductKey	String	Ya	a1BwAGV****	ProductKey dari Produk tempat Perangkat tersebut terdaftar.
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 menentukan ID tersebut untuk parameter ini. Jika tidak, panggilan akan gagal. Jika tidak ada halaman Overview atau ID yang dihasilkan untuk instans Anda, Anda tidak perlu mengonfigurasi parameter ini. Untuk informasi selengkapnya, lihat Overview.
Qos	Integer	Tidak	1	Tingkat Quality of Service (QoS) dari pesan. Nilai yang valid: 0 (default): Sistem mengirim pesan paling banyak satu kali. 1: Sistem mengirim pesan paling sedikit satu kali. Jika respons PUBACK tidak dikembalikan setelah Anda memublikasikan pesan QoS 1, pesan tersebut akan dikirim ulang ke Perangkat saat Perangkat terhubung kembali ke Platform IoT.

Selain parameter permintaan spesifik operasi di atas, Anda harus mengonfigurasi parameter permintaan umum saat memanggil operasi ini. Untuk informasi selengkapnya tentang parameter permintaan umum, lihat Common parameters.

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
Code	String	iot.system.SystemException	Kode kesalahan yang dikembalikan jika panggilan gagal. Untuk informasi selengkapnya, lihat Error codes.
ErrorMessage	String	A system exception occurred.	Pesan error yang dikembalikan jika panggilan gagal.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	ID permintaan.
Success	Boolean	true	Menunjukkan apakah panggilan berhasil. Nilai yang valid: true: Panggilan berhasil. false: Panggilan gagal.

Contoh

Contoh permintaan

https://iot.cn-shanghai.aliyuncs.com/?Action=SetDevicesProperty
&DeviceName.1=1102andriod02
&DeviceName.2=1102android01
&Items=%7B%20%20%20%20%20%22Data%22%3A%221372060916%22%2C%20%20%20%20%20%22Status%22%3A1%20%7D
&ProductKey=a1hWjHD****
&<Common request parameters>

Contoh respons sukses

XML format

<SetDevicesPropertyResponse>
  <RequestId>2E19BDAF-0FD0-4608-9F41-82D230CFEE38</RequestId>
  <Success>true</Success>
</SetDevicesPropertyResponse>

JSON format

{
  "RequestId": "2E19BDAF-0FD0-4608-9F41-82D230CFEE38",
  "Success": true
}

Kode kesalahan

Untuk daftar kode kesalahan, lihat Service error codes.