
# 设置有线网络IPv4信息
| **REST URL格式** |       **访问方法**       |                                                                                                                               **URI**                                                                                                                               ||||
| **REST URL格式** |
|---|---|---|---|---|---|
| PUT            | ~https://ip/v1/om/config~                              ||||
| **接口功能**       | 设置有线网络IPv4信息                                                                                                                                                                                                                                                                              |||||
| **接口说明**       | 设置有线网络的IPv4信息，包括网络模式、IP地址、子网掩码、网关地址、DNS设置方式、DNS服务器1、DNS服务器2、DNS服务器3                                                                                                                                                                                                                       |||||
| **响应数据**       | 参见[表1]，[表2]               |||||
| **参数**         | **参数名称**             | **可选/必选/条件必选** | **参数类型** | **位置** | **参数说明**                                                                                                                                                                                                                          |
| **参数**         | wannetmode           | **条件必选**       | int      | 无      | IPv4网络模式 0静态 1动态 当网络模式设置为静态时，ip地址与子网掩码是必选的。 当网络模式设置为动态时，ip地址与子网掩码，网关都不能携带。 |
| **参数**         | wanipaddr            | **条件必选**       | String   | 无      | IP地址                                                                                                                                                                                                                              |
| **参数**         | wansubnetmask        | **条件必选**       | String   | 无      | 子网掩码                                                                                                                                                                                                                              |
| **参数**         | wangateaddr          | **可选**         | String   | 无      | 网关地址                                                                                                                                                                                                                              |
| **参数**         | dnsmode              | **可选**         | int      | 无      | DNS设置方式 0手动 1自动 Ipv4网络模式为静态时，dns仅为手动 Ipv4网络模式为动态时，dns可分为手动与自动                |
| **参数**         | wandnsservaddr       | **可选**         | String   | 无      | DNS服务器地址1                                                                                                                                                                                                                         |
| **参数**         | wandnsspareservaddr  | **可选**         | String   | 无      | DNS服务器地址2                                                                                                                                                                                                                         |
| **参数**         | wandnsspareservaddr2 | **可选**         | String   | 无      | DNS服务器地址3                                                                                                                                                                                                                         |
| **请求消息**       | Header: Cookie: SessionID=xxx Content-Type: application/json; charset=UTF-8 X-Access-Token: xxx  Body: { "cfgItemInt":\[ {"cfgItemID":"wannetmode","cfgItemInfo":0}, {"cfgItemID":"dnsmode","cfgItemInfo":0} \], "cfgItemString":\[ {"cfgItemID":"wanipaddr", "cfgItemInfo":"192.168.15.76"}, {"cfgItemID":"wansubnetmask", "cfgItemInfo":"255.255.255.0"}, {"cfgItemID":"wangateaddr", "cfgItemInfo":"192.168.15.1"}, {"cfgItemID":"wandnsservaddr", "cfgItemInfo":"172.16.1.1"}, {"cfgItemID":"wandnsspareservaddr", "cfgItemInfo":"172.16.1.2"}, {"cfgItemID":"wandnsspareservaddr2", "cfgItemInfo":"172.16.1.3"} \] } |||||
   
 表1返回值 
| 参数      | 类型     | 取值范围     | 参数说明                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| success | int    | \[0, 1\] | 响应结果 0：失败 1：成功                                                                                 |
| data    | Object | 可选， 空对象  | 成功返回数据。这里返回空。 例如：{"success":1,"data":""}                                                                                                                                                                                |
| error   | Object | 可选       | 失败返回错误信息。参见[表2] 例如：{"success":0,"error":{"id":100666744,"code":134250502,"params":\[\]}} |
   
 表2error 
| 参数    | 类型     | 取值范围     | 参数说明                                                                                                                    |
|:---|:---|:---|:---|
| id    | int    | 32位整数    | 错误id，用于转换。                                                                                                              |
| code  | int    | 32位整数    | 错误码，跟错误id对应，具体含义参考[错误码](https://support.huaweicloud.com/ideahub-api/ideahub_05_0255.html#ZH-CN_TOPIC_0000001309671920)。 |
| param | Object | param 对象 | 失败响应的附带参数。                                                                                                              |
   
