华为云用户手册

响应示例 返回状态码为200：查询成功，响应体参考DeviceDetailsResponse。 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" : [ { "deviceId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6", "deviceName" : "device1", "metricDatas" : [ { "name" : "***", "value" : [ { "timestamp" : "1985-04-12T23:20:50.52Z", "value" : 50 } ] } ] } ] } 返回状态码为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：查询成功，响应体参考DeviceDetailsResponse。 表2 DeviceDetailsResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~64个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "" data ARRAY_REFERENCE 0-100000000个列表项，详细请参见表3。 设备信息。 - 表3 DeviceInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 deviceId string 36个字符。 - 设备ID。 "fbb684c8-0d37-496f-bafa-4b06d515j7l6" deviceName string 0~128个字符。 - 设备名称。 "device1" metricDatas ARRAY_REFERENCE 0-100000000个列表项，详细请参见表4。 指标返回值，包括CPU、温度、内存、硬盘。 - 表4 MetricObject对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 name string - - 指标名称，具体名称对应根据metric而定。 "***" value ARRAY_REFERENCE 0-100000000个列表项，详细请参见表5。 - - 表5 MetricValue对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 timestamp string 满足正则表达\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[\+\-]\d{2}:\d{2})。 - UTC时间。 "1985-04-12T23:20:50.52Z" value double - - 返回值。指标CPU（cpu）对应设备CPU利用率数据，单位为百分比%；内存（memory）对应设备内存利用率数据，单位为百分比%；温度（temperature）对应设备温度数据，单位为摄氏度C；硬盘（harddisk）对应设备硬盘利用率数据，单位为百分比%；丢包（packetloss）对应链路（应用）的丢包率数据，单位是百分比%；时延（delay）对应链路（应用）的时延数据，单位是毫秒（ms）；抖动（jitter）对应应用的抖动数据，单位是毫秒（ms）；流量（netstream）对应链路（应用）的流量数据，单位是字节（Byte）。 50 返回状态码为400：校验异常 详细信息请参见实际响应消息体。 返回状态码为500：内部服务器错误。 详细信息请参见实际响应消息体。

URI /controller/campus/v1/sdwan/performance/site/device/list 表1 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteId 是 string 0~36个字符。 - 站点标识，UUID格式，可由网络侧提供接口获取。 "fbb684c8-0d37-496f-bafa-4b06d515j7l6" metric 是 string - - 查询指标，该字段可以设置为以下几种： a) cpu：CPU，单位是百分比（%）。 b) memory：内存，单位是百分比（%）。 c) temperature：温度，单位是摄氏度（℃）。 d) harddisk：硬盘，单位是百分比（%）。 如果查询多个指标用逗号分隔（如：cpu,memory）。 "cpu" startTime 是 string 满足正则表达\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})(Z|[\+\-]\d{2}:\d{2})。 - 查询的开始时间，UTC时间，直接调用URL，特殊符号参数需要手动转义，如"+"使用"%2B"代替。 "1985-04-12T23:20:50.052Z" endTime 是 string 满足正则表达\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})(Z|[\+\-]\d{2}:\d{2})。 - 查询的结束时间，UTC时间，直接调用URL，特殊符号参数需要手动转义，如"+"使用"%2B"代替。 "1985-04-12T23:20:50.052Z"

请求示例 HTTP的示例 GET /controller/campus/v1/sdwan/performance/site/device/list?siteId=fbb684c8-0d37-496f-bafa-4b06d515j7l6&metric=cpu&startTime=1985-04-12T23:20:50.052Z&endTime=1985-04-12T23:20:50.052Z 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

