GetDeviceStatus

调用该接口查看指定设备的运行状态。

请求参数

请求方式1

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

请求方式2

名称	类型	是否必选	示例值	描述
Action	String	是	GetDeviceStatus	系统规定参数。取值：GetDeviceStatus。
IotInstanceId	String	是	6912917943269****	实例ID。您可在物联网平台控制台的实例概览页面，查看当前实例的ID。
IotId	String	是	Q7uOhVRdZRRlDnTLv****00100	设备ID。物联网平台为该设备颁发的ID，设备的唯一标识符。

返回数据

名称	类型	示例值	描述
Code	String	iot.system.SystemException	调用失败时，返回的错误码。
Data	Struct		调用成功时，返回设备状态信息。
Status	String	ONLINE	设备状态。取值：ONLINE：设备在线。OFFLINE：设备离线。UNACTIVE：设备未激活。DISABLE：设备已禁用。
Timestamp	Long	1557062301656	设备状态变更时间。
ErrorMessage	String	系统异常	调用失败时，返回的出错信息。
RequestId	String	vSqY4mRyZx7aeewszBbii5Ac55bMywkk	平台为该请求生成的唯一标识符。
Success	Boolean	true	表示是否调用成功。true：调用成功。false：调用失败。

示例

请求示例

http://open.${区域}.fenydata.com/fenydata-java-open/?Action=GetDeviceStatus
&ProductKey=a1rYuVF****
&IotInstanceId=70255861902711****
&DeviceName=device1
&<公共请求参数>

正常返回示例

XML格式

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<xml>
    <RequestId>vSqY4mRyZx7aeewszBbii5Ac55bMywkk</RequestId>
    <Data>
        <Status>ONLINE</Status>
        <Timestamp>1557062301656</Timestamp>
    </Data>
    <Success>true</Success>
</xml>

JSON格式

{
  "RequestId": "vSqY4mRyZx7aeewszBbii5Ac55bMywkk",
  "Data": {
    "Status": "ONLINE",
    "Timestamp": 1557062301656
  },
  "Success": true
}