获取属性信息

设备端从云端获取属性,云端根据需要查询的属性ID,返回对应的属性内容。当需要查询的属性内容为空时,云端返回设备的所有属性。

上行

  • 请求TOPIC: /sys/{productKey}/{deviceKey}/thing/attribute/query
  • 响应TOPIC: /sys/{productKey}/{deviceKey}/thing/attribute/query_reply

请求数据格式

{
 "id": "123",
 "version": "1.0",
 "params": {
   "attributes": ["attr1", "attr2", "attr3"]
 },
 "method": "thing.attribute.query"
}

响应数据格式

{
 "id": "123",
 "code": 200,
 "data": {
   "attr1": {
       "value": 1.0,
       "value2": 9
     },
   "attr2": 1.02,
   "attr3": [1.02, 2.02, 7.93]
 }
}

参数说明

参数 类型 是否必需 描述
id String 可选 消息 ID 号,保留值
version String 必需 协议版本号,目前协议版本1.0
params Object 必需 查询属性所需的参数
attributes Array 可选 需要查询的属性的标识符的列表。一次最多可查询200个属性。如果为空,云端会将该设备的所有属性返回
method String 必需 请求方法
attr1 String 必需 查询的属性的标识符
value Struct Integer 返回的该属性的详细信息。在本例中,该属性的数据类型为struct,所以为 value 与它的值被返回
code Integer 必需 结果返回码,200代表请求成功执行
data JSON 可选 返回的详细信息。JSON格式

结果返回码

返回码 错误消息 释义
1208 Attribute query data format error 请求格式不正确