华为云用户手册

请求示例 HTTP的示例 DELETE /controller/campus/v1/sdwan/policy/traffic/sites/00000000-0000-0000-0000-000000000000/qos-policy?qosPolicyId=00000000-0000-0000-0000-000000000000&qosRuleId=00000000-0000-0000-0000-000000000000 HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-AC CES S-TOKEN: x-yyyyyy

请求示例 HTTP的示例 PUT /controller/campus/v2/accountservice/accessuser/users/51cdcbe3-5e14-492b-ab27-86950b661d19/password HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "password" : "Example@1234" }

响应示例 返回状态码为200：修改成功，响应体参考CommonAccessUserOutputDto。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "" } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

响应参数 返回状态码为200：修改成功，响应体参考CommonAccessUserOutputDto。 表4 CommonAccessUserOutputDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~20个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息描述。 "" 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。

请求参数 表2 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 body 是 REFERENCE 详细请参见表3。 修改密码结构体 - 表3 ModifyUserPwdInputDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 password 是 password 6~28个字符。 - 该字段可能包含敏感信息和个人数据，请妥善做好保护。 用户名。 "Example@1234"

响应示例 返回状态码为200：接口调用成功，响应体参考StaticArpResponse。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "vpnId" : "00000000-0000-0000-0000-00000000", "siteId" : "00000000-0000-0000-0000-00000000", "success" : [ { "deviceId" : "00000000-0000-0000-0000-00000000", "id" : "00000000-0000-0000-0000-00000000", "vlanId" : "100", "ipAddress" : "192.168.1.1", "macAddress" : "0000-0000-0000", "outInterfaceName" : "GigabitEthernet0/0/0", "arpType" : "system" } ], "fail" : [ { "errparams" : [ "siteId" ], "errcode" : "0", "errmsg" : "", "data" : { "deviceId" : "00000000-0000-0000-0000-00000000", "id" : "00000000-0000-0000-0000-00000000", "vlanId" : "100", "ipAddress" : "192.168.1.1", "macAddress" : "0000-0000-0000", "outInterfaceName" : "GigabitEthernet0/0/0", "arpType" : "system" } } ] } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

请求示例 HTTP的示例 POST /controller/campus/ui/v1/sdwan/lan/static-arps/action/batch-delete HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "vpnId" : "00000000-0000-0000-0000-00000000", "siteId" : "00000000-0000-0000-0000-00000000", "staticArp" : [ { "deviceId" : "00000000-0000-0000-0000-00000000", "id" : "00000000-0000-0000-0000-00000000", "vlanId" : "100", "ipAddress" : "192.168.1.1", "macAddress" : "0000-0000-0000", "outInterfaceName" : "GigabitEthernet0/0/0", "arpType" : "system" } ] }

请求示例 HTTP的示例 PUT /controller/campus/v1/networkservice/networkconfig/net/lswglobalvlan/devices/fbb684c8-0d37-496f-bafa-4b06d5151e2e/globalvlan HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "vlanId" : "10", "vlanName" : "vlan10", "vlanDesc" : "vlan10", "ipSubnetVlan" : ["10.100.100.100/24","10.101.100.100/24","10.102.100.100/24","10.103.100.100/24","10.104.100.100/24","10.105.100.100/24","10.106.100.100/24","10.107.100.100/24","10.108.100.100/24","10.109.100.100/24","10.110.100.100/24","10.111.100.100/24"], "unknownFlowDrop" : false, "arpSnoopingEnable" : false, "igmpSnoopingEnable" : false, "igmpSnoopingQuerierEnable" : false, "id" : "813a76d4-6eec-4264-ae45-a6f261482b60" }

