# 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
}