华为云用户手册

请求参数 表2 header参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 restconf-transaction-id 是 string - - 事务ID。 "00000000-0000-0000-0000-000000000000" 表3 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 huawei-nce-e-syslog:syslog-config 是 REFERENCE 详细请参见表4。 syslog配置 - 表4 syslog-config-exclude-patch-false-augment对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 huawei-nce-e-syslog:syslog-config 否 REFERENCE 详细请参见表5。 syslog配置 - 表5 syslog-config-patch-false对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 global-parameter 否 REFERENCE 详细请参见表6。 全局配置 - server 否 ARRAY_REFERENCE 0-8个列表项，详细请参见表7。 服务 - info-center-source 否 ARRAY_REFERENCE 0-1000个列表项，详细请参见表8。 信息通道 - 表6 global-parameter-patch-false对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 interface-name 否 string 1~63个字符。 - 接口名称，1-63字符，需要和设备上的接口名称保持一致。 "1" buffer-size 否 int32 [0-10240] - 日志条数， "合法范围1..10240，其中V200交换机合法范围0..1024" 1 log-timestamp 否 string date-boot date-second date-tenthsecond date-millisecond shortdate-second shortdate-tenthsecond shortdate-millisecond formatdate-second formatdate-tenthsecond formatdate-millisecond - 日志时间类型-boot型，date型，short-date型，format-date型 "date-boot" log-timezone 否 boolean true false - 日志时区 true debug-timestamp 否 string date-boot date-second date-tenthsecond date-millisecond shortdate-second shortdate-tenthsecond shortdate-millisecond formatdate-second formatdate-tenthsecond formatdate-millisecond - debug时间类型-boot型，date型，short-date型，format-date型 "date-boot" debug-timezone 否 boolean true false - debug时区 true trap-timestamp 否 string date-boot date-second date-tenthsecond date-millisecond shortdate-second shortdate-tenthsecond shortdate-millisecond formatdate-second formatdate-tenthsecond formatdate-millisecond - trap时间类型-boot型，date型，short-date型，format-date型 "date-boot" trap-timezone 否 boolean true false - trap时区 true statistic-suppress 否 boolean true false - 连续重复日志的统计抑制功能 true 表7 syslog-config-server-patch-false对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 ipaddress 否 string - - IP地址 "E2:1:1:1:1:1:1:1" vrf-name 否 string 1~31个字符。 - VPN名称，默认为__public__ "_public_" port 否 int64 [1-65535] - 端口 453 transport-mode 否 string udp tcp - 传输模式 "tcp" channel-id 否 int64 [0-9] - 通道ID 5 facility 否 string local0 local1 local2 local3 local4 local5 local6 local7 - 设施，枚举值，默认为local7 "local7" ssl-policy-name 否 string 1~23个字符。满足正则表达[a-z0-9_]*。 - ssl策略名称 "default" 表8 syslog-config-info-center-source-patch-false对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 module-name 否 string 1~31个字符。满足正则表达[^A-Z]*。 - 模块名称."1-31位小写字母或数字，如a-z或0-9，例如：default,其他特性在设备产品文档"日志参考"中可以查到设备当前支持的所有模块名称，如aaa、am，具体以设备产品文档为准。" "default" channel-id 否 int64 [0-9] - 通道ID 5 enable-log 否 boolean true false - 使能日志 - enable-log-level 否 string emergencies alert critical error warning notification informational debugging - 使能日志级别 - enable-trap 否 boolean true false - 使能Trap - enable-trap-level 否 string emergencies alert critical error warning notification informational debugging - 使能Trap级别 -

URI /restconf/v2/data/huawei-ac-nes-device:nes/ne/{id}/huawei-nce-e-syslog:syslog-config 表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"

URI /controller/campus/v1/networkservice/networkconfig/net/cli/sites/{siteId}/type/{deviceType}/cli/batch-delete 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteId 是 string - - 站点ID, UUID格式。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e" deviceType 是 string - - 设备类型，取值范围：AP、LSW、FW、AR。 "AP"