响应示例 返回状态码为200：修改成功。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "data" : { "vlanId" : "10", "vlanName" : "vlan10", "vlanDesc" : "vlan10", "ipSubnetVlan" : ["10.100.100.100/24","10.101.100.100/24","10.102.100.100/24","10.103.100.100/24","10.104.100.100/24","10.105.100.100/24","10.106.100.100/24","10.107.100.100/24","10.108.100.100/24","10.109.100.100/24","10.110.100.100/24","10.111.100.100/24"], "unknownFlowDrop" : false, "arpSnoopingEnable" : false, "igmpSnoopingEnable" : false, "igmpSnoopingQuerierEnable" : false, "id" : "813a76d4-6eec-4264-ae45-a6f261482b60" } } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

URI /controller/campus/v1/networkservice/networkconfig/net/lswglobalvlan/devices/{deviceId}/globalvlan 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 deviceId 是 string - - 设备ID, UUID格式。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e"

响应示例 返回状态码为200：接口调用成功，响应体参考LoopbackResponse。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "success" : [ { "id" : "00000000-0000-0000-0000-000000000000", "vpnId" : "00000000-0000-0000-0000-000000000000", "wanLinkId" : "00000000-0000-0000-0000-000000000000", "siteId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "interfaceName" : "LoopBack601", "ipAddress" : "10.1.1.1", "prefixLength" : 24, "deviceName" : "device1" } ], "fail" : [ { "errcode" : "1", "errmsg" : "", "data" : { "id" : "00000000-0000-0000-0000-000000000000", "vpnId" : "00000000-0000-0000-0000-000000000000", "wanLinkId" : "00000000-0000-0000-0000-000000000000", "siteId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "interfaceName" : "LoopBack601", "ipAddress" : "10.1.1.1", "prefixLength" : 24, "deviceName" : "device1" } } ] } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

请求示例 HTTP的示例 PUT /controller/campus/v1/sdwan/net/loopbacks HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "Loopbacks" : [ { "id" : "00000000-0000-0000-0000-000000000000", "vpnId" : "00000000-0000-0000-0000-000000000000", "wanLinkId" : "00000000-0000-0000-0000-000000000000", "siteId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "interfaceName" : "LoopBack601", "ipAddress" : "10.1.1.1", "prefixLength" : 24, "deviceName" : "device1" } ] }

响应示例 返回状态码为200：批量增加用户结果返回体 HTTPS 200 OK Date: Thu,13 Jun 2024 10:00:00 GMT Server: example-server Content-Type: application/json { "errcode":"0", "errmsg":"", "data":{ "successList": [{"id": "0a638aed-d4b3-44ed-aaf1-f69dd9c4cfa8", "userName": "user01"}] } } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部错误 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

请求示例 HTTP的示例 POST /v1/accountservice/users/action/batch-create Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN:CA48D152F6B19D84:637C38259E6974E17788348128A430FEE150E874752CE754B6BF855281219925 { "userInfoList": [ { "userName": "user01", "userGroupId": "1a638aed-d4b3-44ed-aaf1-f69dd9c4cfa8", "name": "Jack", "email": "***@***", "telephone": "***********", "validPeriodLong": 1718587859000, "password": "******", "changePwdByNextLogin": true, "maxAccessNum": 16, "accessLimitStrategy": 0, "roleIds": ["2a638aed-d4b3-44ed-aaf1-f69dd9c4cfa8"], "allowLoginType": 7, "forcePkiAuth": false, "description": "for Jack" } ] }

响应参数 返回状态码为200：批量增加用户结果返回体 表4 BatchOperateUserResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~12个字符。 - 错误码 "0" errmsg string 0~256个字符。 - 错误详情 "" data REFERENCE 详细请参见表5。 批量操作结果 {"successList":[{"id":"0a638aed-d4b3-44ed-aaf1-f69dd9c4cfa8","userName":"user01"}]} 表5 BatchOperateResult对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 successList ARRAY_REFERENCE 0-100个列表项，详细请参见表6。 操作用户成功信息列表 [{"id":"0a638aed-d4b3-44ed-aaf1-f69dd9c4cfa8","userName":"user01"}] failList ARRAY_REFERENCE 0-100个列表项，详细请参见表6。 操作用户失败信息列表 [{"id":"0a638aed-d4b3-44ed-aaf1-f69dd9c4cfa8","userName":"user01"}] 表6 UserBriefInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string 0~36个字符。 - 用户标识 "0a638aed-d4b3-44ed-aaf1-f69dd9c4cfa8" userName string 1~256个字符。 - - "user01" 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误 详细信息请参见实际响应消息体。

URI /v1/networkconfig/wlan/site-templates/{siteTemplateId}/ap/vlanpools 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteTemplateId 是 string 36个字符。 - 站点模板ID。 "00000000-0000-0000-0000-000000000000" 表2 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 pageIndex 否 int32 [1-100] 1 第几页的数据。 1 pageSize 否 int32 [1-100] 20 一页多少条数据。 1 vlanPoolName 否 string 0~32个字符。 - VLAN POOL名称。 "pool1"

响应示例 返回状态码为200：查询AP VLAN POOL成功，响应体参考GetVlanPoolTemplateResponse。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "siteTemplateId" : "00000000-0000-0000-0000-000000000000", "data" : [ { "id" : "00000000-0000-0000-0000-000000000000", "name" : "template1", "range" : "2,4-10", "type" : "even" } ], "pageIndex" : 1, "pageSize" : 1, "totalRecords" : 1 } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部服务错误 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

请求示例 HTTP的示例 GET /v1/networkconfig/wlan/site-templates/00000000-0000-0000-0000-000000000000/ap/vlanpools?pageIndex=1&pageSize=1&vlanPoolName=pool1 HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy

请求示例 HTTP的示例 POST /controller/campus/v3/profile/escape HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "name" : "ESCAPETemplate1", "vlanId" : 1, "description" : "ESCAPETemplate1", "securityGroupId" : "4f350825-919c-47b7-b853-f51f15912396", "ipv4RuleList" : [ { "protocol" : "tcp", "dstIp" : "192.168.2.0/24", "dstPort" : "24", "description" : "Rule1" } ], "ipv6RuleList" : [{"protocol":"tcp","dstIp":"FC00::01/7","dstPort":"24","description":"Rule1"}] }