响应示例 返回状态码为200：查询成功，响应体参考QueryACLResponse。 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 { "data" : [ { "siteId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "aclNum" : 2100, "type" : "IPv4", "ruleList" : [ { "ruleId" : 10, "operateType" : 1, "ipRange" : "192.168.1.1/16" } ] } ], "pageIndex" : 1, "pageSize" : 10, "totalRecords" : 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 返回状态码为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 /controller/campus/v1/sdwan/acl/basic 表1 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 pageIndex 否 int32 [1-1000] 1 起始页，默认为1。 1 pageSize 否 int32 [1-1000] 10 页行记录数，默认为10。 10 siteId 否 uuid 0~36个字符。 - 站点ID，UUID格式。 "00000000-0000-0000-0000-000000000000" deviceId 否 uuid 0~36个字符。 - 设备ID，UUID格式。 "00000000-0000-0000-0000-000000000000" aclNum 否 int32 [2000-2999] - 基础ACL的ACL编号。 2100

响应参数 返回状态码为200：查询成功，响应体参考QueryACLResponse。 表2 QueryACLResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 data ARRAY_REFERENCE 0-2000个列表项，详细请参见表5。 ACL信息列表。 - pageIndex int32 [1-10000] - 当前页。 1 pageSize int32 [1-10000] - 页大小。 10 totalRecords int32 [1-100000] - 总记录数。 100 返回状态码为400：请求参数错误。 详细信息请参见实际响应消息体。 返回状态码为500：内部异常。 详细信息请参见实际响应消息体。

请求示例 HTTP的示例 GET /controller/campus/v1/sdwan/acl/basic?pageIndex=1&pageSize=10&siteId=00000000-0000-0000-0000-000000000000&deviceId=00000000-0000-0000-0000-000000000000&aclNum=2100 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

请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 device 是 REFERENCE 详细请参见表2。 待修改认证设备参数。 - 表2 DeviceApiDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 name 是 string 1~64个字符。 - 设备名称，1~64位的字符串，且不可包含特殊字符?!~@#$%^&*().。 "device" description 否 string 0~255个字符。 - 设备描述，0~255位字符，不能以=+-@作为开头。 "this is device" ip 是 string 1~128个字符。 - ipV4地址，enablePortal为false时支持掩码。 "10.254.254.254" backupIp 否 string 0~128个字符。 - 备份ip地址,交换机或WAC双链路部署时填写,enablePortal为false时支持掩码 "10.254.254.253" deviceGroupId 否 string 0~64个字符。 - 设备组标识。该字段和deviceGroupInfos不同时生效，如果deviceGroupInfos入参有信息优先生效deviceGroupInfos字段信息 "5c37d9e8-cdf6-11e8-a4fc-286ed488df6b" deviceGroupName 否 string 0~64个字符。 - 设备组名称。 "5c37d9e8-cdf6-11e8-a4fc-286ed488df6b" series 是 string Huawei Engine Cisco Catalyst H3C S Huawei NAC Cisco WLC Aruba OS Other Huawei USG Huawei ME60/NE40E Cisco Crystal Huawei V600 5GC - 设备系列，Crystal同Catalyst。选择5GC系列后，系列不支持修改，且不支持配置Portal和Tacacs。 "Cisco Catalyst" apn 否 string 0~64个字符。 - APN名称。 "APN-1" enableRadius 否 boolean true false false 是否已配置Radius对接参数。当enableRadius为true，radiusParam必填，为false时radiusParam无需填写。 true radiusParam 否 REFERENCE 详细请参见表3。 Radius参数信息 - enablePortal 否 boolean true false false 是否已配置Portal对接参数。当enablePortal为true，portalParam必填，为false时portalParam无需填写。 true portalParam 否 REFERENCE 详细请参见表4。 Potral参数信息 - enableTacacs 否 boolean true false false 是否已配置HWTACA CS 对接参数。当enableTacacs为true，tacacsParam必填，为false时tacacsParam无需填写。 true tacacsParam 否 REFERENCE 详细请参见表5。 TACACS参数信息 - deviceGroupInfos 否 ARRAY_REFERENCE 0-10个列表项，详细请参见表6。 多个设备组信息。该字段和deviceGroupId不同时生效，如果deviceGroupInfos入参有信息优先生效该字段信息 - id 是 string 1~64个字符。 - 认证设备ID，uuid格式。 "5c37d9e8-cdf6-11e8-a4fc-286ed488df6b"

响应示例 返回状态码为200：修改成功，响应体参考DeviceApiResponse。 HTTP/1.1 200 OK Date: Thu,01 Sep 2022 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" : "device", "description" : "this is device", "ip" : "10.254.254.254", "backupIp" : "10.254.254.253", "deviceGroupId" : "5c37d9e8-cdf6-11e8-a4fc-286ed488df6b", "series" : "Cisco Catalyst", "enableRadius" : true, "radiusParam" : { "accountingKey" : "******", "authenKey" : "******", "coaPort" : 1700, "accountingPeriod" : 5, "macPwdEnable" : false, "macAuthPwd" : "******", "radiusServiceTypeEnable" : false, "radiusServiceTypeDevice" : 8, "radiusServiceTypeTerminal" : 4 }, "enablePortal" : true, "portalParam" : { "protol" : "CMCC Portal", "portalKey" : "******", "urlKey" : "******", "stations" : ["10.254.254.254"], "enableUserSync" : false, "port" : 80, "portalServiceTypeEnable" : true, "portalServiceTypeTerminal" : 4 }, "enableTacacs" : true, "tacacsParam" : { "key" : "******" }, "id" : "5c37d9e8-cdf6-11e8-a4fc-286ed488df6b" } } 返回状态码为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/accesscfg/device/authdevice 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" : "device", "description" : "this is device", "ip" : "10.254.254.254", "backupIp" : "10.254.254.253", "deviceGroupId" : "5c37d9e8-cdf6-11e8-a4fc-286ed488df6b", "deviceGroupName" : "5c37d9e8-cdf6-11e8-a4fc-286ed488df6b", "series" : "Cisco Catalyst", "apn" : "APN-1", "enableRadius" : true, "radiusParam" : { "accountingKey" : "Example@123", "authenKey" : "Example@123", "coaPort" : 1700, "accountingPeriod" : 5, "macPwdEnable" : false, "macAuthPwd" : "Example@123", "radiusServiceTypeEnable" : false, "radiusServiceTypeDevice" : 8, "radiusServiceTypeTerminal" : 4 }, "enablePortal" : true, "portalParam" : { "protol" : "CMCC Portal", "portalKey" : "Example@123", "urlKey" : "Example@123", "stations" : ["10.254.254.254"], "enableUserSync" : false, "port" : 80, "portalServiceTypeEnable" : true, "portalServiceTypeTerminal" : 4, "portalIp" : "10.254.254.254", "httpProtocol" : "HTTPS" }, "enableTacacs" : true, "tacacsParam" : { "key" : "Example@123" }, "deviceGroupInfos" : [ { "devGroupId" : "5c37d9e8-cdf6-11e8-a4fc-286ed488df6b", "devGroupName" : "devGroupName1" } ], "id" : "5c37d9e8-cdf6-11e8-a4fc-286ed488df6b" }

请求示例 HTTP的示例 DELETE /restconf/v2/data/huawei-ac-nes-device:nes/ne/00000000-0000-0000-0000-000000000000/huawei-nce-e-route-policy:ext-community-filter 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 返回状态码为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-route-policy:ext-community-filter 表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"

响应示例 返回状态码为200：修改成功，返回配置后的端口配置信息，结构体参见ResponseDto。 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：校验异常，结构体参见ResponseDto。 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" : "" }

响应参数 返回状态码为200：修改成功，返回配置后的端口配置信息，结构体参见ResponseDto。 表4 ResponseDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~64个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "" 返回状态码为400：校验异常，结构体参见ResponseDto。 ResponseDto对象的参数列表，详细请参见表4。

URI /controller/campus/v1/networkservice/networkconfig/net/lswport/devices/{deviceId}/changeInterfaceMode 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 deviceId 是 uuid 36个字符。 - 设备ID。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e"

请求示例 HTTP的示例 PUT /controller/campus/v1/networkservice/networkconfig/net/lswport/devices/fbb684c8-0d37-496f-bafa-4b06d5151e2e/changeInterfaceMode 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 { "interfaceNames" : ["GigabitEthernet0/0/1","GigabitEthernet0/0/2"], "targetMode" : "100GE" }

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

请求示例 HTTP的示例 GET /controller/campus/v1/lanwan/tunnel/srpolicy 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：Success。 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, "progress" : 0.9, "data" : [ { "id" : "00000000-0000-0000-0000-000000000000", "name" : "TemplateBinding1", "templateId" : "00000000-0000-0000-0000-000000000000", "createTime" : "1713880927744", "description" : "this is TemplateBinding1", "totalDeviceNum" : 100, "deployedLastestSuccessDeviceCount" : 100, "templateBindingStatus" : "last-template-partly-deployed", "deployLastVersion" : true, "templateName" : "this is template1", "devices" : { "totalRecords" : 100, "data" : [ { "id" : "00000000-0000-0000-0000-000000000000", "name" : "device1", "ip" : "127.0.0.1", "siteName" : "site1", "deployStatus" : "deployment-successed", "deployTime" : "1713880927744", "deployLastVersion" : true, "deployErrorMsg" : {"errorCode":"0x00c8000c","errorType":"APPLICATION","message":"The request failed because the mandatory node is empty"} } ] } } ] } 返回状态码为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

请求示例 HTTP的示例 POST /v1/networkservice/hierarchy-template/template-groups/batch-delete/details 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" : 10, "templateName" : "template1", "bindingName" : "binding1", "deviceName" : "device1", "siteName" : "site1", "deleteTemplateGroupInput" : { "deleteIds" : ["00000000-0000-0000-0000-000000000000"] }, "id" : "00000000-0000-0000-0000-000000000000" }

响应参数 返回状态码为200：Success。 表4 TemplateGroupBindingResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 totalRecords int32 [0-20000] - 总记录数量。 100 progress double [0-1] - 部署进度。 0.9 data ARRAY_REFERENCE 0-20个列表项，详细请参见表5。 绑定关系列表。 - 表5 TemplateBinding对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string 36个字符。 - 绑定关系ID，UUID格式。 "00000000-0000-0000-0000-000000000000" name string 1~128个字符。 - 绑定名称。 "TemplateBinding1" templateId string 1~128个字符。 - 模板ID。 "00000000-0000-0000-0000-000000000000" createTime int64 [1577808000000-4733481600000] - 创建绑定时间。 "1713880927744" description string 0~1024个字符。 - 绑定描述。 "this is TemplateBinding1" totalDeviceNum int32 [0-200000] - 设备总数 100 deployedLastestSuccessDeviceCount int32 [0-200000] - 部署成功设备数量 100 templateBindingStatus string 0~32个字符。 - 部署状态。 last-template-partly-deployed：未全部部署， last-template-deployed：全部部署。 "last-template-partly-deployed" deployLastVersion boolean true false - 是否部署最新版本。 true templateName string 0~1024个字符。 - 模板名称。 "this is template1" devices REFERENCE 详细请参见表6。 设备列表。 - 表6 TemplateGroupBindingDevicesResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 totalRecords int32 [0-200000] - 总记录数量。 100 data ARRAY_REFERENCE 0-100个列表项，详细请参见表7。 绑定关系列表。 - 表7 TemplateBindingDevices对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string 36个字符。 - 设备ID，UUID格式。 "00000000-0000-0000-0000-000000000000" name string 1~128个字符。 - 设备名称。 "device1" ip string 0~20个字符。 - IP地址。 "127.0.0.1" siteName string 0~1024个字符。 - 站点名称。 "site1" deployStatus string 8~32个字符。 - 部署状态。 un-deploy：未部署， deploying：部署中， deployment-successed：部署成功， deployment-failed：部署失败， in-queue：队列中。 "deployment-successed" deployTime int64 [1577808000000-4733481600000] - 部署时间，时间戳格式。 "1713880927744" deployLastVersion boolean true false - 是否部署最新版本。 true deployErrorMsg string 0~10000个字符。 - 部署失败信息。 {"errorCode":"0x00c8000c","errorType":"APPLICATION","message":"The request failed because the mandatory node is empty"} 返回状态码为400：校验异常。 CommonDto对象的参数列表，详细请参见表4。 返回状态码为500：内部服务错误。 详细信息请参见实际响应消息体。

响应示例 返回状态码为200：查询成功，响应体参考QueryPredefinedUrlClassificationsResponse。 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" : "", "totalRecords" : 1, "data" : [ { "cid" : 1, "name" : "P2P", "description" : "P2P网站" } ] } 返回状态码为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/campus/v1/sdwan/policy/security/url-classifications 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：查询成功，响应体参考QueryPredefinedUrlClassificationsResponse。 表1 QueryPredefinedUrlClassificationsResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" totalRecords int32 - - 总的数据条数。 1 data ARRAY_REFERENCE 0-1000个列表项，详细请参见表2。 URL模板信息。 - 表2 PredefinedurlProfileInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 cid int32 - - URL预分类的大类ID。 1 name string 0~64个字符。 - URL类别名称。 "P2P" description string 0~128个字符。 - 描述。 "P2P网站" 返回状态码为400：请求参数错误。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。

请求示例 HTTP的示例 DELETE /controller/campus/v1/networkservice/networkconfig/net/lswport/devices/fbb684c8-0d37-496f-bafa-4b06d5151e2e/ethtrunk-ports/Eth-Trunk1 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

URI /controller/campus/v1/networkservice/networkconfig/net/lswport/devices/{deviceId}/ethtrunk-ports/{name} 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 deviceId 是 uuid - - 设备ID。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e" name 是 string 10~12个字符。 - EthTrunk端口名称，必须是Eth-Trunk[数字]的格式，数字最大511。 "Eth-Trunk1"

响应示例 返回状态码为200：删除交换机EthTrunk端口成功，结构体参见ResponseDto。 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" : "" }

响应示例 返回状态码为200：SSID全部删除成功，返回结构体参见APDeleteSsidResponse。 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" : [ "de5813f8ff1e41f5ba9c324da70b49ed" ], "fail" : [ { "errcode" : "0302000020", "errmsg" : "The site ID format is incorrect or the site does not exist", "id" : "de5813f8ff1e41f5ba9c324da70b49ed" } ] } 返回状态码为207：SSID部分删除成功，返回结构体参见APDeleteSsidResponse。 HTTP/1.1 207 Multi-Status 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" : [ "de5813f8ff1e41f5ba9c324da70b49ed" ], "fail" : [ { "errcode" : "0302000020", "errmsg" : "The site ID format is incorrect or the site does not exist", "id" : "de5813f8ff1e41f5ba9c324da70b49ed" } ] } 返回状态码为400：SSID删除失败，返回结构体参见APDeleteSsidResponse。 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" : "", "success" : [ "de5813f8ff1e41f5ba9c324da70b49ed" ], "fail" : [ { "errcode" : "0302000020", "errmsg" : "The site ID format is incorrect or the site does not exist", "id" : "de5813f8ff1e41f5ba9c324da70b49ed" } ] } 返回状态码为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