华为云用户手册

请求示例 HTTP的示例 GET /restconf/v2/data/huawei-ac-nes-device:nes/ne/00000000-0000-0000-0000-000000000000/huawei-nce-e-nat-policy:nat-policy-rules 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 restconf-transaction-id: "00000000-0000-0000-0000-000000000000"

URI /restconf/v2/data/huawei-ac-nes-device:nes/ne/{id}/huawei-nce-e-nat-policy:nat-policy-rules 表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：操作成功。 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-nat-policy:nat-policy-rules" : [ { "config-status" : "configured-database-success", "last-committed-time" : "2022-01-01 00:00:00", "related-pkg-version" : "1.0.1", "edit-state" : "RUNNING", "name" : "rules@name", "action" : { "source-nat" : { "address-group-name" : "addressgroupname" } }, "source-zone" : [ "sourcezone" ], "destination-zone" : [ "destinationzonename" ], "egress-interface" : [ "egressinterfacename" ], "source-nat" : { "address-group-name" : "addressgroupname", "easy-ip" : "True" }, "source-address" : { "address-ipv4s" : { "address-ipv4" : [ { "ipv4" : "10.1.1.1", "mask" : "255.255.0.0" } ] }, "address-ipv4-ranges" : { "address-ipv4-range" : [ { "start-ipv4" : "10.1.1.1", "end-ipv4" : "10.1.1.1" } ] } }, "destination-address" : { "address-ipv4s" : { "address-ipv4" : [ { "ipv4" : "10.1.1.1", "mask" : "255.255.0.0" } ] }, "address-ipv4-ranges" : { "address-ipv4-range" : [ { "start-ipv4" : "10.1.1.1", "end-ipv4" : "10.1.1.1" } ] } }, "service" : { "service-items" : { "protocol-and-ports" : { "protocol-and-port" : [ { "protocol" : "tcp", "source-port" : "65501", "dest-port" : "65502" } ] }, "protocol" : { "protocol-id" : [ 199 ] } } } } ] } 返回状态码为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/oamservice/device/queryControllerPort/af348227-0b07-4468-900c-d1b1637a8e97 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：查询成功，响应体参考QueryControllerPort。 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" : "ea25fdbf-8dee-4823-bac2-5bfe8e3359ca", "devInterface" : "GigabitEthernet0/0/2", "ip" : "10.1.1.1" } ] }

响应参数 返回状态码为200：查询成功，响应体参考QueryControllerPort。 表2 QueryControllerPort对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~256个字符。 - 错误码，0表示成功，非0表示失败。 "0" errmsg string 0~256个字符。 - 错误信息。 - data ARRAY_REFERENCE 0-2147483647个列表项，详细请参见表3。 连接端口信息。 - 表3 ControllerPortDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 deviceId string - - 设备标识，UUID格式。 "ea25fdbf-8dee-4823-bac2-5bfe8e3359ca" devInterface string - - 控制器连接端口。 "GigabitEthernet0/0/2" ip string - - 端口IP。 "10.1.1.1"

响应示例 返回状态码为200：查询成功，响应体参考SprEventResponse。 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" : "", "pageIndex" : 1, "pageSize" : 1000, "totalRecords" : 1000, "data" : [ { "srcSiteId" : "00000000-0000-0000-0000-000000000000", "srcSiteName" : "site1", "destsiteName" : "site2", "deviceName" : "device1", "vpnName" : "vpn1", "sprName" : "spr1", "sprSchedule" : "LB", "reason" : "Loss Change", "time" : 1616828400000, "lastLink" : { "linkName" : "tnp1", "destSiteName" : "tnp1", "destDeviceName" : "tnp1", "destLinkName" : "tnp1", "delay" : 10, "jitter" : 10, "pkgLoss" : 0.4, "bandwidthUsage" : 80.0, "appBandwidthUsage" : 70.0 }, "currentLink" : { "linkName" : "tnp1", "destSiteName" : "tnp1", "destDeviceName" : "tnp1", "destLinkName" : "tnp1", "delay" : 10, "jitter" : 10, "pkgLoss" : 0.4, "bandwidthUsage" : 80.0, "appBandwidthUsage" : 70.0 }, "platform" : "pnf", "linkStatus" : 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