响应参数 返回状态码为201：成功创建的逃生模板信息。 表4 UpdateEscapeResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" data REFERENCE 详细请参见表5。 - - 表5 EscapeDtoData对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string - - 逃生模板ID，UUID格式。 "fbde1c5d-5b94-49e3-a912-48641015e45c" name string 1~32个字符。 - 逃生模板名称，包括汉字、字母、数字、下划线、.、@、-不能与已有的名称重复。 "ESCAPETemplate1" vlanId integer [1-4094] - 逃生模板vlanId，取值范围：1-4094。vlanId、securityGroupId、ipv4RuleList、ipv6RuleList不能同时为空。 1 description string 0~127个字符。 - 逃生模板描述。 "ESCAPETemplate1" securityGroupId string - - 逃生模板ID，UUID格式。vlanId、securityGroupId、ipv4RuleList、ipv6RuleList不能同时为空。 "4f350825-919c-47b7-b853-f51f15912396" ipv4RuleList ARRAY_REFERENCE 0-1024个列表项，详细请参见表6。 IPV4规则列表。vlanId、securityGroupId、ipv4RuleList、ipv6RuleList不能同时为空。 - ipv6RuleList ARRAY_REFERENCE 0-1024个列表项，详细请参见表6。 IPV6规则列表。vlanId、securityGroupId、ipv4RuleList、ipv6RuleList不能同时为空。 [{"protocol":"tcp","dstIp":"FC00::01/7","dstPort":"24","description":"Rule1"}] 表6 RuleList对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 protocol string udp tcp any icmp - 协议，取值范围：udp，tcp，any，icmp。当protocol为any或icmp时，dstPort必须为空。 "tcp" dstIp string - - 目的IP地址，可以输入Any，表示任意IP。比如： 192.168.2.0/24、FC00::01/7。 "192.168.2.0/24" dstPort string - - 目的端口号，或目的端口段，取值范围：整数（例如1000）或者整数段（1-100），且整数和整数段包含的值在0~65535。 "24" description string 0~127个字符。 - 规则描述。 "Rule1" 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。