请求示例 HTTP的示例 POST /controller/campus/v1/networkservice/networkconfig/net/cli/sites/fbb684c8-0d37-496f-bafa-4b06d5151e2e/type/AP/cli/batch-delete 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 { "ids" : [ "fbb684c80d37496fbafa4b06db151e2a" ] }

响应示例 返回状态码为200：成功删除CLI配置信息，返回结构体参见DeleteCLIResponseDto。 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" : [ "fbb684c80d37496fbafa4b06db151e2a" ] } 返回状态码为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/v1/networkservice/networkconfig/site-template-binding-relationship/fbde1c5d-5b94-49e3-a912-48641015e451 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 { "siteIds" : [ "4f350825-919c-47b7-b853-f51f15912396" ] }

URI /controller/campus/v1/networkservice/networkconfig/site-template-binding-relationship/{siteTemplateId} 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteTemplateId 是 string 36个字符。 - 站点模板ID，UUID格式。 "fbde1c5d-5b94-49e3-a912-48641015e451"

响应示例 返回状态码为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" : "", "success" : [ "4f350825-919c-47b7-b853-f51f15912396" ], "fail" : [ { "errcode" : "0x00c80035", "errmsg" : "Invalid parameter.", "data" : "4f350825-919c-47b7-b853-f51f15912396" } ] } 返回状态码为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的示例 DELETE /controller/campus/v1/networkservice/networkconfig/net/localuser/sites/fbb684c8-0d37-496f-bafa-4b06d5151e2e/users/test 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

响应示例 返回状态码为200：修改成功，返回信息，结构体参见deleteLocalUserInfoResponse。 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" : "" }

URI /controller/campus/v1/networkservice/networkconfig/net/localuser/sites/{siteId}/users/{username} 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteId 是 string - - 站点ID, UUID格式。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e" username 是 string 0~64个字符。 - 本地用户名，在URL中拼接用户名时，要对特殊字符转义。 "test"

响应参数 返回状态码为200：操作成功。 表3 l3-sub-interface-list对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 huawei-nce-e-l3-sub-interface:l3-sub-interface ARRAY_REFERENCE 详细请参见表4。 l3 sub interface parameters - 表4 nes-ne-l3-sub-interface对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 config-status string reserved initial configuring-database configured-database-success configured-database-failed configuring-device configured-device-success configured-device-failed reserved - - last-committed-time string 0~255个字符。 - 最后提交时间，该特性最后提交时间；不支持编辑，仅查询返回。 - related-pkg-version string 0~255个字符。 - 包版本，插件包版本；不支持编辑，仅查询返回。 - edit-state string RUNNING CANDIDATE UNDEPLOYING UNDEPLOYED - 编辑状态，对应运行状态、候选状态、取消部署状态、未部署状态；不支持编辑，仅查询返回。 - if-name string 1~63个字符。 - Interface name "Vbdif20.20" dot1q-vlans REFERENCE 详细请参见表5。 Configure dot1q termination. - vlan-type-dot1q REFERENCE 详细请参见表6。 Configure VLAN-type dot1q. - 表5 dot1q-vlans对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 vlan-list string 满足正则表达((409[0-4]|40[0-8][0-9]|[1-3][0-9]{3}|[1-9][0-9]{1,2}|[1-9])?(-(409[0-4]|40[0-8][0-9]|[1-3][0-9]{3}|[1-9][0-9]{1,2}|[1-9]))?(,((409[0-4]|40[0-8][0-9]|[1-3][0-9]{3}|[1-9][0-9]{1,2}|[1-9])(-(409[0-4]|40[0-8][0-9]|[1-3][0-9]{3}|[1-9][0-9]{1,2}|[1-9]))?))*)|((([\\+|\\-](409[0-4]|40[0-8][0-9]|[1-3][0-9]{3}|[1-9][0-9]{1,2}|[1-9]))|([\\+|\\-]\\((409[0-4]|40[0-8][0-9]|[1-3][0-9]{3}|[1-9][0-9]{1,2}|[1-9])-(409[0-4]|40[0-8][0-9]|[1-3][0-9]{3}|[1-9][0-9]{1,2}|[1-9])\\)))?(,(([\\+|\\-](409[0-4]|40[0-8][0-9]|[1-3][0-9]{3}|[1-9][0-9]{1,2}|[1-9]))|([\\+|\\-]\\((409[0-4]|40[0-8][0-9]|[1-3][0-9]{3}|[1-9][0-9]{1,2}|[1-9])-(409[0-4]|40[0-8][0-9]|[1-3][0-9]{3}|[1-9][0-9]{1,2}|[1-9])\\))))*)。 - Dot1q termination VLAN ID list. The VLAN in VLAN-list can not exist in the VLAN-list of dot1q-VLANs-group. "20" 表6 vlan-type-dot1q对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 vlan-type-vid int32 [1-4094] - VLAN ID of the VLAN sub-interface; 20 返回状态码为400：请求参数错误。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。