响应参数 返回状态码为200：查询成功，响应体参考SprEventResponse。 表3 SprEventResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~64个字符。 - 错误码，成功返回0 "0" errmsg string 0~256个字符。 - 错误信息 "" pageIndex int32 - - 总记录数 1 pageSize int32 - - 页大小 1000 totalRecords int64 - - 总记录数 1000 data ARRAY_REFERENCE 0-1000个列表项，详细请参见表4。 数据项 - 表4 SprEvent对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 srcSiteId string - - 源站点ID。 "00000000-0000-0000-0000-000000000000" srcSiteName string - - 源站点名称。 "site1" destsiteName string - - 切换前对端站点名称。 "site2" deviceName string - - 源设备名称。 "device1" vpnName string - - VPN名称。 "vpn1" sprName string - - SPR策略名称。 "spr1" sprSchedule string - - SPR策略模式：LB（负载均衡）、PF（优先占用）。 "LB" reason string - - 切换原因。 "Loss Change" time int64 - - 切换时间，格林威治时间戳，格式为UNIX时间戳，即从1970年1月1日（UTC/GMT的午夜）开始所经过的毫秒数，不考虑闰秒。 1616828400000 lastLink REFERENCE 详细请参见表5。 切换前链路信息。 - currentLink REFERENCE 详细请参见表5。 切换后链路信息。 - platform string - - 是否是V600版本的设备标识。pnf表示是V600版本的设备。 "pnf" linkStatus int32 [0-2] - sprSchedule为LB时，该字段生效。有以下几种情况： a) 0: 表示不涉及。 b) 1: 表示加入。 c) 2: 表示退出。 1 表5 SprEventLinkInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 linkName string - - 本端链路名称。 "tnp1" destSiteName string - - 对端站点名称。 "tnp1" destDeviceName string - - 对端设备名称。 "tnp1" destLinkName string - - 对端链路名称。 "tnp1" delay int32 - - 时延。 10 jitter int32 - - 抖动。 10 pkgLoss double - - 丢包率。 0.4 bandwidthUsage double - - 带宽利用率，V600版本的设备不支持带宽利用率上报。 80.0 appBandwidthUsage double - - 应用带宽利用率，V600版本的设备不支持应用带宽利用率上报。 70.0 返回状态码为400：请求参数错误。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。

请求示例 HTTP的示例 POST /controller/campus/v1/sdwan/performance/spr-statistics/query-spr-events 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" : 1000, "srcSiteId" : "00000000-0000-0000-0000-000000000000", "destSiteId" : "00000000-0000-0000-0000-000000000000", "vpnId" : "00000000-0000-0000-0000-000000000000", "reason" : "Switch Over", "startTime" : 1616824800000, "endTime" : 1616828400000 }

请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 SprEventsReq 是 REFERENCE 详细请参见表2。 查询条件 - 表2 SprEventsReq对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 pageIndex 是 int32 [1-100000000] - 当前页，从1开始。 1 pageSize 是 int32 [1-1000] - 页大小 1000 srcSiteId 否 string 0~36个字符。 - 源站点ID "00000000-0000-0000-0000-000000000000" destSiteId 否 string 0~36个字符。 - 对端站点ID "00000000-0000-0000-0000-000000000000" vpnId 否 string 0~36个字符。 - VPN ID "00000000-0000-0000-0000-000000000000" reason 否 string Link State Change Loss Change Delay Change Jitter Change Link Bandwidth Usage Change App Bandwidth Usage Change Switch Over Link Delete Link UP Link Down Less Best Best Select Cmi exceeded threshold Select route for the first time First-time traffic steering Unknown - 切换原因： a) Link State Change：SLA质量变化 b) Loss Change：SLA丢包率变化 c) Delay Change：SLA时延变化 d) Jitter Change：SLA抖动变化 e) Link Bandwidth Usage Change：链路带宽变化 f) App Bandwidth Usage Change: 应用带宽变化 g) Switch Over: 回切 h) Link Delete: 链路删除 i) Link UP: 链路UP j) Link Down: 链路DOWN k) Less Best: 优先占用差中选优 l) Best Select: 负载均衡差中选优 m) Cmi exceeded threshold: 链路的综合度量指标超过策略配置的阈值 n) Select route for the first time: 首次选路(建议使用First-time traffic steering) 0) First-time traffic steering: 首次选路 p) Unknown: 其他原因 "Switch Over" startTime 是 int64 - - 查询的开始时间，格林威治时间戳，格式为UNIX时间戳，即从1970年1月1日（UTC/GMT的午夜）开始所经过的毫秒数，不考虑闰秒 1616824800000 endTime 是 int64 - - 查询的结束时间，格林威治时间戳，格式为UNIX时间戳，即从1970年1月1日（UTC/GMT的午夜）开始所经过的毫秒数，不考虑闰秒 1616828400000

