# 网关批量设备属性上报
#### 功能介绍
用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报多个子设备的属性数据。网关与子设备关系，请查看[网关和子设备](https://support.huaweicloud.com/usermanual-iothub/iot_01_0052.html)。
属性上报和消息上报的区别，请查看[数据上报概述](https://support.huaweicloud.com/usermanual-iothub/iot_01_0045_2.html)。
![](https://support.huaweicloud.com/api-iothub/public_sys-resources/note_3.0-zh-cn.png)
网关批量设备属性上报，单批次最多可上报100个子设备的属性数据。如果子设备数量超过100个，建议分不同批次进行上报。
#### Topic
上行：$oc/devices/{device_id}/sys/gateway/sub_devices/properties/report
![](https://support.huaweicloud.com/api-iothub/public_sys-resources/note_3.0-zh-cn.png)
Topic中device_id为网关设备的设备id。
#### 参数说明
| 字段名     | 必选/可选 | 类型                    | 参数描述                                                                                                                   |
|:---|:---|:---|:---|
| devices | 必选    | List\<DeviceService\> | **参数解释：** 设备数据，是一个字段名为devices的数组，用于存放不同子设备的属性上报。 |
   
DeviceService定义表：
| 字段名       | 必选/可选 | 类型                      | 参数描述                                                                                                                   |
|:---|:---|:---|:---|
| device_id | 必选    | String                  | **参数解释：** 此处device_id为网关设备所属的子设备id，用于标记不同子设备的属性上报。 |
| services  | 必选    | List\<ServiceProperty\> | **参数解释：** 设备服务数据列表。                             |
   
ServiceProperty定义表：
| 字段名        | 必选/可选 | 类型     | 参数描述                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| service_id | 必选    | String | **参数解释：** 设备的服务ID，由创建的[产品模型](https://support.huaweicloud.com/devg-iothub/iot_02_0005.html)确定。                                                                                                                                                    |
| 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" 
                } 
            ] 
        } 
    ] 
}
```