响应示例 返回状态码为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

URI /restconf/v2/data/huawei-ac-nes-device:nes/ne/{id}/huawei-nce-e-l3-sub-interface:l3-sub-interface 表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"

请求示例 HTTP的示例 GET /restconf/v2/data/huawei-ac-nes-device:nes/ne/00000000-0000-0000-0000-000000000000/huawei-nce-e-l3-sub-interface:l3-sub-interface 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"

请求示例 HTTP的示例 PUT /controller/campus/v1/sdwan/policy/traffic/traffic-filter-policies 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 { "effectImmediate" : true, "trafficFilterPolicies" : [ { "id" : "00000000-0000-0000-0000-000000000000", "vpnId" : "00000000-0000-0000-0000-000000000000", "vpnName" : "vpnName", "name" : "app", "classificationProfileId" : "00000000-0000-0000-0000-000000000000", "classificationProfileName" : "classificationProfileName", "effectiveTimeId" : "00000000-0000-0000-0000-000000000000", "effectiveTimeName" : "effectiveTimeName", "priority" : 1, "direction" : "inbound", "action" : "permit", "status" : 1, "isActive" : true, "bindMode" : "siteMode", "templateMode" : "classifier" } ] }

响应示例 返回状态码为200：修改成功，响应体参考TrafficFilterPolicyResponse。 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", "vpnName" : "vpnName", "name" : "app", "classificationProfileId" : "00000000-0000-0000-0000-000000000000", "classificationProfileName" : "classificationProfileName", "effectiveTimeId" : "00000000-0000-0000-0000-000000000000", "effectiveTimeName" : "effectiveTimeName", "priority" : 1, "direction" : "inbound", "action" : "permit", "status" : 1, "isActive" : true, "bindMode" : "siteMode", "templateMode" : "classifier" } ], "fail" : [ { "errcode" : "0x00c8000c", "errmsg" : "The parameter is invalid.", "data" : { "id" : "00000000-0000-0000-0000-000000000000", "vpnId" : "00000000-0000-0000-0000-000000000000", "vpnName" : "vpnName", "name" : "app", "classificationProfileId" : "00000000-0000-0000-0000-000000000000", "classificationProfileName" : "classificationProfileName", "effectiveTimeId" : "00000000-0000-0000-0000-000000000000", "effectiveTimeName" : "effectiveTimeName", "priority" : 1, "direction" : "inbound", "action" : "permit", "status" : 1, "isActive" : true, "bindMode" : "siteMode", "templateMode" : "classifier" } } ] } 返回状态码为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/networkservice/hierarchy-template/template-groups/00000000-0000-0000-0000-000000000000/unbound-sites 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 { "pageIndex" : 1, "pageSize" : 20, "deviceTypes" : ["LSW","AP"], "orgIds" : ["00000000-0000-0000-0000-000000000000"], "keyWord" : "site1" }