响应示例 返回状态码为200：查询成功，响应体参考QueryBroadCastSumResponse。 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" : "200", "errmsg" : "", "pageSize" : 10, "pageIndex" : 1, "totalcount" : 1, "data" : [ { "id" : "00000000-0000-0000-0000-000000000000", "policyName" : "policy1", "deviceId" : "00000000-0000-0000-0000-000000000000", "deviceName" : "hub", "interfaces" : [ "00000000-0000-0000-0000-000000000000" ], "ruleCount" : 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 /controller/campus/v1/sdwan/policy/traffic/forward-broadcast/00000000-0000-0000-0000-000000000000?pageIndex=1&pageSize=1 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/sdwan/policy/traffic/forward-broadcast/{siteId} 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteId 是 uuid 1~64个字符。 - 站点ID。 "00000000-0000-0000-0000-000000000000" 表2 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 pageIndex 否 int32 [1-100] 1 当前页数，默认1。 1 pageSize 否 int32 [1-200] 10 每页显示数量，默认10。 1

响应示例 返回状态码为200：操作成功。 { "errcode": "0", "errmsg": "", "successList": [ "de5813f8ff1e41f5ba9c324da70b49ed1c2e" ], "failList": [ "de5813f8ff1e41f5ba9c324da70b49ed1c1e" ] } 返回状态码为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：正常响应返回体，响应体参考BgpVpnResetResponse。 表3 BgpVpnResetResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" success ARRAY_REFERENCE 1-10个列表项，详细请参见表4。 连接成功的信息列表。 - fail ARRAY_REFERENCE 1-10个列表项，详细请参见表4。 连接失败的信息列表。 - 表4 BgpVpnResetResponseInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 vpnId uuid 0~36个字符。 - VPN ID。 "00000000-0000-0000-0000-000000000000" vpnName string 0~64个字符。 - VPN名称。 "vpn1" siteId uuid 0~36个字符。 - 站点ID。 "00000000-0000-0000-0000-000000000000" siteName string 0~64个字符。 - 站点名称。 "site1" errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。

响应示例 返回状态码为200：正常响应返回体，响应体参考BgpVpnResetResponse。 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" : [ { "vpnId" : "00000000-0000-0000-0000-000000000000", "vpnName" : "vpn1", "siteId" : "00000000-0000-0000-0000-000000000000", "siteName" : "site1", "errcode" : "0", "errmsg" : "" } ], "fail" : [ { "vpnId" : "00000000-0000-0000-0000-000000000000", "vpnName" : "vpn1", "siteId" : "00000000-0000-0000-0000-000000000000", "siteName" : "site1", "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

接口约束 1、该接口支持租户视图或msp代维视图下，角色为“Open Api Operator”的用户访问，必须在用户会话建立后使用。 2、该接口仅支持在Topo中配置为gateway角色的站点，在重建BGP连接之前，需要确认差分模式已配置成功，差分模式配置状态可调用配置结果查询接口查看。 3、重置BGP操作会导致该VPN下业务中断，请谨慎操作。 4、目前对于mpls骨干的远端交叉路由（已经建立了lsp）需要使用reset mpls ldp或者reset bgp才会生效，如果生效后指定的EXP不满足，建议发往mpls方向的流量部署QOS修改为期望的exp。 该API可能会直接或间接影响现网业务运行，导致业务中断、关键数据丢失等，请谨慎操作！

请求示例 HTTP的示例 PUT /controller/campus/v1/sdwan/net/site/bgp-vpn-reset 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-000000000000", "siteIds" : [ "00000000-0000-0000-0000-000000000000" ] }