响应示例 返回状态码为201：成功创建的逃生模板信息。 HTTP/1.1 201 Created Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "data" : { "id" : "fbde1c5d-5b94-49e3-a912-48641015e45c", "name" : "ESCAPETemplate1", "vlanId" : 1, "description" : "ESCAPETemplate1", "securityGroupId" : "4f350825-919c-47b7-b853-f51f15912396", "ipv4RuleList" : [ { "protocol" : "tcp", "dstIp" : "192.168.2.0/24", "dstPort" : "24", "description" : "Rule1" } ], "ipv6RuleList" : [{"protocol":"tcp","dstIp":"FC00::01/7","dstPort":"24","description":"Rule1"}] } } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 body 是 REFERENCE 详细请参见表2。 待创建的逃生模板信息。 - 表2 EscapeDtoDetail对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 name 是 string 1~32个字符。 - 逃生模板名称，包括汉字、字母、数字、下划线、.、@、-不能与已有的名称重复。 "ESCAPETemplate1" vlanId 否 integer [1-4094] - 逃生模板vlanId，取值范围：1-4094。vlanId、securityGroupId、ipv4RuleList、ipv6RuleList不能同时为空。 1 description 否 string 0~127个字符。 - 逃生模板描述。 "ESCAPETemplate1" securityGroupId 否 string - - 逃生模板ID，UUID格式。vlanId、securityGroupId、ipv4RuleList、ipv6RuleList不能同时为空。 "4f350825-919c-47b7-b853-f51f15912396" ipv4RuleList 否 ARRAY_REFERENCE 0-1024个列表项，详细请参见表3。 IPV4规则列表。vlanId、securityGroupId、ipv4RuleList、ipv6RuleList不能同时为空。 - ipv6RuleList 否 ARRAY_REFERENCE 0-1024个列表项，详细请参见表3。 IPV6规则列表。vlanId、securityGroupId、ipv4RuleList、ipv6RuleList不能同时为空。 [{"protocol":"tcp","dstIp":"FC00::01/7","dstPort":"24","description":"Rule1"}] 表3 RuleList对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 protocol 否 string udp tcp any icmp - 协议，取值范围：udp，tcp，any，icmp。当protocol为any或icmp时，dstPort必须为空。 "tcp" dstIp 否 string - - 目的IP地址，可以输入Any，表示任意IP。比如： 192.168.2.0/24、FC00::01/7。 "192.168.2.0/24" dstPort 否 string - - 目的端口号，或目的端口段，取值范围：整数（例如1000）或者整数段（1-100），且整数和整数段包含的值在0~65535。 "24" description 否 string 0~127个字符。 - 规则描述。 "Rule1"

请求示例 HTTP的示例 GET /restconf/v2/data/huawei-ac-nes-device:nes/ne/00000000-0000-0000-0000-000000000000/huawei-nce-e-ipv4:ipv4/Vbdif1 HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy restconf-transaction-id: "00000000-0000-0000-0000-000000000000"

响应示例 返回状态码为200：操作成功。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "huawei-nce-e-ipv4:ipv4" : [ { "config-status" : "configured-database-success", "last-committed-time" : "2022-01-01 00:00:00", "related-pkg-version" : "1.0.1", "edit-state" : "RUNNING", "if-name" : "Vbdif1", "address-type" : "address", "access-type" : "Static", "address" : "10.10.1.1", "mask" : 24, "unnumbered-if-name" : "LoopBack1", "mtu" : 1500, "sub-address" : [ { "address" : "10.10.1.2", "mask" : 24 } ] } ] } 返回状态码为400：请求参数错误。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

