华为云用户手册

响应示例 返回状态码为200：Successful operation HTTP/1.1 200 OK Date: Fri,03 Dec 2021 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "huawei-nce-aoc-config-template:output": { "children-templates": [ { "template-id": "4cb280c4-fd5c-471c-9b71-a7ff205484a5", "template-name": "江苏省", "parent-template-name": "中国区" }, { "template-id": "eb6bf0c7-cf68-489b-a6d4-2a33947c2249", "template-name": "南京市", "parent-template-name": "江苏省" }, { "template-id": "301a5e9e-813e-4b9f-a92a-e6a83d51a5fd", "template-name": "Zhejiang Province", "parent-template-name": "中国区" }, { "template-id": "fadebbff-d0c9-4916-85e7-d0fe314d47af", "template-name": "Hangzhou City", "parent-template-name": "Zhejiang Province" } ] } } 返回状态码为400：Bad Request HTTP/1.1 400 Bad Request Date: Thu,05 Jan 2023 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 query-children-templates-by-id 是 REFERENCE 详细请参见表2。 查询子孙模板 - 表2 query-children-templates-by-id-input对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 huawei-nce-aoc-config-template:input REFERENCE 详细请参见表3。 - - 表3 query-children-templates-by-id-input-body对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 template-id 否 string 1~128个字节。 - 模板ID 参数template-id与template-name必须选择其一写入请求参数中，且不能同时存在。 "26559bd3-a00e-4c6d-a573-e6b711a897b2" template-name 否 string 0~128个字节。 - 模板名称 参数template-id与template-name必须选择其一写入请求参数中，且不能同时存在。 "test"