响应示例 返回状态码为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 { "totalRecords" : 100, "data" : [ { "id" : "00000000-0000-0000-0000-000000000000", "name" : "site1", "organizationName" : "organization1", "totalDeviceNum" : "", "deviceGroupTypes" : ["AP","LSW"], "totalTemplateGroupNum" : 100 } ] } 返回状态码为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 { "errcode" : "0", "errmsg" : "" } 返回状态码为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：修改子网成功。 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" : { "name" : "subnet1", "vlanId" : 100, "ipv4poolOrNot" : 0, "ipAddress" : "192.168.12.12", "maskAddress" : 24, "subIpList" : [ { "subIpAddress" : "192.168.13.13", "subMaskAddress" : 24 } ], "arpEnable" : false, "mtu" : 1500, "dhcpEnable" : true, "icmpRedirectSendEnable" : true, "dhcpConfig" : { "dhcpMode" : "server", "relayServerIps" : [ "10.122.12.1" ], "dhcpServerConfig" : { "dnsConfig" : { "dnsServerMode" : "custom", "priorDnsServer" : "10.15.15.15", "standbyDnsServer" : "10.15.15.16" }, "domainSuffix" : "com", "manegeNetworkEnable" : true, "exceptFitAp" : "CloudAP", "option148" : false, "acAddressType" : "IP", "option43" : false, "wacAddress" : [ "10.122.12.1" ], "dhcpServerLogging" : false, "dhcpServerOptions" : [ { "code" : 26, "subCode" : 5, "optionType" : "hex", "optionValue" : "2e" } ], "leasesConfig" : { "unlimit" : false, "day" : 1, "hour" : 0, "minute" : 0 }, "excludedAddresses" : [ { "startIpAddress" : "192.168.12.13", "endIpAddress" : "192.168.12.13" } ], "fixIpEnable" : false, "fixedIpRange" : [ { "startIpAddress" : "192.168.12.13", "endIpAddress" : "192.168.12.13" } ], "staticBindings" : [ { "staticIpAddress" : "192.168.12.14", "staticMacAddress" : "XX:XX:XX:XX:XX:XX" } ] } }, "id" : "30a51c112787470f81045d60ccf3995f" } } 返回状态码为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

请求示例 HTTP的示例 PUT /controller/campus/v1/networkservice/networkconfig/net/lswsubnet/devices/fbb684c8-0d37-496f-bafa-4b06d5151e2e/subnet 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" : "subnet1", "vlanId" : 100, "ipv4poolOrNot" : 0, "ipAddress" : "192.168.12.12", "maskAddress" : 24, "subIpList" : [ { "subIpAddress" : "192.168.13.13", "subMaskAddress" : 24 } ], "arpEnable" : false, "mtu" : 1500, "dhcpEnable" : true, "icmpRedirectSendEnable" : true, "dhcpConfig" : { "dhcpMode" : "server", "relayServerIps" : [ "10.122.12.1" ], "dhcpServerConfig" : { "dnsConfig" : { "dnsServerMode" : "custom", "priorDnsServer" : "10.15.15.15", "standbyDnsServer" : "10.15.15.16" }, "domainSuffix" : "com", "manegeNetworkEnable" : true, "exceptFitAp" : "CloudAP", "option148" : false, "acAddressType" : "IP", "option43" : false, "wacAddress" : [ "10.122.12.1" ], "dhcpServerLogging" : false, "dhcpServerOptions" : [ { "code" : 26, "subCode" : 5, "optionType" : "hex", "optionValue" : "2e" } ], "leasesConfig" : { "unlimit" : false, "day" : 1, "hour" : 0, "minute" : 0 }, "excludedAddresses" : [ { "startIpAddress" : "192.168.12.13", "endIpAddress" : "192.168.12.13" } ], "fixIpEnable" : false, "fixedIpRange" : [ { "startIpAddress" : "192.168.12.13", "endIpAddress" : "192.168.12.13" } ], "staticBindings" : [ { "staticIpAddress" : "192.168.12.14", "staticMacAddress" : "XX:XX:XX:XX:XX:XX" } ] } }, "id" : "30a51c112787470f81045d60ccf3995f" }

