网关批量设备属性上报
功能介绍
用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报多个子设备的属性数据。网关与子设备关系,请查看网关与子设备。
属性上报和消息上报的区别,请查看消息通信说明。
网关批量设备属性上报,单批次最多可上报100个子设备的属性数据。如果子设备数量超过100个,建议分不同批次进行上报。
Topic
上行:$oc/devices/{device_id}/sys/gateway/sub_devices/properties/report
Topic中device_id为网关设备的设备id。
参数说明
字段名 |
必选/可选 |
类型 |
参数描述 |
---|---|---|---|
devices |
必选 |
List<DeviceService> |
参数解释: 设备数据,是一个字段名为devices的数组,用于存放不同子设备的属性上报。 |
DeviceService定义表:
字段名 |
必选/可选 |
类型 |
参数描述 |
---|---|---|---|
device_id |
必选 |
String |
参数解释: 此处device_id为网关设备所属的子设备id,用于标记不同子设备的属性上报。 |
services |
必选 |
List<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/gateway/sub_devices/properties/report 数据格式: { "devices":[ { "device_id":"bf40f0c4-4022-41c6-a201-c5133122054a", "services":[ { "service_id":"analog", "properties":{ "PhV_phsA":"1", "PhV_phsB":"2" }, "event_time":"20190606T121212Z" } ] }, { "device_id":"42aa08ea-84c1-4025-a7b2-c1f6efe547c2", "services":[ { "service_id":"analog", "properties":{ "PhV_phsA":"3", "PhV_phsB":"5" }, "event_time":"20190606T121212Z" }, { "service_id":"parameter", "properties":{ "Load":"6", "ImbA_strVal":"8" }, "event_time":"20190606T121212Z" } ] } ] }