请求示例 HTTP的示例 POST /restconf/operations/huawei-nce-aoc-config-template:query-children-templates-by-id Host: 192.168.1.125:26335 Content-Type: application/json Accept: application/json Accept-Language: en-US X-AUTH-TOKEN: x-yyyyyy { "huawei-nce-aoc-config-template:input": { "template-name":"中国区" // 或 "template-id":"b8308c56-9ea7-49e8-b0fd-9d886b4fddd2" } }

响应参数 返回状态码为200：Successful operation 表4 query-children-templates-by-id-output对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 huawei-nce-aoc-config-template:output REFERENCE 详细请参见表5。 - - 表5 query-children-templates-by-id-output-body对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 children-templates ARRAY_REFERENCE 详细请参见表6。 子孙模板 - 表6 query-children-templates-by-id-output-body-children-templates对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 template-id string 0~128个字节。 - 模板ID "26559bd3-a00e-4c6d-a573-e6b711a897b2" template-name string 0~128个字节。 - 模板名称 "test" template-description string 0~max个字节。 - 模板描述 "test" parent-template-name string 0~128个字节。 - 模板名称 "test-parent" 返回状态码为400：Bad Request 详细信息请参见实际响应消息体。

请求示例 cURL示例 curl -k -s -L -i -X DELETE \ https://{ip:port}/restconf/data/device-shell-group-northbound:device-shell-group/device-group/cccc2 \ -H 'cache-control: no-cache' \ -H 'content-type: application/json' \ -H 'x-access-token: x-ntc9c745ryk9uohj7vpint3wsanwo9nvnuur4bg5ir08bt3woavsjvc46rurrx9djzfy84k8c988qqnw04ldjw5hlfuq6q5iqpsbqkvwc82rvx0bvxnsgbhg5doa7wg9' HTTP示例 DELETE /restconf/data/device-shell-group-northbound:device-shell-group/device-group/cccc2 HTTP/1.1 Host: {ip:port} Content-Type: application/json x-access-token: x-ntc9c745ryk9uohj7vpint3wsanwo9nvnuur4bg5ir08bt3woavsjvc46rurrx9djzfy84k8c988qqnw04ldjw5hlfuq6q5iqpsbqkvwc82rvx0bvxnsgbhg5doa7wg9 Cache-Control: no-cache

响应参数 返回状态码为204：删除成功。 返回状态码为40X：参数不正确。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。 表2 错误码描述 Status Code Error Code Error Message Parameter 错误说明 400 0x006e004b 解析请求体发生错误。 错误的参数字段。 请求体body存在错误。 409 0x00c80014 设备组{0}不存在。 {0}：设备组名。 删除的设备组不存在。 500 0x00c80006 操作数据库异常。 - 系统内部错误，操作数据库存在异常。

响应示例 HTTP/1.1 204 No Content Server: product only Date: Tue, 19 Nov 2019 21:38:43 GMT Connection: keep-alive Keep-Alive: timeout=60 X-Frame-Options: DENY Strict-Transport-Security: max-age=31536000;incodeSubDomains Cache-Control: no-cache, no-store, must-revalidate X-Content-Type-Options: nosniff Pragma: no-cache Expires: Thu, 01 Jan 1970 00:00:00 GMT X-XSS-Protection: 1; mode=block

响应参数 返回状态码为200：查询成功，响应体参考QueryPageInfoOutputDto。 表2 QueryPageInfoOutputDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" data ARRAY_REFERENCE 详细请参见表3。 Portal定制页面信息列表。 - 表3 PortalPageInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string - - Portal定制页面id，UUID格式 "68b5bc98ed4340dfb586faa161803c56" pageName string 1~128个字符。 - Portal定制页面名称 "page" 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。

响应示例 返回状态码为200：查询成功，响应体参考QueryPageInfoOutputDto。 HTTP/1.1 200 OK Date: Tue,31 Dec 2024 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" : "68b5bc98ed4340dfb586faa161803c56", "pageName" : "page" } ] } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Tue,31 Dec 2024 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: Tue,31 Dec 2024 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

请求示例 HTTP的示例 GET /controller/campus/v2/accountservice/portalpage/page?pageName=pageName 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

URI /controller/campus/api/campusaccesscfgservice/v1/terminal/scanrule/query-scan-rules 表1 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 filter 否 string 0~200个字符。 - 查询条件。 "sortField::+name|keyword::rule" page 否 string 0~32个字符。 - 分页。 "pageIndex::1|pageSize::10"

请求示例 HTTP的示例 get /controller/campus/api/v1/terminal/scanrule/scanrules?filter=sortField::+name|keyword::rule&page=pageIndex::1|pageSize::10 HTTPS Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN:CA48D152F6B19D84:637C38259E6974E17788348128A430FEE150E874752CE754B6BF855281219925

响应参数 返回状态码为200：扫描成功，响应体参考ScanRuleGetOutputDto。 表2 ScanRuleGetOutputDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 pageIndex int32 [0-100] - 当前页码。 1 pageSize int32 [0-100] - 分页大小。 10 totalSize int32 [0-100] - 当前租户下扫描规则总数目。 100 errcode string 0~12个字符。 - 错误码 - errmsg string 0~256个字符。 - 错误信息 - data ARRAY_REFERENCE 0-100个列表项，详细请参见表5。 扫描规则列表 - 返回状态码为400：接口调用失败，响应体参考CommonErrorDto。 CommonErrorDto对象的参数列表，详细请参见表7。 返回状态码为500：内部错误，响应体参考CommonErrorDto。 CommonErrorDto对象的参数列表，详细请参见表7。

响应示例 返回状态码为200：扫描成功，响应体参考ScanRuleGetOutputDto。 HTTPS 200 OK Date: Jan,13 Fri 2023 10:00:00 GMT Server: example-server Content-Type: application/json { "pageIndex": 1, "pageSize": 10, "totalSize": 1, "errcode": "0", "errmsg": "", "data": [ { "id": "f0039bfc-5cf0-1f24-2865-86016a8a83c0", "name": "scanRule", "description": "scanRule", "scanType": [ "Real-time","Periodic" ], "scanPeriod": 30, "scanRangeList": [ { "id": "e555c570-2247-a16e-03e4-033e142474da", "sourceIp": "xxx", "vlanId": 1234, "scanIp": "xxx", "mask": 24, "description": "scanRange" } ], "vendors": [ "huawei","hikvision","dahua","uniview","tplink" ], "categories": "ip-camera" } ] } 返回状态码为400：接口调用失败，响应体参考CommonErrorDto。 HTTPS 400 ERROR Date: Jan,13 Fri 2023 10:00:00 GMT Server: example-server Content-Type: application/json { "errcode":"0x00c80014", "errmsg":"data not exist", "errdesc": "", "errreason": "", "errdetail": "", "erradvice": "" } 返回状态码为500：内部错误，响应体参考CommonErrorDto。 HTTPS 500 ERROR Date: Jan,13 Fri 2023 10:00:00 GMT Server: example-server Content-Type: application/json { "errcode":"0x00c80018", "errmsg":"internal error", "errdesc": "", "errreason": "", "errdetail": "", "erradvice": "" }

请求示例 HTTP的示例 PUT /restconf/data/huawei-nce-aoc-config-template-application:template-application/{template-application-id}/device/{device-id}/template/{template-id}/variable/{variable-name} Host: 192.168.1.125:26335 Content-Type: application/json Accept: application/json Accept-Language: en-US X-AUTH-TOKEN: x-yyyyyy { "variable":[ { "variable-name": "v2c", "variable-value":"valuex" } ] }

响应示例 返回状态码为204：Successful operation HTTP/1.1 204 No Content Date: Fri,30 Dec 2022 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为400：Internal Error HTTP/1.1 400 Bad Request Date: Fri,30 Dec 2022 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

URI /restconf/data/huawei-nce-aoc-config-template-application:template-application/{template-application-id}/device/{device-id}/template/{template-id}/variable/{variable-name} 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 template-application-id 是 string 0~128个字节。 - the identifier of the template application. "a945675d-ccff-4ea3-afb4-8d04ac3100c2" device-id 是 string 0~128个字节。 - the identifier of the device. "8d394835-cb84-38f3-a4d5-36a7f2074b49" template-id 是 string 1~128个字节。 - the identifier of the template. "a926f75d-ccff-4ea3-afb4-8d04ac3100c2" variable-name 是 string 1~512个字节。 - name of the variable. "aoc-variable-name"

参数说明 表1 “策略模板”（URL模板） 参数名称 说明 名称 用于唯一标识URL模板。 模板类型 “云平台中继认证”和“第三方认证”可供选择。 模板参数 赋值方式 范围： 替换控制器已有值：选择iMaster NCE-Campus已有参数。 用户自定义：用户自定义参数值。 约束和限制：赋值方式仅“云平台中继认证”类型有效。 参数内容 指定在URL中携带的模板参数信息。 模板类型不同，支持定义的模板参数也不同。各参数详细说明以及填写要求请参见表2。 参数名称 第三方portal服务器认证所需参数名称。 MAC地址格式设置（仅“模板类型”选择为“云平台中继认证”可配置） 默认不开启，开启后可设置“模板参数”中的“参数内容”为ap-mac、device-mac、user-mac参数的MAC地址格式。 开关开启时支持的设置的格式包含： MAC地址大小写：“大写”，“小写”。 MAC地址连接符：“横杠（-）”，“点（.）”，“冒号（：）”，“无连接符”。 MAC地址格式：“XXXX-XXXX-XXXX”，“XX-XX-XX-XX-XX-XX”。 URL参数加密（仅“模板类型”选择为“云平台中继认证”可配置） URL参数名称 为了传输数据的安全，希望Portal服务器和控制器之间传递的URL参数能够经过加密处理时，可通过使能此开关实现。 开启后URL参数会整体加密，仅支持AES-CBC算法。 密钥 三方认证系统和iMaster NCE-Campus对接时，该系统使用的对接密钥和密钥向量。 密钥IV向量 表2 模板参数 模板类型 参数 参数说明 取值 云平台中继认证 device-mac 指定在URL中携带认证设备的MAC地址。 取值为1~64位字母、短线、数字或下划线，不能以数字开头。 redirect-url 指定在URL中携带用户重定向前访问的原始URL。 ssid 指定在URL中携带用户关联的SSID名称。 user-ip 指定在URL中携带接入用户的IP地址。 user-mac 指定在URL中携带接入用户的MAC地址。 loginurl 指定在URL中携带iMaster NCE-Campus提供的用户认证的URL。 ap-location 指定在URL中携带AP的位置信息。 fitap-mac 指定在URL中携带WAC+FitAP认证场景下，FitAP的MAC地址信息。 sync-login-url 指定在URL中携带三方Portal服务器回调的认证同步接口信息。 sync-login-http-url 指定在URL中携带三方Portal服务器回调的认证同步HTTP接口信息。 site-code 指定在URL中携带站点认证码信息。 device-type 指定在URL中携带认证设备的设备类型信息。 site-name 指定在URL中携带站点名称信息。 第三方认证 ap-ip AP的IP地址。 取值为1~16位的半角字符，不能包含空格。 device-ip 认证设备的IP地址，对于普通云AP，需要使用ap-ip参数。 ap-mac AP的MAC地址。 redirect-url 用户重定向前访问的原始URL。 ssid 用户关联的SSID名称。 sysname 认证设备的系统名称。 user-ip 用户的IP地址。 user-mac 用户的MAC地址。 device-mac 认证设备的MAC地址，对于普通云AP，需要使用ap-mac参数。 interface 用户接入的设备接口。 esn 认证设备的ESN。 ap-location AP的位置信息。 login-url 认证设备的登录URL。其中： url-key：重定向时携带给Portal服务器登录URL的识别关键字。 url：接入设备上指定的URL。 说明： 中心AP不支持此参数。 “login-url”有两个值需要填充，url-key和url之间需要用空格隔开。例如：XX Y。 url-key：重定向时携带给Portal服务器登录URL的识别关键字。字符串形式，不支持空格、问号、和号和等于号，区分大小写，长度范围是1～16。 url：接入设备上指定的URL。字符串形式，不支持空格，区分大小写，长度范围是1～247。

请求示例 cURL的示例 curl -k -s -L -i -X PUT -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'Accept-Language: en-US' -H 'X-ACCESS-TOKEN: x-mk5ciqtg7yg9qrqlvt09fubsgb45gbburt8aupqko4ulap7x87jtfwo6cbeo8agbgbqo6lvvvzuqtf9cvugak42pqphd2ptj3vsa3xhevzo76ks9piermrlddhurrtfv' 'https://192.168.1.125:18002/rest/openapi/networkinventoryservice/v1/interfaces/modify-tasks/action' -d '{ "nedn":"827714c8-8898-3f00-b7f3-77a489e6a3bc", "ifDesc":"100GE1/0/1", "ifAlias":"test" }' HTTP的示例 PUT /rest/openapi/networkinventoryservice/v1/interfaces/modify-tasks/action HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-mk5ciqtg7yg9qrqlvt09fubsgb45gbburt8aupqko4ulap7x87jtfwo6cbeo8agbgbqo6lvvvzuqtf9cvugak42pqphd2ptj3vsa3xhevzo76ks9piermrlddhurrtfv { "nedn":"827714c8-8898-3f00-b7f3-77a489e6a3bc", "ifDesc":"100GE1/0/1", "ifAlias":"test" }

请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 modifyIfBody 是 REFERENCE 详细请参见表2。 设备接口描述信息修改参数模型 - 表2 ApiModifyIfData对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 nedn 是 string 0~255个字符。 - 设备dn。 说明：添加设备时分配的唯一标识 "00000000-0000-0000-0000-000000000000" interfaceId 否 string 1~255个字符。 - 接口id。 说明：接口添加时分配的唯一标识。 "00000000-0000-0000-0000-000000000000" ifIndex 否 integer [1-65535] - 接口索引。 说明：从设备上获取。 7 ifDesc 是 string 1~255个字符。 - 接口名称。 说明：从设备上获取。 GigabitEthernet1/0/1 ifAlias 是 string 1~242个字符。 - 接口别名。 说明：从设备上获取，可修改。如果设备不支持特殊字符和中文，接口返回错误码-3，错误信息为“snmp-error-set-10”。 "aaa"

CloudCampus和云管理网络套餐的转化关系 CloudCampus和云管理网络套餐的转化关系 CloudCampus License支持在华为乾坤云服务直接进行导入，导入时会根据以下映射规则，转成对应的乾坤云管理网络的套餐： 产品/服务 CloudCampus套餐 乾坤云管理网络套餐 CloudCampus Service 云管理订阅License，S27系列 基础分析，低端盒式整机 CloudCampus Service 云管理订阅License，S5700-LI系列-8端口 基础分析，标准千兆盒式整机 CloudCampus Service 云管理订阅License，S5700-LI系列-24端口 基础分析，标准千兆盒式整机 CloudCampus Service 云管理订阅License，S5700-LI系列-48端口 基础分析，标准千兆盒式整机 CloudCampus Service 云管理订阅License，S5700-S系列-8端口 基础分析，标准千兆盒式整机 CloudCampus Service 云管理订阅License，S5700-S系列-24端口 基础分析，标准千兆盒式整机 CloudCampus Service 云管理订阅License，S5700-S系列-48端口 基础分析，标准千兆盒式整机 CloudCampus Service 云管理订阅License，S5700-EI系列-24端口 基础分析，高级千兆盒式整机 CloudCampus Service 云管理订阅License，S5700-EI系列-48端口 基础分析，高级千兆盒式整机 CloudCampus Service 云管理订阅License，S5700-H系列 基础分析，高级千兆盒式整机 CloudCampus Service 云管理订阅License，S6700-LI系列 基础分析，标准万兆盒式整机 CloudCampus Service 云管理订阅License，S6700-S系列 基础分析，标准万兆盒式整机 CloudCampus Service 云管理订阅License，S6700-EI系列 基础分析，高级万兆盒式整机 CloudCampus Service 云管理订阅License，S6700-H系列 基础分析，高级万兆盒式整机 CloudCampus Service 云管理订阅License，S7700系列 基础分析，框式整机 CloudCampus Service 云管理订阅License，S127系列 基础分析，框式整机 CloudCampus Service 云管理订阅License，S5700S-L/LI系列-8端口 基础分析，标准千兆盒式整机 CloudCampus Service 云管理订阅License，S5700S-L/LI系列-24端口 基础分析，标准千兆盒式整机 CloudCampus Service 云管理订阅License，S5700S-L/LI系列-48端口 基础分析，标准千兆盒式整机 CloudCampus Service 云管理订阅License，S5700S-S/SI系列-24端口 基础分析，标准千兆盒式整机 CloudCampus Service 云管理订阅License，S5700S-S/SI系列-48端口 基础分析，标准千兆盒式整机 CloudCampus Service 云管理订阅License，S5700S-EI系列-24端口 基础分析，高级千兆盒式整机 CloudCampus Service 云管理订阅License，S5700S-EI系列-48端口 基础分析，高级千兆盒式整机 CloudCampus Service 云管理订阅License，S5700S-H系列 基础分析，高级千兆盒式整机 CloudCampus Service 云管理订阅License，S6700S-LI系列 基础分析，标准万兆盒式整机 CloudCampus Service 云管理订阅License，S6700S-S/SI系列 基础分析，标准万兆盒式整机 CloudCampus Service 云管理订阅License，S6700S-EI系列 基础分析，高级万兆盒式整机 CloudCampus Service 云管理订阅License，S67S-H系列 基础分析，高级万兆盒式整机 CloudCampus Service 云管理订阅License，室内AP 基础分析，WiFi5 AP CloudCampus Service 云运维License，室内AP 基础分析，WiFi5 AP CloudCampus Service 云管理订阅License，室外AP 基础分析，WiFi5 AP CloudCampus Service 云运维License，室外AP 基础分析，WiFi5 AP CloudCampus Service 云管理订阅License，室内AP-EC 基础分析，WiFi5 AP CloudCampus Service 云管理订阅License，AirEngine-室内 基础分析，WiFi6 AP CloudCampus Service 云运维License，AirEngine-室内 基础分析，WiFi6 AP CloudCampus Service 云管理订阅License，AirEngine-室外 基础分析，WiFi6 AP CloudCampus Service 云管理订阅License，室内AP-S 基础分析，WiFi5 AP CloudCampus Service 云管理订阅License，室外AP-S 基础分析，WiFi5 AP CloudCampus Service 云管理订阅License，SOHO AP 基础分析，低端盒式整机 CloudCampus Service 云管理订阅License，敏分AP 基础分析，敏分AP CloudCampus Service 云管理订阅License，AR100/AR500系列 基础分析，小微型分支接入设备 CloudCampus Service 云管理订阅License，AR1200系列 基础分析，小微型分支接入设备 CloudCampus Service 云管理订阅License，AR2200系列 基础分析，小微型分支接入设备 CloudCampus Service 云管理订阅License，AR3200系列 基础分析，小微型分支接入设备 CloudCampus Service 云管理订阅License，AR600系列，纯LAN设备基础管理 基础分析，小微型分支接入设备 CloudCampus Service 云管理订阅License，AR6100系列，纯LAN设备基础管理 基础分析，小微型分支接入设备 CloudCampus Service 云管理订阅License，AR6200系列，纯LAN设备基础管理 基础分析，中型分支接入设备 CloudCampus Service 云管理订阅License，AR6300系列，纯LAN设备基础管理 基础分析，中型分支接入设备 CloudCampus Service 云管理订阅License，AR100-S系列 基础分析，小微型分支接入设备 CloudCampus Service 云管理订阅License，AR600-S系列，纯LAN设备基础管理 基础分析，小微型分支接入设备 CloudCampus Service 云管理订阅License，AR6100-S系列，纯LAN设备基础管理 基础分析，小微型分支接入设备 CloudCampus Service 云管理订阅License，AR6200-S系列，纯LAN设备基础管理 基础分析，中型分支接入设备 CloudCampus Service 云管理订阅License，AR6300-S系列，纯LAN设备基础管理 基础分析，中型分支接入设备 CloudCampus Service 云管理订阅License，SOHO AR系列 基础分析，低端盒式整机 CloudCampus Service 云管理订阅License， AR600系列，LANWAN融合基础功能 SDWAN服务，小微型分支接入设备 CloudCampus Service 云管理订阅License， AR6100系列，LANWAN融合基础功能 SDWAN服务，小微型分支接入设备 CloudCampus Service 云管理订阅License， AR6200系列，LANWAN融合基础功能 SDWAN服务，中型分支接入设备 CloudCampus Service 云管理订阅License， AR6300系列，LANWAN融合基础功能 SDWAN服务，中型分支接入设备 CloudCampus Service 云管理订阅License， AR8100系列，LANWAN融合基础功能 SDWAN服务，大型分支接入设备 CloudCampus Service 云管理订阅License， AR5700-H系列，LANWAN融合基础功能 SDWAN服务，小微型分支接入设备 CloudCampus Service 云管理订阅License， AR6700-L系列，LANWAN融合基础功能 SDWAN服务，小微型分支接入设备 CloudCampus Service 云管理订阅License， AR8700系列，LANWAN融合基础功能 SDWAN服务，大型分支接入设备 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， 室内AP 基础分析，WiFi5 AP Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， 室外AP 基础分析，WiFi5 AP Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， 室内AP-S 基础分析，WiFi5 AP Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， 室外AP-S 基础分析，WiFi5 AP Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， 室内AP-EC 基础分析，WiFi5 AP Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， AirEngine-室内 基础分析，WiFi6 AP Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， AirEngine-室外 基础分析，WiFi6 AP Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， 敏分AP 基础分析，敏分AP Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S5700-LI系列-8端口 基础分析，标准千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S5700-LI系列-24端口 基础分析，标准千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S5700-LI系列-48端口 基础分析，标准千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S5700-S系列-8端口 基础分析，标准千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S5700-S系列-24端口 基础分析，标准千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S5700-S系列-48端口 基础分析，标准千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S5700-EI系列-24端口 基础分析，高级千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S5700-EI系列-48端口 基础分析，高级千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S5700-H系列 基础分析，高级千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S6700-LI系列 基础分析，标准万兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S6700-S系列 基础分析，标准万兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S6700-EI系列 基础分析，高级万兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S6700-H系列 基础分析，高级万兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S7700/S8700系列 基础分析，框式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S17系列 基础分析，低端盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S12700系列 基础分析，框式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S5700S-LI系列-8端口 基础分析，标准千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S5700S-LI系列-24端口 基础分析，标准千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S5700S-LI系列-48端口 基础分析，标准千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S5700S-S系列-24端口 基础分析，标准千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S5700S-S系列-48端口 基础分析，标准千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S5700S-EI系列-24端口 基础分析，高级千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S5700S-EI系列-48端口 基础分析，高级千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S5700S-H系列 基础分析，高级千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S6700S-LI系列 基础分析，标准万兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S6700S-S系列 基础分析，标准万兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S6700S-EI系列 基础分析，高级万兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析基础包订阅服务， S67S-H系列 基础分析，高级万兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析调优自愈增值包订阅服务， 室内AP 调优自愈，WiFi5 AP Cloud CampusInsight Service 华为云管理网络智能分析调优自愈增值包订阅服务， 室外AP 调优自愈，WiFi5 AP Cloud CampusInsight Service 华为云管理网络智能分析调优自愈增值包订阅服务， 室内AP-S 调优自愈，WiFi5 AP Cloud CampusInsight Service 华为云管理网络智能分析调优自愈增值包订阅服务， 室外AP-S 调优自愈，WiFi5 AP Cloud CampusInsight Service 华为云管理网络智能分析调优自愈增值包订阅服务， 室内AP-EC 调优自愈，WiFi5 AP Cloud CampusInsight Service 华为云管理网络智能分析调优自愈增值包订阅服务， AirEngine-室内 调优自愈，WiFi6 AP Cloud CampusInsight Service 华为云管理网络智能分析调优自愈增值包订阅服务， AirEngine-室外 调优自愈，WiFi6 AP Cloud CampusInsight Service 华为云管理网络智能分析调优自愈增值包订阅服务， 敏分AP 调优自愈，敏分AP Cloud CampusInsight Service 华为云管理网络智能分析应用分析增值包订阅服务， 室内AP 应用分析，WiFi5 AP Cloud CampusInsight Service 华为云管理网络智能分析应用分析增值包订阅服务， 室外AP 应用分析，WiFi5 AP Cloud CampusInsight Service 华为云管理网络智能分析应用分析增值包订阅服务， 室内AP-S 应用分析，WiFi5 AP Cloud CampusInsight Service 华为云管理网络智能分析应用分析增值包订阅服务， 室外AP-S 应用分析，WiFi5 AP Cloud CampusInsight Service 华为云管理网络智能分析应用分析增值包订阅服务， 室内AP-EC 应用分析，WiFi5 AP Cloud CampusInsight Service 华为云管理网络智能分析应用分析增值包订阅服务， AirEngine-室内 应用分析，WiFi6 AP Cloud CampusInsight Service 华为云管理网络智能分析应用分析增值包订阅服务， AirEngine-室外 应用分析，WiFi6 AP Cloud CampusInsight Service 华为云管理网络智能分析应用分析增值包订阅服务， S5700-H系列 应用分析，高级千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析应用分析增值包订阅服务， S6700-S系列 应用分析，标准万兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析应用分析增值包订阅服务， S6700-H系列 应用分析，高级万兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析应用分析增值包订阅服务， S5700S-S系列-24端口 应用分析，标准千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析应用分析增值包订阅服务， S5700S-S系列-48端口 应用分析，标准千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析应用分析增值包订阅服务， S5700S-H系列 应用分析，高级千兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析应用分析增值包订阅服务， S6700S-S系列 应用分析，标准万兆盒式整机 Cloud CampusInsight Service 华为云管理网络智能分析应用分析增值包订阅服务， S67S-H系列 应用分析，高级万兆盒式整机

ACL缺省模板介绍（仅V300版本AR设备） 表1 CreateACL模板参数介绍 参数名称 类型 取值范围 参数说明 acl_num Int 只支持基本ACL范围：2000～2999 ACL编号。 rule_name String 0～4294967294，10000为模板中保留值，请勿使用 ACL规则名称，不同的ACL节点，可以有相同名字的规则名称。 source_ip String - ACL规则匹配报文的源地址信息，例如10.10.10.2/24，表示24位反掩码，对应到路由器是：10.10.10.0 0.0.0.255。 下发到设备的命令行： acl number acl-num rule rule-name permit source_ip wildcard rule 10000 deny 父主题： iMaster NCE-Campus内置缺省模板参数介绍

请求示例 HTTP的示例 GET /restconf/data/huawei-nce-aoc-config-template-application:template-application/a945675d-ccff-4ea3-afb4-8d04ac3100c2/device/8d394835-cb84-38f3-a4d5-36a7f2074b49/template/a926f75d-ccff-4ea3-afb4-8d04ac3100c2/variable HTTP/1.1 Host: 192.168.1.125:26335 Content-Type: application/json Accept: application/json Accept-Language: en-US X-AUTH-TOKEN: x-yyyyyy { "huawei-nce-aoc-config-template-application:variable" : { "variable-name" : "aoc-variable-name", "variable-value" : "value", "encrypted" : true, "path" : [ "/snmp-user-uni-gnd:snmpUser/snmp-user-uni-gnd:version" ] } }

响应示例 返回状态码为200：Successful operation HTTP/1.1 200 OK Date: Fri,03 Dec 2021 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "huawei-nce-aoc-config-template-application:variable": [ { "variable-name": "v2c", "variable-value": "value1", "encrypted": false, "path": [ "/snmp-user-uni-gnd:snmpUser/snmp-user-uni-gnd:version" ] } ] } 返回状态码为400：Bad Request HTTP/1.1 400 Bad Request Date: Fri,30 Dec 2022 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

URI /restconf/data/huawei-nce-aoc-config-template-application:template-application/{template-application-id}/device/{device-id}/template/{template-id}/variable 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 template-application-id 是 string 0~128个字节。 - the identifier of the template application. "a945675d-ccff-4ea3-afb4-8d04ac3100c2" device-id 是 string 0~128个字节。 - the identifier of the device. "8d394835-cb84-38f3-a4d5-36a7f2074b49" template-id 是 string 1~128个字节。 - the identifier of the template. "a926f75d-ccff-4ea3-afb4-8d04ac3100c2"

支持的RADIUS消息 iMaster NCE-CampusiMaster NCE-WAN作为中继角色，可以将RADIUS消息发送给第三方的RADIUS服务器，实现认证、授权和计费功能。支持的RADIUS消息字段如下所示： 表1 认证消息列表 消息列表 说明 User-Name(1) 用户名，设置时候可以带 域名 (如user0001@isp)，也可以不带域名(如user0001)。内容可以是用户MAC或配置的用户名。 User-Password(2) 用户密码，PAP认证时，用户密码由NAS加密后传递给服务器。系统支持的用户PAP认证密码长度为0～128。内容可以是MAC地址或配置的密码。 Called-Station-ID(30) 用来携带NAS设备的号码信息，一般为设备MAC地址（有线用户）或SSID（WLAN无线用户）。 Calling-Station-ID(31) 用来携带客户端的号码信息，一般为MAC地址。 Acct-Session-ID(44) 计费ID。格式：7位主机名＋2位槽号＋1位子卡号＋2位端口号＋ 4位外层VLAN＋5位内层VLAN＋6位CPU Tick＋6位用户连接ID。 Framed-IP-Address(8) 用户的IP地址。 NAS-Port-ID(87) 用户接入的槽位号、子槽位号、端口号及vlanid。格式有两种： 老格式：2位槽号＋2位子卡号＋3位端口号＋9位VLAN。 新格式：slot=槽号；subslot=子卡号；port=端口；vlanid=VLAN或者 slot=槽号；subslot=子卡号；port=端口；vlanid=外层VLAN ；vlanid2=内层VLAN。 NAS-Port-Type(61) 设置NAS的端口类型，用户在交换机接口下可以配置。默认类型是Ethernet（15），无线用户为IEEE_802.11（19）。 Service-Type(6) 提供的服务类型。 2（Framed）：PPP、802.1x用户等其他用户。 5（Outbound）：IPSession接入用户。 6（Administrative）：管理用户。 10（Call Check）：MAX认证用户。 表2 授权消息列表 消息列表 说明 Session-Timeout(27) 在Access-Accept报文中，表示用户剩余的时间，以秒为单位。 在CHALLENGE报文中作为EAP用户的重认证时长。 下发数值必须大于0。可利用该属性下发用户在线时长。 Idle-Timeout(28) 用户的闲置切断时间，以秒为单位。 HW-Input-Committed-Information-Rate(26-2) 上行承诺速率，单位bps（上行CIR）。 HW-Output-Committed-Information-Rate(26-5) 下行承诺速率，单位bps（下行CIR）。 Reply-Message(18) 此属性可用于认证接受报文中，表示成功消息，也可用于认证拒绝报文中，表示拒绝消息。目前只对WEB认证用户，会把此信息传给用户。对于WEB认证，必须WEB服务器的版本支持。 Filter-ID(11) 通常该属性携带用户ACL号或用户组名或ucl-group名。RADIUS报文中只能携带ACL号或用户组名，不能同时携带两者。 表3 计费消息列表 消息列表 说明 Acct-Delay-Time(41) 用于上报发送该计费包花费的时间， 以秒为单位（不包括网络传输时间）。计费服务器收到该计费请求包后，可以从该计费请求包到达计费服务器的时间减去Acct-Delay-Time表示的时间得到NAS生成该计费请求包的时间（报文创建的时间）。在交换机中，Acct-Delay-Time表示的时间由两部分构成，一部分是RADIUS模块到AAA来取数据的时间和最近一次刷新的时间差，另外一部分是RADIUS模块发送该计费请求包耽误的时间（比如重传花费的时间）。 Acct-Session-ID(44) 计费ID。格式：7位主机名＋2位槽号＋1位子卡号＋2位端口号＋ 4位外层VLAN＋5位内层VLAN＋6位CPU Tick＋6位用户连接ID。 Acct-Status-Type(40) 计费请求报文的类型。Accounting-Request中支持的计费请求报文类型如下： Start (Value=1) Stop (Value=2) Interium-Update (Value=3) Calling-Station-ID(31) 用来携带客户端的号码信息，一般为MAC地址。 Event-Timestamp(55) 生成计费请求报文的时间 （以秒为单位， 表示从1970年1月1日零点零分零秒以来的绝对秒数）。 Framed-IP-Address(8) 用户的IP地址。 NAS-Identifier(32) NAS设备名称，即sysname，主机名。 NAS-IP-Address(4) 标识设备地址： 可以配置绑定具体的接口，取接口地址作为NAS-IP。 如果没有配置，取报文发送的出接口地址为NAS-IP。 NAS-Port(5) 用户接入的物理端口信息，格式有两种： 12位槽号＋8位端口号＋12位VLAN，位数不足用0补齐。 8位槽号＋4位子卡号＋8位端口号＋12位VLAN，位数不足用0补齐。 可通过命令行radius-server format-attribute nas-port format-sting配置自定义属性携带的内容，参数format-string定义内容可以为槽号、子槽号、端口、外层VLAN、内层VLAN内容的任意组合，内容之间可以用1或0填充。 format-sting参数详细说明如下： 使用关键字s、t、p、o、i分别表示slot，subslot，port，out-vlan（qinqvlan）/vpi，vlan（user-vlan）/vci。增加两个关键字n、z以便填充用。n表示填1，z表示填0。 s、t、p、o、i、z、n关键字后面必须是数值，并且数值范围为1～32。且s、t、p、o、i中的每个关键字只能出现一次。 s、t、p、o、i、z、n后面若是紧跟数字则第一个数字只能是1～9不能是0。 n、z可以出现在任何位置并且可出现多次，n、z后面跟数字，n12表示该位置填12位1，z12表示该位置填充12位0。 字符串配置的位数加起来必须为32位。 必须以s、t、p、o、i、z、n开头，以数字结尾。 VLAN不存在时填0还是填1可以在o或i关键字前添加n、z说明，也就是说n、z后面可以跟数字或o/i。 Acct-Session-Time(46) 用户的在线时长，以秒为单位。 Acct-Input-Packets(47) 上行流量，单位报文个数。 Acct-Output-Packets(48) 下行流量，单位报文个数。 Acct-Input-Octets(42) 上行流量，单位字节数。 Acct-Output-Octets(43) 下行流量，单位字节数。 Acct-Input-Gigawords(52) 上行流量，单位1G字节数。 父主题： 云平台中继认证（RADIUS方式）

响应示例 返回状态码为204：Successful operation HTTP/1.1 204 No Content Date: Fri,30 Dec 2022 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为400：Internal Error HTTP/1.1 400 Bad Request Date: Fri,30 Dec 2022 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

请求示例 HTTP的示例 DELETE /restconf/data/huawei-nce-aoc-config-template-application:template-application/a945675d-ccff-4ea3-afb4-8d04ac3100c2/template/a926f75d-ccff-4ea3-afb4-8d04ac3100c2 HTTP/1.1 Host: 192.168.1.125:26335 Content-Type: application/json Accept: application/json Accept-Language: en-US X-AUTH-TOKEN: x-yyyyyy

URI /restconf/data/huawei-nce-aoc-config-template-application:template-application/{template-application-id}/template/{template-id} 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 template-application-id 是 string 0~128个字节。 - the identifier of the template application. "a945675d-ccff-4ea3-afb4-8d04ac3100c2" template-id 是 string 1~128个字节。 - the identifier of the template. "a926f75d-ccff-4ea3-afb4-8d04ac3100c2"

参数介绍 表1 CreateDnsServer模板参数解释 参数名称 类型 取值范围 参数解释 vpnInstanceName String 1～31 设备向指定VPN网络的DNS服务器发送DNS查询请求。设备已存在的VPN实例。 dnsName String 1～255 DNS服务器名称，不支持空格，区分大小写。 dnsIp String 点分十进制格式 指定DNS服务器的IP地址。 下发到设备的命令行： dns resolve dns server dnsIp dns server vpn-instance vpnInstanceName