URI /restconf/v2/data/huawei-ac-nes-device:nes/ne/{id}/huawei-nce-e-ipv4:ipv4/{if-name} 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 id 是 string 36个字符。满足正则表达[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}。 - 设备ID。 "00000000-0000-0000-0000-000000000000" if-name 是 string 1~63个字符。 - 接口名称，AR6700V仅支持类型为Vbdif、LoopBack的接口，单一主键字段。 "Vbdif1"

请求示例 HTTP的示例 PATCH /restconf/v2/data/huawei-ac-nes-device:nes/ne/00000000-0000-0000-0000-000000000000/huawei-nce-e-dhcpv4:dhcpv4-if/GE0%2F0%2F2 HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy restconf-transaction-id: "00000000-0000-0000-0000-000000000000" { "huawei-nce-e-dhcpv4:dhcpv4-if" : { "if-name" : "GE0/0/2", "dhcp-type" : "server", "encapsulation" : { "suboption" : "circuit-id remote-id subscriber-id vendor-specific-id" }, "option82-formats" : { "option82-format" : [ { "sub-option-type" : "remote-id", "option82-format" : "user-defined", "user-define-text" : "definedtext" } ] }, "option82-insert-setting" : { "insert" : "", "rebuild" : "" }, "dhcp-relay" : { "enable" : true, "information" : true, "information-strategy" : "drop", "option82" : { "link-selection-enable" : false, "link-selection-address" : "10.1.1.4" }, "relay-source-address" : { "source-address" : "10.1.1.1" }, "server-addresses" : [ { "server-address" : "10.1.1.1" } ], "gateway-addresses" : [ { "gateway-address" : "10.1.1.1" } ] }, "dhcp-server" : { "gateway-list" : [ { "gateway-ip" : "10.1.1.1", "mask" : 16 } ], "dns-list" : [ { "dns-ip" : "10.1.1.1" } ], "excluded-ip-address" : [ { "start-ip-address" : "10.1.1.1", "end-ip-address" : "10.1.1.1" } ], "static-bind" : [ { "static-bind-ip" : "10.1.1.1", "static-bind-mac" : "xxxx-xxxx-xxxx" } ], "option" : [ { "option-code" : 56, "ip-addresses" : [ "10.1.1.1" ], "ascii-string" : "wevweq", "hex-string" : "4", "cipher-string" : "********", "sub-options" : { "sub-option" : [ { "sub-option-code" : 233, "ip-addresses" : [ "10.1.1.1" ], "ascii-string" : "asciistring" } ] } } ], "ip-range" : { "start-ip-address" : "10.1.1.1", "end-ip-address" : "10.1.1.1" }, "server-enable" : false, "domain-name" : "domainname", "masklen" : 24 } } }

响应示例 返回状态码为200：操作成功。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为400：请求参数错误。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

URI /restconf/v2/data/huawei-ac-nes-device:nes/ne/{id}/huawei-nce-e-dhcpv4:dhcpv4-if/{if-name} 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 id 是 string 36个字符。满足正则表达[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}。 - 设备ID。 "00000000-0000-0000-0000-000000000000" if-name 是 string 1~63个字符。 - interface name "GE0/0/2"

请求参数 表2 header参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 restconf-transaction-id 是 string - - 事务ID。 "00000000-0000-0000-0000-000000000000" 表3 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 huawei-nce-e-dhcpv4:dhcpv4-if 是 REFERENCE 详细请参见表4。 DHCPv4接口GND模型。 -

响应示例 返回状态码为200：操作成功。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "huawei-nce-e-l3-sub-interface:l3-sub-interface" : [ { "config-status" : "", "last-committed-time" : "", "related-pkg-version" : "", "edit-state" : "", "if-name" : "Vbdif20.20", "dot1q-vlans" : { "vlan-list" : "20" }, "vlan-type-dot1q" : { "vlan-type-vid" : 20 } } ] } 返回状态码为400：请求参数错误。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive