华为云用户手册

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

请求示例 HTTP的示例 PUT /controller/campus/v1/sdwan/net/site/timezone 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 { "siteTimeZones" : [ { "id" : "a99f794e-b510-438c-a75d-de59f02347eb", "timeZone" : "(UTC+08:00)Beijing,Chongqing,Hong Kong,Urumqi", "enableSummerConfig" : false, "enableAutoConfig" : true, "daylightSavingTime" : { "name" : "Atlantic/Canary", "offset" : "01:00", "enableWeekDay" : false, "startTime" : { "month" : "Jan", "time" : "23:59", "week" : "first", "weekday" : "Mon", "day" : 21 }, "stopTime" : { "month" : "Jan", "time" : "23:59", "week" : "first", "weekday" : "Mon", "day" : 21 } } } ] }

响应示例 返回状态码为201：设置站点时区成功，响应体参考SiteApiResponse。 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" : "", "success" : [ "a99f794e-b510-438c-a75d-de59f02347eb" ], "fail" : [ { "errcode" : "0", "errmsg" : "", "data" : "a99f794e-b510-438c-a75d-de59f02347eb" } ], "processInstanceId" : "" } 返回状态码为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

请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteTimeZones 是 REFERENCE 详细请参见表2。 修改时区信息列表。 - 表2 SiteTimeZones对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteTimeZones 否 ARRAY_REFERENCE 1-100个列表项，详细请参见表3。 - - 表3 SiteTimeZone对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 id 否 uuid - - 站点ID，格式为uuid。修改时必填。 "a99f794e-b510-438c-a75d-de59f02347eb" timeZone 否 string 0~255个字符。 - 时区信息。 "(UTC+08:00)Beijing,Chongqing,Hong Kong,Urumqi" enableSummerConfig 否 boolean true false - 是否开启夏令时。默认值为false。 false enableAutoConfig 否 boolean true false - 是否自动给设备下发夏令时时间，当enableAutoConfig为true时，daylightSavingTime必须为空，控制器会根据时区自动获取夏令时时间并下发给站点内的设备，否则daylightSavingTime必填。默认值为true。 true daylightSavingTime 否 REFERENCE 详细请参见表4。 - - 表4 DaylightSavingTime对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 name 是 string 1~32个字符。 - 时区名称。可配置为英文，数字，特殊字符，其中特殊字符包含：_-/。 "Atlantic/Canary" offset 是 string 1~5个字符。 - 相对零时区间隔，格式为HH:MM，取值范围00:01-02:00。 "01:00" enableWeekDay 是 boolean true false - 夏令时使能周期。当enableWeekDay为true时，startTime和stopTime中week和weekday必填；当enableWeekDay为false时，startTime和stopTime中day必填。默认值为false。 false startTime 是 REFERENCE 详细请参见表5。 夏令时开始时间。 {"month":"Jan","time":"05:00"} stopTime 是 REFERENCE 详细请参见表5。 夏令时结束时间。 {"month":"Jan","time":"05:00"} 表5 DaylightTime对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 month 是 string Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec - 指定月份，取值范围为Jan（一月），Feb（二月），Mar（三月），Apr（四月），May（五月），Jun（六月），Jul（七月），Aug（八月），Sep（九月），Oct（十月），Nov（十一月），Dec（十二月）。 "Jan" time 是 string 5个字符。 - 指定时间，24小时制时间，格式为HH:MM。 "23:59" week 否 string 0~64个字符。 - 指定周，取值范围为first（月份起始的第一周），second（月份起始的第二周），third（月份起始的第三周），fourth（月份起始的第四周），fifth（月份起始的第五周），last（月份起始的最后一周）。 "first" weekday 否 string Mon Tue Wed Thu Fri Sat Sun - 指定工作日，取值范围为Mon（周一），Tue（周二），Wed（周三），Thu（周四），Fri（周五），Sat（周六），Sun（周日）。 "Mon" day 否 int16 [1-31] - 指定天，取值范围是1-31，2月只到28号。 21

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

