# 网关新增子设备请求
#### 功能介绍
网关主动新增其下接入的子设备，在平台上完成开户。网关与子设备关系，请查看[网关和子设备](https://support.huaweicloud.com/usermanual-iothub/iot_01_0052.html)。
#### Topic
上行: $oc/devices/{device_id}/sys/events/up
#### 参数说明
| 字段名              | 必选/可选 | 类型                   | 参数描述                                                                                             |
|:---|:---|:---|:---|
| object_device_id | 可选    | String               | **参数解释：** 该参数目前暂未实装使用，无需填写。 |
| services         | 必选    | List\<ServiceEvent\> | **参数解释：** 事件服务列表。           |
   
ServiceEvent定义表
| 字段名        | 必选/可选 | 类型     | 参数描述                                                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| service_id | 必选    | String | **参数解释：** 系统字段。 **取值范围：** 固定为："$sub_device_manager"。           |
| event_type | 必选    | String | **参数解释：** 系统字段。 **取值范围：** 固定为："add_sub_device_request"。 |
| event_time | 可选    | String | **参数解释：** 事件时间。UTC时间，格式：yyyyMMdd'T'HHmmss'Z'。 设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。                                              |
| event_id   | 可选    | String | **参数解释：** 事件请求Id，唯一标识这次事件请求。如果不携带该参数，该参数由物联网平台自动生成，生成规则为数字、字母、中划线组成的36位随机字符串。                                                                                                                           |
| paras      | 必选    | Object | **参数解释：** 事件参数JSON对象。                                                                                                                                                                                   |
   
paras参数列表
| 字段名     | 必选/可选 | 类型                 | 参数描述                                                                                                       |
|:---|:---|:---|:---|
| devices | 必选    | List\<DeviceInfo\> | **参数解释：** 待新增的子设备信息列表，单次增加最大不超过50个设备。 |
   
DeviceInfo定义表
| 字段名              | 必选/可选 | 类型     | 参数描述                                                                                                                                                                                  |
|:---|:---|:---|:---|
| parent_device_id | 可选    | String | **参数解释：** 父节点设备ID，默认为对应网关设备id。                                                                                    |
| node_id          | 必选    | String | **参数解释：** 设备标识。                                                                                               |
| device_id        | 可选    | String | **参数解释：** 设备ID，用于唯一标识一个设备。如果携带该参数，平台将设备ID设置为该参数值；如果不携带该参数，设备ID由物联网平台分配获得，生成规则为"product_id" + "_" + "node_id"拼接而成。 |
| name             | 可选    | String | **参数解释：** 设备名称。                                                                                                 |
| description      | 可选    | String | **参数解释：** 设备描述。                                                                                                |
| product_id       | 必选    | String | **参数解释：** 设备关联的产品ID，用于唯一标识一个产品模型，在控制台导入产品模型后由平台分配获得。                                                            |
| extension_info   | 可选    | Object | **参数解释：** 设备扩展信息。用户可以自定义任何想要的扩展信息。字段值大小上限为1K。                                                                     |
   
#### 示例
```
Topic: $oc/devices/{device_id}/sys/events/up 
数据格式： 
{
   "object_device_id": "{object_device_id}",
   "services": [
    {
      "service_id": "$sub_device_manager",
      "event_type": "add_sub_device_request",
      "event_time": "20151212T121212Z",
      "event_id": "40cc9ab1-3579-488c-95c6-c18941c99eb4",
      "paras": {
        "devices": [
          {
            "name": "subdevice11",
            "node_id": "subdevice11",
            "product_id": "c6b39067b0325db34663d3ef421a42f6",
            "description": "subdevice11"
          },
          {
            "name": "subdevice12",
            "node_id": "subdevice12",
            "product_id": "c6b39067b0325db34663d3ef421a42f6",
            "description": "subdevice12"
          }
        ]
      }
    }
  ]
}
```