# QueryDevicePropertyStatus
调用该接口查询指定设备的所有属性快照。
# 请求参数
# 请求方式1
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | QueryDevicePropertyStatus | 系统规定参数。取值:QueryDevicePropertyStatus。 |
| IotInstanceId | String | 是 | 70255861902711*** | 实例ID。您可在物联网平台控制台的实例概览页面,查看当前实例的ID。 |
| ProductKey | String | 是 | a1BwAGV**** | 产品的ProductKey。可以在物联网平台控制台产品页查看。 |
| DeviceName | String | 是 | light | 指定要查询的设备的名称。 |
# 请求方式2
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | QueryDevicePropertyStatus | 系统规定参数。取值:QueryDevicePropertyStatus。 |
| IotInstanceId | String | 是 | 70255861902711*** | 实例ID。您可在物联网平台控制台的实例概览页面,查看当前实例的ID。 |
| IotId | String | 是 | 69499240330****00100 | 要查询的设备ID。物联网平台为该设备颁发的ID,设备的唯一标识符。 |
# 返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| Code | String | iot.system.SystemException | 调用失败时,返回的错误码。 |
| Data | Struct | 调用成功时,返回的数据。 | |
| List | Struct | 调用成功时,返回的数据。 | |
| PropertyStatusInfo | Array of PropertyStatusInfo | 返回的属性集合信息。 | |
| DataType | String | int | 属性格式类型,取值: int:整型。 float:单精度浮点型。 double:双精度浮点型。 enum:枚举型。 bool:布尔型。 text:字符型。 date:时间型(String类型的UTC时间戳,单位是毫秒)。 array:数组型。 struct:结构体类型。 |
| Identifier | String | Temperature | 属性标识符。 |
| Name | String | temperature | 属性名称。 |
| Time | String | 1517553572362 | 属性修改的时间,单位是毫秒。 |
| Unit | String | °C | 属性值的单位。 |
| Value | String | 25 | 属性值。 |
| ErrorMessage | String | 系统异常 | 调用失败时,返回的出错信息。 |
| RequestId | String | 2E6yNiZUHPeisuwWWbpxwabzf9LdmSWJ | 为该请求生成的唯一标识符。 |
| Success | Boolean | true | 表示是否调用成功。true:调用成功。false:调用失败。 |
# 示例
请求示例
http://open.${区域}.fenydata.com/fenydata-java-open/?Action=QueryDevicePropertyStatus
&IotInstanceId=70255861902711****
&ProductKey=a1BwAGV****
&DeviceName=light
&<公共请求参数>
正常返回示例
XML格式
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<xml>
<RequestId>6e6631b34ce64b0285949512d0508410</RequestId>
<Data>
<List>
<PropertyStatusInfo>
<DataType>int</DataType>
<Identifier>asd</Identifier>
<Name>asd</Name>
<Time>1755322902494</Time>
<Unit>%</Unit>
<Value>1</Value>
</PropertyStatusInfo>
<PropertyStatusInfo>
<DataType>bool</DataType>
<Identifier>switch</Identifier>
<Name>switch</Name>
<Time>1755594976361</Time>
<Value>1</Value>
</PropertyStatusInfo>
</List>
</Data>
<Success>true</Success>
</xml>
JSON格式
{
"RequestId": "1741509cffb6480f93ee45f45547db1d",
"Data": {
"List": {
"PropertyStatusInfo": [
{
"DataType": "int",
"Identifier": "asd",
"Name": "asd",
"Time": "1755322902494",
"Unit": "%",
"Value": "1"
},
{
"DataType": "bool",
"Identifier": "switch",
"Name": "switch",
"Time": "1755594976361",
"Value": "1"
}
]
}
},
"Success": true
}