Help Center> IoT Device Access> API Reference> 设备侧MQTT接口参考> 设备属性> 网关批量设备属性上报
View PDF

网关批量设备属性上报

功能介绍

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

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

Topic

上行：$oc/devices/{device_id}/sys/gateway/sub_devices/properties/report

参数说明

字段名

必选/可选

类型

参数描述

devices

必选

List<DeviceProperty>

设备数据

DeviceService定义表

字段名

必选/可选

类型

参数描述

device_id

必选

String

设备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" 
                } 
            ] 
        } 
    ] 
}
父主题： 设备属性