# 查询有线网络IPv4信息
| **REST URL格式** |       **访问方法**       |                                                                                                                        **URI**                                                                                                                        ||||
| **REST URL格式** |
|---|---|---|---|---|---|
| POST           | ~https://ip/v1/om/config~                    ||||
| **接口功能**       | 查询有线网络IPv4信息                                                                                                                                                                                                                                                                |||||
| **接口说明**       | 查询有线网络的IPv4信息，包括网络模式、IP地址、子网掩码、网关地址、DNS设置方式、DNS服务器1、DNS服务器2、DNS服务器3                                                                                                                                                                                                         |||||
| **响应数据**       | 参见[表1],[表2] |||||
| 参数             | 参数名称                 | 可选/必选/条件必选 | 参数类型   | 位置 | 参数说明                                                                                                                                                                                                                          |
| 参数             | wannetmode           | 可选         | int    | 无  | IPv4网络模式 0静态 1动态                                                                                                                                                                                                              |
| 参数             | 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: { "cfgIDString":\[ "wannetmode", "wanipaddr", "wansubnetmask", "wangateaddr", "dnsmode", "wandnsservaddr", "wandnsspareservaddr", "wandnsspareservaddr2" \] } |||||
   
 表1返回值 
| 参数      | 类型     | 取值范围     | 参数说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| success | int    | \[0, 1\] | 响应结果 0：失败 1：成功                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| data    | Object | 可选， 空对象  | 成功返回数据。这里返回空。 例如： { "success":1, "data":"{ \\"wannetmode\\":0, \\"wanipaddr\\":\\"192.168.15.76\\", \\"wansubnetmask\\":\\"255.255.255.0\\", \\"wangateaddr\\":\\"192.168.15.1\\", \\"dnsmode\\":0, \\"wandnsservaddr\\":\\"172.16.1.1\\", \\"wandnsspareservaddr\\":\\"172.16.1.2\\", \\"wandnsspareservaddr2\\":\\"172.16.1.3\\" }" } |
| 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 对象 | 失败响应的附带参数。                                                                                                              |