# 网关同步子设备列表
#### 功能介绍
网关设备从平台同步子设备列表。网关设备不在线时，平台无法将子设备新增和删除的信息及时通知到网关设备。网关设备离线再上线时，可以通过此接口从平台同步这段时间内新增或者删除的子设备信息。新增的子设备信息会通过[平台通知网关子设备新增](https://support.huaweicloud.com/api-iothub/iot_06_v5_3019.html)接口通知网关设备，删除的子设备信息会通过[平台通知网关子设备删除](https://support.huaweicloud.com/api-iothub/iot_06_v5_3020.html)通知网关设备。网关与子设备关系，请查看[网关和子设备](https://support.huaweicloud.com/usermanual-iothub/iot_01_0052.html)。
#### Topic
上行: $oc/devices/{device_id}/sys/events/up
#### 参数说明
| 字段名              | 必选/可选 | 类型                   | 参数描述                                                                                              |
|:---|:---|:---|:---|
| object_device_id | 可选    | String               | **参数解释：** 该参数目前暂未实装使用，无需填写。 |
| services         | 可选    | List\<EventService\> | **参数解释：** 事件服务列表。            |
   
EventService定义表
| 字段名        | 必选/可选 | 类型     | 参数描述                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| service_id | 必选    | String | **参数解释：** 系统字段。 **取值范围：** 固定为："$sub_device_manager"。      |
| event_type | 必选    | String | **参数解释：** 系统字段。 **取值范围：** 固定为："sub_device_sync_request"。 |
| event_time | 可选    | String | **参数解释：** 事件时间。UTC时间，格式：yyyyMMdd'T'HHmmss'Z'。 设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。                                           |
| paras      | 必选    | Object | **参数解释：** 事件参数JSON对象。                                                                                                                                                                           |
   
paras参数列表
| 字段名     | 必选/可选 | 类型   | 参数描述                                                                                                                                                         |
|:---|:---|:---|:---|
| version | 可选    | Long | **参数解释：** 子设备信息版本。网关设备收到的最近一次的子设备新增或删除通知时的子设备版本信息。平台会根据此版本信息将此版本后新增或者删除的子设备信息通知给网关设备。 |
   
#### 示例
```
Topic: $oc/devices/{device_id}/sys/events/up
数据格式：
```
```
{
        "object_device_id": "{object_device_id}",
"services": [{
"service_id": "$sub_device_manager",
"event_type": "sub_device_sync_request",
"event_time": "20151212T121212Z",
"paras": {"version": 1}
}]
}
```