请求示例 HTTP的示例 PUT /restconf/v2/data/huawei-ac-nes-device:nes/ne/00000000-0000-0000-0000-000000000000/huawei-nce-e-dhcpv4:relay 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:relay" : { "config-status" : "configured-database-success", "last-committed-time" : "2022-01-01 00:00:00", "related-pkg-version" : "1.0.1", "edit-state" : "RUNNING", "global" : { "trust-option82" : true, "reply-forward-all" : true } } }

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

请求参数 表2 header参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 restconf-transaction-id 是 string - - 事务ID。 "00000000-0000-0000-0000-000000000000" 表3 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 huawei-nce-e-dhcpv4:relay 是 REFERENCE 详细请参见表4。 配置DHCP relay。 - 表4 relay-augment对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 huawei-nce-e-dhcpv4:relay 否 REFERENCE 详细请参见表5。 配置DHCP relay。 - 表5 relay对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 config-status 否 string reserved initial configuring-database configured-database-success configured-database-failed configuring-device configured-device-success configured-device-failed reserved 配置状态，对应保留未用状态、初始状态、数据库存储中状态、预配置状态、数据库存储失败状态、部署中状态、成功状态、失败状态；不支持编辑，仅查询返回。 "configured-database-success" last-committed-time 否 string 0~255个字符。 - 最后提交时间，该特性最后提交时间；不支持编辑，仅查询返回。 "2022-01-01 00:00:00" related-pkg-version 否 string 0~255个字符。 - 包版本，插件包版本；不支持编辑，仅查询返回。 "1.0.1" edit-state 否 string RUNNING CANDIDATE UNDEPLOYING UNDEPLOYED - 编辑状态，对应运行状态、候选状态、取消部署状态、未部署状态；不支持编辑，仅查询返回。 "RUNNING" global 否 REFERENCE 详细请参见表6。 中继全局配置。 - 表6 global对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 trust-option82 否 boolean true false true DHCP relay agent使能Option 82开关。AR6700V主设备和AR6700V子设备不支持。 true reply-forward-all 否 boolean true false false DHCP relay agent使能转发所有DHCP ACK消息。AR6700V主设备和AR6700V子设备不支持。 true

响应示例 返回状态码为200：删除成功，响应体参考CommonAaaResponse。 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

请求示例 HTTP的示例 DELETE /controller/campus/v1/sdwan/aaa/authorization/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

请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 createParam 是 REFERENCE 详细请参见表2。 待添加的终端组信息。 - 表2 TerminalMgrGroupDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 groupName 是 string 0~64个字符。 - 终端组名称，1~64个字符，不支持特殊字符。 "HUAWEI" parentId 否 string - - 父终端组ID，可以为空，为空在“自定义”下面，uuid格式。 "22fbb5f2-d07e-4710-94ac-7705517ab842" description 否 string 0~64个字符。 - 终端组描述，不支持特殊字符。 "product"

响应参数 返回状态码为201：创建成功信息。响应体参考TerminalGroupMgrResponseInfo。 表3 TerminalGroupMgrResponseInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" data REFERENCE 详细请参见表4。 - - 表4 TerminalGroupMgrResponseDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string - - 创建成功的终端组ID。 - groupName string 0~64个字符。 - 终端组名称，1~64个字符，不支持特殊字符。 "HUAWEI" parentId string - - 父终端组ID，可以为空，为空在“自定义”下面，uuid格式。 "22fbb5f2-d07e-4710-94ac-7705517ab842" description string 0~64个字符。 - 终端组描述，不支持特殊字符。 "product" 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。

请求示例 HTTP的示例 POST /controller/campus/v1/accountservice/terminalmgr/endpointgroup 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 { "groupName" : "HUAWEI", "parentId" : "22fbb5f2-d07e-4710-94ac-7705517ab842", "description" : "product" }

响应示例 返回状态码为201：创建成功信息。响应体参考TerminalGroupMgrResponseInfo。 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" : "", "groupName" : "HUAWEI", "parentId" : "22fbb5f2-d07e-4710-94ac-7705517ab842", "description" : "product" } } 返回状态码为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的示例 GET /restconf/v2/data/huawei-ac-nes-device:nes/ne/00000000-0000-0000-0000-000000000000/huawei-nce-e-dhcpv4:dhcpv4-global 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：操作成功。 表3 dhcpv4-global-info对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 huawei-nce-e-dhcpv4:dhcpv4-global REFERENCE 详细请参见表4。 全局DHCP配置。 - 表4 dhcpv4-global对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 config-status string reserved initial configuring-database configured-database-success configured-database-failed configuring-device configured-device-success configured-device-failed reserved 配置状态，对应保留未用状态、初始状态、数据库存储中状态、预配置状态、数据库存储失败状态、部署中状态、成功状态、失败状态；不支持编辑，仅查询返回。 "configured-database-success" last-committed-time string 0~255个字符。 - 最后提交时间，该特性最后提交时间；不支持编辑，仅查询返回。 "2023-05-11 00:00:00" related-pkg-version string 0~255个字符。 - 包版本，插件包版本；不支持编辑，仅查询返回。 "1.0.1" edit-state string RUNNING CANDIDATE UNDEPLOYING UNDEPLOYED - 编辑状态，对应运行状态、候选状态、取消部署状态、未部署状态；不支持编辑，仅查询返回。 "RUNNING" enable boolean true false false 使能全局DHCP。 false option82 REFERENCE 详细请参见表5。 配置DHCP option82特性。AR6700V主设备和AR6700V子设备不支持。 - 表5 option82对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 global-formats REFERENCE 详细请参见表6。 Option82全局格式列表。 - encapsulation REFERENCE 详细请参见表8。 配置DHCP Option82域子选项。 - 表6 global-formats对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 global-format ARRAY_REFERENCE 详细请参见表7。 配置DHCP Option82全局模式。 - 表7 global-formats-global-format对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 sub-option-type string circuit-id remote-id circuit-remote - DHCP option82全局子选项类型，单一主键字段。 "remote-id" option82-format string common extend user-defined default type1 type2 self-define default-extra cn-telecom self-define-extra intracom-vxlan cn-telecom-inherit - DHCP option82子选项格式类型。 "user-defined" user-defind-text string 0~255个字符。满足正则表达([^ ]{0,})。 - 用户定义DHCP Option82格式。关键词包含: sysname, portname, porttype, iftype, mac, slot, subslot, port, sVLAN, cVLAN,和length.可进行如下配置: '%portname:%sVLAN.%cVLAN %sysname/0/0/0/0/0' 或 0 %length %sVLAN %5slot %3subslot %8port 等等。请参考用户操作手册获取更多信息。 "77" 表8 encapsulation对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 suboption string - circuit-id remote-id subscriber-id vendor-specific-id 配置DHCP Option82域子选项。 "circuit-id remote-id subscriber-id vendor-specific-id" 返回状态码为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-dhcpv4:dhcpv4-global" : { "config-status" : "configured-database-success", "last-committed-time" : "2023-05-11 00:00:00", "related-pkg-version" : "1.0.1", "edit-state" : "RUNNING", "enable" : false, "option82" : { "global-formats" : { "global-format" : [ { "sub-option-type" : "remote-id", "option82-format" : "user-defined", "user-defind-text" : "77" } ] }, "encapsulation" : { "suboption" : "circuit-id remote-id subscriber-id vendor-specific-id" } } } } 返回状态码为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-global 表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"

请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 body 是 REFERENCE 详细请参见表2。 广域优化策略ID列表。 - 表2 DeleteWocPolicyInfos对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 effectImmediate 否 boolean true false true 是否立即生效，非必填，默认值true。 true wocPolicies 否 ARRAY_REFERENCE 0-100个列表项，详细请参见表3。 广域优化策略列表。 - 表3 DeleteWocPolicyInfo对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 id 否 string 1~64个字符。 - 策略ID，修改场景必填。 "00000000-0000-0000-0000-000000000000" name 否 string 0~64个字符。 - 策略名称。 "WocPolicy"

响应参数 返回状态码为200：删除成功，返回体参考WocPolicyResponse。 表4 DeleteWocPolicyResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~32个字符。 - 错误码。 "0" errmsg string 0~512个字符。 - 错误信息。 "" success ARRAY_REFERENCE 0-100个列表项，详细请参见表5。 成功的广域优化策略信息列表。 - fail ARRAY_REFERENCE 0-100个列表项，详细请参见表6。 失败的广域优化策略信息列表。 - 表5 DeleteWocPolicyInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string 1~64个字符。 - 策略ID，修改场景必填。 "00000000-0000-0000-0000-000000000000" name string 0~64个字符。 - 策略名称。 "WocPolicy" 表6 DeleteFailWocPolicyInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~32个字符。 - 错误码。 "0x00c8000c" errmsg string 0~512个字符。 - 错误信息。 "The parameter is invalid." data REFERENCE 详细请参见表5。 流量过滤策略信息。 - 返回状态码为400：请求参数错误，无响应体。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误，无响应体。 详细信息请参见实际响应消息体。

响应示例 返回状态码为200：删除成功，返回体参考WocPolicyResponse。 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", "name" : "WocPolicy" } ], "fail" : [ { "errcode" : "0x00c8000c", "errmsg" : "The parameter is invalid.", "data" : { "id" : "00000000-0000-0000-0000-000000000000", "name" : "WocPolicy" } } ] } 返回状态码为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

响应示例 返回状态码为201：创建成功，响应体参考DynamicQosPolicyResponse。 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" : "00000000-0000-0000-0000-000000000000", "name" : "qos1", "peerSites" : [ { "siteId" : "00000000-0000-0000-0000-000000000000", "siteName" : "templateName", "bandwidth" : 10 } ], "dynamicQosRules" : [ { "qosRuleId" : "00000000-0000-0000-0000-000000000000", "qosClassificationId" : "00000000-0000-0000-0000-000000000000", "qosClassificationName" : "qosClassificationName", "qosProfileId" : "00000000-0000-0000-0000-000000000000", "qosProfileName" : "templateName", "qosPriority" : 1 } ], "adaptiveQosEnable" : false, "adaptiveQosInfo" : { "period" : 10, "linkBandwidthLowerThreshold" : 1, "appBandwidthLowerThreshold" : 1, "packetLossThreshold" : 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的示例 POST /controller/campus/v1/sdwan/policy/traffic/woc/policies/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 { "effectImmediate" : true, "wocPolicies" : [ { "id" : "00000000-0000-0000-0000-000000000000", "name" : "WocPolicy" } ] }

请求示例 HTTP的示例 POST /controller/campus/v1/sdwan/policy/traffic/dynamic/qos/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 { "id" : "00000000-0000-0000-0000-000000000000", "name" : "qos1", "peerSites" : [ { "siteId" : "00000000-0000-0000-0000-000000000000", "siteName" : "templateName", "bandwidth" : 10 } ], "dynamicQosRules" : [ { "qosRuleId" : "00000000-0000-0000-0000-000000000000", "qosClassificationId" : "00000000-0000-0000-0000-000000000000", "qosClassificationName" : "qosClassificationName", "qosProfileId" : "00000000-0000-0000-0000-000000000000", "qosProfileName" : "templateName", "qosPriority" : 1 } ], "adaptiveQosEnable" : false, "adaptiveQosInfo" : { "period" : 10, "linkBandwidthLowerThreshold" : 1, "appBandwidthLowerThreshold" : 1, "packetLossThreshold" : 1 } }

请求示例 HTTP的示例 GET /controller/campus/v1/sdwan/policy/traffic/saas?pageIndex=1&pageSize=20&id=00000000-0000-0000-0000-000000000000&policyName=policy name 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：查询成功，响应体参考QueryPathSelectionPolicyResponse。 表2 QueryPathSelectionPolicyResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" totalRecords int32 - - 总的数据条数。 1 pageSize int32 - - 每页显示数量。 10 pageIndex int32 - - 当前页数。 1 data ARRAY_REFERENCE 详细请参见表9。 SaaS选路策略信息。 - 返回状态码为204：执行成功。 返回状态码为400：请求参数错误。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。

响应示例 返回状态码为200：查询成功，响应体参考QueryPathSelectionPolicyResponse。 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, "pageSize" : 10, "pageIndex" : 1, "data" : [ { "id" : "00000000-0000-0000-0000-000000000000", "policyName" : "PathSelectionPolicy", "description" : "description", "networkAssessmentInfo" : { "lossBaseLine" : 1, "lossFactor" : 50, "delayBaseLine" : 100, "delayFactor" : 50, "loadBalanceInfo" : { "balanceEnable" : true, "lossDiffer" : 10, "delayDiffer" : 50, "srcIpBalanceEnable" : false } }, "appDetectionUrlInfos" : [ { "detectionUrlId" : "3fa85f64-5717-4562-b3fc-2c963f66afa6", "appName" : "Google", "detectionUrl" : "https://www.huawei.com" } ], "detectionInfo" : { "type" : "HTTP", "frequency" : 300, "probeCount" : 10, "interval" : 5 } } ] } 返回状态码为204：执行成功。 HTTP/1.1 204 No Content 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 /controller/campus/v1/sdwan/policy/traffic/saas 表1 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 pageIndex 是 int32 [1-1000] 1 当前页数，默认是1。 1 pageSize 是 int32 [1-100] 20 每页显示数量，默认是20。 20 id 否 string 0~64个字符。 - 策略ID。 "00000000-0000-0000-0000-000000000000" policyName 否 string 0~64个字符。 - 策略名称，支持模糊匹配。 "policy name"

请求示例 HTTP的示例 PUT /controller/campus/v1/networkservice/networkconfig/net/fwnat/devices/fbb684c8-0d37-496f-bafa-4b06d5151e2e/fwnat 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" : "nat1", "description" : "", "conversionMode" : 3, "destinationMode" : "address-to-address", "sourceZones" : [ "00000000-0000-0000-0000-000000000001" ], "destinationZones" : [ "00000000-0000-0000-0000-000000000003" ], "oldSourceIp" : "10.2.0.6/24", "oldDestinationIp" : "10.1.1.10", "sourceConvert" : 1, "newSourceIpGroup" : [ "10.1.1.10" ], "newDestinationIpGroup" : [ "10.1.1.10" ], "destinationPort" : "80,82-98", "serviceList" : [ { "serviceType" : "tcp", "sourcePort" : "80", "destPort" : "80-97" } ], "id" : "de5813f8ff1e41f5ba9c324da70b49ed", "priority" : 5 }

响应示例 返回状态码为200：修改的防火墙设备NAT配置。 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" : "nat1", "description" : "", "conversionMode" : 3, "destinationMode" : "address-to-address", "sourceZones" : [ "00000000-0000-0000-0000-000000000001" ], "destinationZones" : [ "00000000-0000-0000-0000-000000000003" ], "oldSourceIp" : "10.2.0.6/24", "oldDestinationIp" : "10.1.1.10", "sourceConvert" : 1, "newSourceIpGroup" : [ "10.1.1.10" ], "newDestinationIpGroup" : [ "10.1.1.10" ], "destinationPort" : "80,82-98", "serviceList" : [ { "serviceType" : "tcp", "sourcePort" : "80", "destPort" : "80-97" } ], "id" : "de5813f8ff1e41f5ba9c324da70b49ed", "priority" : 5 } } 返回状态码为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