# BatchGetDeviceState

调用该接口批量查看指定设备的运行状态，包括设备当前状态、设备状态变更时间和设备最后一次上线时间等。

# 使用说明

请求参数同时传入 ProductKey 和多个 DeviceName：查询同一产品多个设备的运行状态。
请求参数传入多个 IotId：可传入不同产品下设备的 IotId，查询不同产品下设备的运行状态。

# 请求参数

# 请求方式1

名称	类型	是否必选	示例值	描述
Action	String	是	BatchGetDeviceState	系统规定参数。取值：BatchGetDeviceState。
DeviceName.N	RepeatList	是	light	要查看运行状态的设备的名称列表。
IotInstanceId	String	是	6912917943269****	实例 ID。您可在物联网平台控制台的实例概览页面，查看当前实例的 ID。
ProductKey	String	是	a1BwAGV****	要查看运行状态的设备所属的产品 `ProductKey`。

# 请求方式2

名称	类型	是否必选	示例值	描述
Action	String	是	BatchGetDeviceState	系统规定参数。取值：BatchGetDeviceState。
IotInstanceId	String	是	6912917943269****	实例 ID。您可在物联网平台控制台的实例概览页面，查看当前实例的 ID。
IotId.N	RepeatList	是	Q7uOhVRdZRRlDnTLv****00100	要查看运行状态的设备 ID 列表。

# 返回数据

名称	类型	示例值	描述
Code	String	iot.system.SystemException	调用失败时，返回的错误码。
DeviceStatusList	Array of DeviceStatus		调用成功时，返回设备状态信息列表，请参见 DeviceStatus 下的参数。
DeviceStatus
AsAddress	String	192.0.2.1	设备 IP 地址。
DeviceName	String	light	设备名称。
IotId	String	dwnS41bhNxjslDAI****000100	设备 ID，物联网平台为设备颁发的唯一标识。
LastOnlineTime	String	2020-01-17 16:19:11	设备最后一次上线的时间。
Status	String	OFFLINE	设备状态。取值：ONLINE：设备在线；OFFLINE：设备离线；UNACTIVE：设备未激活；DISABLE：设备已禁用。
Timestamp	Long	1557062301656	设备状态变更时间。单位为毫秒。
ErrorMessage	String	系统异常	调用失败时，返回的出错信息。
RequestId	String	kfOY4G8bjq7sNHOMHUcRgowa8hJOxO4G	平台为该请求生成的唯一标识符。
Success	Boolean	true	是否调用成功。true：调用成功；false：调用失败。

# 示例

请求示例

http://open.${区域}.fenydata.com/fenydata-java-open/?Action=BatchGetDeviceState
&productKey=a1BwAGV****
&IotInstanceId=70255861902711****
&DeviceName.1=device1
&DeviceName.2=device2
&<公共请求参数>

正常返回示例

XML格式

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<xml>
    <DeviceStatusList>
        <DeviceStatus>
            <Status>OFFLINE</Status>
            <DeviceName>Humidity</DeviceName>
            <AsAddress>192.0.2.1</AsAddress>
            <LastOnlineTime>2020-01-17 16:19:11</LastOnlineTime>
            <Timestamp>1557062301656</Timestamp>
            <IotId>6883429709****00100</IotId>
        </DeviceStatus>
    </DeviceStatusList>
    <RequestId>kfOY4G8bjq7sNHOMHUcRgowa8hJOxO4G</RequestId>
    <Success>true</Success>
</xml>

JSON格式

{
  "DeviceStatusList": {
    "DeviceStatus": [
      {
        "Status": "OFFLINE",
        "DeviceName": "Humidity",
        "AsAddress": "192.0.2.1",
        "LastOnlineTime": "2020-01-17 16:19:11",
        "Timestamp": 1557062301656,
        "IotId": "6883429709****00100"
      }
    ]
  },
  "RequestId": "kfOY4G8bjq7sNHOMHUcRgowa8hJOxO4G",
  "Success": true
}