请求示例 HTTP的示例 DELETE /restconf/v2/data/huawei-ac-nes-device:nes/ne/00000000-0000-0000-0000-000000000000/huawei-nce-e-ipv4-urpf:ipv4-urpf/GE0%2F0%2F1 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-ipv4-urpf:ipv4-urpf/{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个字符。 - 接口名称，单一主键字段。 "GE0/0/1"

请求示例 HTTP的示例 POST /controller/campus/v1/sdwan/aaa/authorization 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 { "siteId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "authorizationSchema" : "name", "privilegeLevel" : 10, "authorizationModel" : { "primaryModel" : "hwtacacs", "backupModel" : "local" } }

响应示例 返回状态码为201：创建成功，响应体参考DeviceAuthorResponse。 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" : { "siteId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "authorizationSchema" : "name", "privilegeLevel" : 10, "authorizationModel" : { "primaryModel" : "hwtacacs", "backupModel" : "local" }, "deviceAuthorId" : "00000000-0000-0000-0000-000000000000" } } 返回状态码为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：创建成功，响应体参考DeviceAuthorResponse。 表4 DeviceAuthorResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~10个字符。 - 错误码。 "0" errmsg string 0~255个字符。 - 错误描述。 "" data REFERENCE 详细请参见表5。 - - 表5 DeviceAuthor对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 siteId uuid - - 站点ID。 "00000000-0000-0000-0000-000000000000" deviceId uuid - - 设备ID。 "00000000-0000-0000-0000-000000000000" authorizationSchema string 1~32个字符。 - 设备授权方案名称，创建后不允许修改。 "name" privilegeLevel int32 [0-15] - 权限级别，取值范围：0~15。 其中V600版本设备的权限级别取值范围为0~3。 10 authorizationModel REFERENCE 详细请参见表6。 - - deviceAuthorId uuid - - 设备授权方案ID。 "00000000-0000-0000-0000-000000000000" 表6 AuthorizationModel对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 primaryModel string hwtacacs local none local 1：设备主授权方案； 2：主备授权方案都为空时，主授权方案默认值为local； 3：当主授权方案为none或空时，不支持备授权方案； 4：当备授权方案不为空时，主方案必须设置为hwtacacs或local； 5：主备授权方案不能配置相同的值； 6：新增和修改都是以上规则。 "hwtacacs" backupModel string hwtacacs local - 设备备授权模式。 "local" 返回状态码为400：请求参数错误。 详细信息请参见实际响应消息体。 返回状态码为500：内部异常。 详细信息请参见实际响应消息体。

请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 authorization 是 REFERENCE 详细请参见表2。 设备授权方案信息。 - 表2 DeviceAuthorInfo对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteId 是 uuid - - 站点ID。 "00000000-0000-0000-0000-000000000000" deviceId 是 uuid - - 设备ID。 "00000000-0000-0000-0000-000000000000" authorizationSchema 是 string 1~32个字符。 - 设备授权方案名称，创建后不允许修改。 "name" privilegeLevel 否 int32 [0-15] - 权限级别，取值范围：0~15。 其中V600版本设备的权限级别取值范围为0~3。 10 authorizationModel 否 REFERENCE 详细请参见表3。 - - 表3 AuthorizationModel对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 primaryModel 否 string hwtacacs local none local 1：设备主授权方案； 2：主备授权方案都为空时，主授权方案默认值为local； 3：当主授权方案为none或空时，不支持备授权方案； 4：当备授权方案不为空时，主方案必须设置为hwtacacs或local； 5：主备授权方案不能配置相同的值； 6：新增和修改都是以上规则。 "hwtacacs" backupModel 否 string hwtacacs local - 设备备授权模式。 "local"

请求示例 HTTP的示例 POST /controller/campus/v2/oamservice/devoam/device/ap/system-blink 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 { "keepTime" : 30, "deviceIds" : [ "ea25fdbf-8dee-4823-bac2-5bfe8e3359ca" ] }

响应示例 返回状态码为200：配置成功，响应体参考OperationResultDto。 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" : "error", "successDeviceList" : [ "ea25fdbf-8dee-4823-bac2-5bfe8e3359ca" ], "failedDeviceList" : [ { "deviceId" : "ea25fdbf-8dee-4823-bac2-5bfe8e3359ca", "failedReason" : "Device is not online" } ] }

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

请求示例 HTTP的示例 PUT /controller/campus/v1/networkservice/networkconfig/net/tacacs/sites/fbb684c8-0d37-496f-bafa-4b06d5151e2e/tacacs 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 { "tacacsEnable" : true, "tacacsServerTmplId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e", "escape" : [ 0 ] }

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