更新时间:2024-09-24 GMT+08:00

网关批量设备属性上报

功能介绍

用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报多个子设备的属性数据。网关与子设备关系,请查看网关与子设备

属性上报和消息上报的区别,请查看消息通信说明

网关批量设备属性上报,单批次最多可上报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" 
                } 
            ] 
        } 
    ] 
}