设备属性上报
功能介绍
用于设备按产品模型中定义的格式将属性数据上报给平台。属性上报和消息上报的区别,请查看消息通信说明。

低配置且资源受限或者对网络流量有要求的设备,不适合直接构造JSON数据与物联网平台通信时,可将原始二进制数据透传到物联网平台。通过开发编解码插件实现二进制数据到平台定义JSON格式的转换。
Topic
上行:$oc/devices/{device_id}/sys/properties/report

数据上报的过程中,可以通过在topic后面携带?request_id来指定request_id。比如说消息上报:$oc/devices/{device_id}/sys/properties/report?request_id={request_id}。若不指定,平台会自动生成request_id,用于标识此次请求。
参数说明
字段名 | 必选/可选 | 类型 | 参数描述 |
|---|---|---|---|
services | 必选 | List<ServiceProperty> | 参数解释: 设备服务数据列表(具体结构参考下表ServiceProperty定义表)。 |
ServiceProperty结构定义:
字段名 | 必选/可选 | 类型 | 参数描述 |
|---|---|---|---|
service_id | 必选 | String | 参数解释: 设备的服务ID,由创建的产品模型确定。 |
properties | 必选 | Object | 参数解释: 设备服务的属性列表,具体字段在设备关联的产品模型中定义,可以设置多个字段。 |
event_time | 可选 | String | 参数解释: 设备采集数据UTC时间(格式可选:秒级别:yyyyMMdd'T'HHmmss'Z',毫秒级别:yyyy-MM-dd'T'HH:mm:ss.SSS'Z'),如:20161219T114920Z或者2020-08-12T12:12:12.333Z。 设备上报数据不带该参数或参数格式错误时,则数据上报时间以平台时间为准。 |
示例
Topic: $oc/devices/{device_id}/sys/properties/report
数据格式:
{
"services": [{
"service_id": "Temperature",
"properties": {
"value": 57,
"value2": 60
},
"event_time": "20151212T121212Z"
},
{
"service_id": "Battery",
"properties": {
"level": 80,
"level2": 90
},
"event_time": "20151212T121212Z"
}
]
} 
