上报属性信息

设备端上报属性的新值,云端根据上报的请求,更新对应的属性内容。

上行

  • 请求TOPIC:/sys/{productKey}/{deviceKey}/thing/attribute/update
  • 响应TOPIC:/sys/{productKey}/{deviceKey}/thing/attribute/update_reply

请求数据格式

{
    "id":"123",
    "version":"1.0",
    "params":{
        "attributes":{
            "attr1":{
                "value":1,
                "value2":9
            },
            "attr2":1.02,
            "attr3":[
                1.02,
                2.02,
                7.93
            ]
        }
    },
    "method":"thing.attribute.update"
}

响应数据格式

{
 "id": "123",
 "code": 200,
 "data": {}
}

参数说明

参数 类型 是否必需 描述
id String 可选 消息 ID 号,保留值
version String 必需 协议版本号,目前协议版本1.0
params Object 必需 上报属性所需的参数
attributes Object 必需 需上报的属性的标识符的列表。一次最多可上报200个属性。如果为空,则无上报的属性
method String 必需 请求方法
attr1 struct 必需 要上报的属性的标识符,在此示例中为属性 attr1 的标识符。此处设置的格式必须与服务的数据类型匹配。例如,当此参数的数据类型在模型中设置为struct时,此处的格式必须与模型中保持一致,为 valuevalue2
value String 必需 该属性中的参数名。在本例中,为 value。此处设置的值必须与服务的数据类型匹配。例如,当此参数的数据类型在模型中设置为integer时,那么值必须为integer
code Integer 必需 结果返回码,200代表请求成功执行
data JSON 可选 返回的详细信息。JSON格式

结果返回码

返回码 错误消息 释义
1204 Model validate failed 属性不符合模型定义
1207 Attribute update data format error 请求格式不正确