
# 添加网关子设备
![](https://support.huaweicloud.com/devg-roma/public_sys-resources/note_3.0-zh-cn.png)
该Topic仅用于网关添加新的子设备，不能用于绑定一个已存在的子设备到该网关下。
#### 主题Topic
|   Topic   | /v1/devices/{gatewayId}/topo/add |
|---|---|
| **消息发送方** | 边设备                              |
| **消息接收方** | 物联网平台                            |
   
#### 参数说明
| **字段名**     | **必选/可选** | **类型**              | **参数描述**            |
|:---|:---|:---|:---|
| mid         | 必选        | Integer             | 命令ID。               |
| deviceInfos | 必选        | List\<DeviceInfos\> | 子设备信息列表，列表大小1\~100。 |
   
DeviceInfos结构体说明
| **字段名**        | **必选/可选** | **类型** | **参数描述**                                                                               |
|:---|:---|:---|:---|
| nodeId         | 必选        | String | 设备标识。 支持英文大小写，数字和中划线，长度2-64。                             |
| name           | 可选        | String | 设备名称。 支持英文大小写，数字，中划线和#，长度2-64。                         |
| description    | 可选        | String | 设备描述。 描述长度不能超过200。                                       |
| manufacturerId | 必选        | String | 厂商ID。与该网关同属一个集成应用，产品类型为普通产品。 支持英文大小写，数字，中划线和下划线，长度2-50。 |
| model          | 必选        | String | 产品型号。与厂商ID对应的产品型号。 支持英文大小写，数字，中划线和下划线，长度2-50。           |
   
#### 示例
```
{
       "deviceInfos": [{
              "manufacturerId": "Test_n",
              "model": "A_n",
              "nodeId": "n-device"
       }],
       "mid": 7
}
```
