BatchGetDeviceState - IoT Platform - Alibaba Cloud Documentation Center

Menanyakan status beberapa perangkat sekaligus.

Description

Saat memanggil operasi ini, Anda dapat:

Menentukan nilai untuk parameter ProductKey dan beberapa nilai untuk parameter DeviceName guna menanyakan status perangkat dalam satu produk.
Menentukan beberapa nilai untuk parameter guna menanyakan status perangkat dari berbagai produk.

Penting Anda dapat menanyakan status hingga 50 perangkat dalam satu panggilan.

QPS limits

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

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.

Request parameters

Parameter	Type	Required	Example	Description
Action	String	Yes	BatchGetDeviceState	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke BatchGetDeviceState.
DeviceName.N	RepeatList	No	light	Nama-nama perangkat. Penting Jika Anda mengonfigurasi parameter ini, Anda juga harus menentukan nilai untuk parameter ProductKey.
IotInstanceId	String	No	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 instans Anda tidak memiliki halaman Overview atau ID, Anda tidak perlu mengonfigurasi parameter ini. Untuk informasi selengkapnya, lihat Overview.
ProductKey	String	No	a1BwAGV****	ProductKey produk tempat perangkat tersebut terdaftar. Penting Jika Anda mengonfigurasi parameter ini, Anda juga harus menentukan nilai untuk parameter DeviceName.
IotId.N	RepeatList	No	Q7uOhVRdZRRlDnTLv****00100	ID perangkat. Penting Parameter IotId menentukan ID Unik Global (GUID) untuk perangkat. Nilai parameter IotId berkorespondensi dengan kombinasi nilai parameter ProductKey dan DeviceName. Jika Anda mengonfigurasi parameter ini, Anda tidak perlu mengonfigurasi parameter ProductKey atau DeviceName. Jika Anda menentukan nilai untuk parameter IotId, ProductKey, dan DeviceName, nilai parameter IotId akan didahulukan.

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

Response parameters

Parameter	Type	Example	Description
Code	String	iot.system.SystemException	Kode kesalahan yang dikembalikan jika panggilan gagal. Untuk informasi selengkapnya, lihat Error codes.
DeviceStatusList	Array of DeviceStatus		Informasi status perangkat yang dikembalikan jika panggilan berhasil. Untuk informasi selengkapnya, lihat parameter berikut yang termasuk dalam parameter DeviceStatus.
DeviceStatus
AsAddress	String	192.0.2.1	Alamat IP perangkat.
DeviceId	String	dwnS41bhNxjslDAI****	ID perangkat (tidak berlaku lagi). Catatan Parameter ini tidak lagi didukung. Jangan gunakan parameter ini untuk mengidentifikasi perangkat. Anda dapat menggunakan nilai parameter IotId atau kombinasi nilai parameter ProductKey dan DeviceName untuk mengidentifikasi perangkat.
DeviceName	String	light	DeviceName perangkat.
IotId	String	dwnS41bhNxjslDAI****000100	ID perangkat. ID ini merupakan pengenal unik yang dikeluarkan oleh IoT Platform untuk perangkat tersebut.
LastOnlineTime	String	2020-01-17 16:19:11	Waktu terakhir perangkat online.
Status	String	OFFLINE	Status perangkat. Nilai yang valid: ONLINE: Perangkat sedang online. OFFLINE: Perangkat sedang offline. UNACTIVE: Perangkat belum diaktifkan. DISABLE: Perangkat dinonaktifkan.
ErrorMessage	String	A system exception occurred.	Pesan kesalahan 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.

Examples

Contoh permintaan

https://iot.cn-shanghai.aliyuncs.com/?Action=BatchGetDeviceState
&productKey=a1BwAGV****
&DeviceName.1=device1
&DeviceName.2=device2
&<Common request parameters>

Contoh respons sukses

XML format

<BatchGetDeviceStateResponse>
  <DeviceStatusList>
        <DeviceStatus>
              <Status>OFFLINE</Status>
              <DeviceId>dwnS41bhNxjslDAI****</DeviceId>
              <DeviceName>Humidity</DeviceName>
              <AsAddress>192.0.2.1</AsAddress>
              <LastOnlineTime>2020-01-17 16:19:11</LastOnlineTime>
              <IotId>dwnS41bhNxjslDAI****000100</IotId>
        </DeviceStatus>
  </DeviceStatusList>
  <RequestId>3258D872-EDC5-4039-B564-C27ED7176741</RequestId>
  <Success>true</Success>
</BatchGetDeviceStateResponse>

JSON format

{
	"DeviceStatusList": {
		"DeviceStatus": [
			{
				"Status": "OFFLINE",
				"DeviceId": "dwnS41bhNxjslDAI****",
				"DeviceName": "Humidity",
				"AsAddress": "192.0.2.1",
				"LastOnlineTime": "2020-01-17 16:19:11",
				"IotId": "dwnS41bhNxjslDAI****000100"
			}
		]
	},
	"RequestId": "3258D872-EDC5-4039-B564-C27ED7176741",
	"Success": true
}

Error codes

Untuk daftar kode kesalahan, lihat Service error codes.