调用该接口批量查看指定设备的运行状态,包括设备当前状态、设备状态变更时间和设备最后一次上线时间等。
使用说明
调用本接口时:
- 请求参数同时传入ProductKey和多个DeviceName:查询同一产品多个设备的运行状态。
- 请求参数传入多个IotId:可传入不同产品下设备的IotId,查询不同产品下设备的运行状态。
单次调用本接口最多可查询50个设备的运行状态。
QPS限制
单个阿里云账号调用该接口的每秒请求数(QPS)最大限制为50。
单个阿里云账号下的所有RAM用户共享该阿里云账号的配额。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | BatchGetDeviceState | 系统规定参数。取值:BatchGetDeviceState。 |
DeviceName.N | RepeatList | 否 | light | 要查看运行状态的设备的名称列表。 如果传入该参数,需同时传入ProductKey。
|
IotInstanceId | String | 否 | iot_instc_pu****_c*-v64******** | 实例ID。您可在物联网平台控制台的实例概览页面,查看当前实例的ID。
实例的更多信息,请参见实例概述。 |
ProductKey | String | 否 | a1BwAGV**** | 要查看运行状态的设备所属的产品ProductKey。 如果传入该参数,需同时传入DeviceName。
|
IotId.N | RepeatList | 否 | Q7uOhVRdZRRlDnTLv****00100 | 要查看运行状态的设备ID列表。 IotId作为设备唯一标识符,和ProductKey与DeviceName组合是一一对应的关系。如果传入该参数,则无需传入ProductKey和DeviceName。如果您同时传入IotId和ProductKey与DeviceName组合,则以IotId为准。
|
调用API时,除了本文介绍的该API的特有请求参数,还需传入公共请求参数。公共请求参数说明,请参见公共参数文档。
返回数据
示例
请求示例
https://iot.cn-shanghai.aliyuncs.com/?Action=BatchGetDeviceState
&productKey=a1BwAGV****
&DeviceName.1=device1
&DeviceName.2=device2
&<公共请求参数>
正常返回示例
XML
格式
<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>
<Timestamp>1557062301656</Timestamp>
<IotId>dwnS41bhNxjslDAI****000100</IotId>
</DeviceStatus>
</DeviceStatusList>
<RequestId>3258D872-EDC5-4039-B564-C27ED7176741</RequestId>
<Success>true</Success>
</BatchGetDeviceStateResponse>
JSON
格式
{
"DeviceStatusList": {
"DeviceStatus": [
{
"Status": "OFFLINE",
"DeviceId": "dwnS41bhNxjslDAI****",
"DeviceName": "Humidity",
"AsAddress": "192.0.2.1",
"LastOnlineTime": "2020-01-17 16:19:11",
"Timestamp":1557062301656,
"IotId": "dwnS41bhNxjslDAI****000100"
}
]
},
"RequestId": "3258D872-EDC5-4039-B564-C27ED7176741",
"Success": true
}
该文章对您有帮助吗?
- 本页导读 (1)
- 使用说明
- QPS限制
- 调试
- 请求参数
- 返回数据
- 示例