请求参数 表2 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 body 是 REFERENCE 详细请参见表3。 子网配置的参数体。 - 表3 SubnetDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 name 否 string 1~32个字符。 - 子网名称。1-32位英文字母、数字或特殊符号（特殊符号不包括问号“?” 和空格“ ”）。在同一交换机上，子网的name不能相同。 "subnet1" vlanId 否 integer [1-4094] - VLAN ID。1-4094之间的整数，建议VLAN ID不要配置和管理VLAN 相同，否则可能会导致设备脱管。在同一交换机上，子网的vlanId不能相同。vlanId不支持修改。 100 ipv4poolOrNot 否 integer [0-0] - IP获取方式。0：手动。 0 ipAddress 否 string 0~15个字符。 - 子网IP地址。必须是合法的单播IPV4地址，不允许是子网网段或0.0.0.0。当ipv4poolOrNot为0时，ipAddress必填。在同一交换机上，子网网段不能重叠。 "192.168.12.12" maskAddress 否 integer [1-30] - 子网掩码。当dhcpConfig.dhcpMode为server时，maskAddress要大于15。当ipv4poolOrNot为0时，maskAddress必填。 24 subIpList 否 ARRAY_REFERENCE 0-31个列表项，详细请参见表4。 子项IP列表，不能重复。 - arpEnable 否 boolean true false false ARP代理开关使能。 false mtu 否 integer [128-9216] 1500 MTU（接口的最大传输单元），取值为128-9216之间的整数。 1500 dhcpEnable 否 boolean true false true DHCP开关使能，当dhcpEnable为true时，dhcpConfig必填。 true icmpRedirectSendEnable 否 boolean true false true ICMP报文转发使能，默认为true。 true dhcpConfig 否 REFERENCE 详细请参见表5。 - - id 是 string 32个字符。 - 子网ID。 "30a51c112787470f81045d60ccf3995f"

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

组网需求 在一些大型的分支连锁或者分支办公场景中，分支的网络不仅需要访问Internet，还需要访问总部或者数据中心；同时，分支的网络有可能通过专线或者VPN接入到总部网。分支需要访问总部/数据中心的业务，分支和总部/数据中心部署单链路或者多链路上行互联。需要智能选路，根据业务、应用选择链路质量优的链路优先发送，同时需要支持链路的自动切换和回切。分支之间不需要互访。 基于上述诉求，可采用SD-WAN的Hub-Spoke组网方案完成网络部署和运维。如果客户没有IT人员，可以选择由MSP进行代建和代维。如果客户有IT人员，可以选择由租户进行自建和自维。 该企业网络架构如图1所示。 图1 企业网络架构图 分支通过多条上行链路出口和多总部/数据中心互联。 总部、分支等所有站点都必须部署支持SD-WAN功能的AR设备。 分支支持单机部署，也可以双机部署；双机部署时每台设备至少连接一条上行链路。 父主题： 仅SD-WAN组网（Hub-Spoke组网）

请求示例 HTTP的示例 PUT /controller/campus/v2/banner/banner/be6e6d19-815a-4959-93ea-0e369ce3be0f/sites 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 { "usedSiteIds" : [ "" ], "unusedSiteIds" : [ "" ] }

响应示例 返回状态码为200：接口调用成功，响应体参考CommonResponse。 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：Invalid tag value 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

响应示例 返回状态码为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" : "", "networkResources" : [ { "hostUnitType" : "director", "number" : 24, "allocNumber" : 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

请求示例 HTTP的示例 GET /controller/sdwan/v1/naas/device/resource?deviceId=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-ACCESS-TOKEN: x-yyyyyy

响应参数 返回状态码为200：查询成功返回。 表2 NaasNetworkDeviceResourceResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 状态码，0：请求成功。 "0" errmsg string - - 接口调用的错误信息。 "" networkResources ARRAY_REFERENCE 详细请参见表3。 服务链资源组。 - 表3 NetworkResourceInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 hostUnitType string 1~32个字符。 - 取值为director或者forwarder，且director与forwarder必须同时填写。 "director" number int32 [1-150] - 资源数量。 24 allocNumber int32 [0-256] - 资源已分配数量。 24 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。

响应示例 返回状态码为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" : "" } 返回状态码为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