华为云用户手册

响应示例 返回状态码为200：Successful operation HTTP/1.1 200 OK Content-Type: application/json { "output": { "subscription-result": "ok", "identifier": "e7428178-dada-4d02-8c12-e0c0cb2a504d", "url": "/restconf/streams/sse/v1/identifier/e7428178-dada-4d02-8c12-e0c0cb2a504d" } } 返回状态码为400：Bad request HTTP/1.1 400 Bad Request Date: Mon,30 Dec 2019 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

响应参数 返回状态码为200：Successful operation 表10 EstablishResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 output REFERENCE 详细请参见表11。 响应数据参数 - 表11 EstablishOutput对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 subscription-result string - - 订阅结果 - identifier string - - 订阅标识，订阅通知成功后，系统会给用户分配一个订阅标识UUID "1fc2bd25-5ff6-4241-a7c9-20a2d45e081c" url string - - 创建通知通道的URL，订阅通知成功后，系统返回这个url，用户可以通过此url来建立连接接收通知 - 返回状态码为400：Bad request 详细信息请参见实际响应消息体。

请求示例 HTTP的示例 POST /restconf/v1/operations/huawei-nce-notification-action:establish-subscription Content-Type: application/json Accept: application/json Accept-Language: en-US X-Auth-Token: x-yyy { "input": { "encoding": "encode-json", "protocol": "sse", "subscription": [{ "topic": "resources", "object-type-infos": [{ "object-type": "network-element", "version": "v2" }], "operation": "" }, { "topic": "alarm", "alarm-conditions": { "alarm-ids": [], "alarm-sources": [], "severity-levels": [] } } ] } }

响应示例 返回状态码为200：单板资源查询成功。 HTTP/1.1 200 OK Date: Tue,30 Oct 2018 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "code" : 0, "data" : [ { "nedn" : "047f72d1-7ad3-11e9-b906-000c29b01448", "neName" : "FW_B", "framedn" : "047f72d1-7ad3-11e9-b906-000c29b01448,FR=1", "framename" : "Eudemon1000E-N6", "frameno" : 1, "slotdn" : "047f72d1-7ad3-11e9-b906-000c29b01448,FR=1,S=1", "slotindex" : 67371017, "slotno" : 1, "vendortype" : ".1.3.6.1.4.1.2011.20021210.12.16719978", "descr" : "--", "slotname" : "2XG8GE", "physicalclass" : 9, "adminstatus" : 4, "operstatus" : 3, "standbystatus" : 1, "hardversion" : "VER.A", "firmversion" : "221 Nov 28 2017 17:23:17", "softversion" : "V500R001C80SPC100", "serialnum" : "210235G7FW0123456789", "mfgname" : "Huawei", "modelname" : "huawei", "alarmlight" : "huawei" } ], "description" : "查询成功。" } 返回状态码为400：参数错误。 HTTP/1.1 400 Bad Request Date: Tue,30 Oct 2018 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为404：rest接口没找到。 HTTP/1.1 404 Not Found Date: Tue,30 Oct 2018 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：默认ServiceException异常码，应用内部错误。 HTTP/1.1 500 Internal Server Error Date: Tue,30 Oct 2018 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

请求示例 cURL的示例 curl -k -s -L -i -X GET -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'Accept-Language: en-US' -H 'X-AC CES S-TOKEN: x-rwld6ng9vy2rg96llg85sbdisbmrfw1gdfamaoepoahcaq2nliams8s8epapiofx2r5druhi5g7wmmjzc5btftlduo7w88bybuqp7xmlup9htd5gpg4bmmrufvnt4aan' 'https://192.168.1.125:18002/rest/openapi/network/slot?nedn=047f72d1-7ad3-11e9-b906-000c29b01448&nename=FW_B&framedn=047f72d1-7ad3-11e9-b906-000c29b01448,FR=1&framename=Eudemon1000E-N6&frameno=1&slotdn=047f72d1-7ad3-11e9-b906-000c29b01448,FR=1,S=1&slotindex=67371017&slotno=1&vendortype=.1.3.6.1.4.1.2011.20021210.12.16719978&descr=--&slotname=2XG8GE&physicalclass=9&adminstatus=4&operstatus=3&standbystatus=1&hardversion=VER.A&firmversion=221 Nov 28 2017 17:23:17&softversion=V500R001C80SPC100&serialnum=210235G7FW0123456789&mfgname=Huawei&modelname=huawei&alarmlight=huawei&start=0&size=20&orderby=nedn&desc=true&fields=nedn' HTTP的示例 GET /rest/openapi/network/slot?nedn=047f72d1-7ad3-11e9-b906-000c29b01448&nename=FW_B&framedn=047f72d1-7ad3-11e9-b906-000c29b01448,FR=1&framename=Eudemon1000E-N6&frameno=1&slotdn=047f72d1-7ad3-11e9-b906-000c29b01448,FR=1,S=1&slotindex=67371017&slotno=1&vendortype=.1.3.6.1.4.1.2011.20021210.12.16719978&descr=--&slotname=2XG8GE&physicalclass=9&adminstatus=4&operstatus=3&standbystatus=1&hardversion=VER.A&firmversion=221 Nov 28 2017 17:23:17&softversion=V500R001C80SPC100&serialnum=210235G7FW0123456789&mfgname=Huawei&modelname=huawei&alarmlight=huawei&start=0&size=20&orderby=nedn&desc=true&fields=nedn HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-rwld6ng9vy2rg96llg85sbdisbmrfw1gdfamaoepoahcaq2nliams8s8epapiofx2r5druhi5g7wmmjzc5btftlduo7w88bybuqp7xmlup9htd5gpg4bmmrufvnt4aan

响应参数 返回状态码为200：单板资源查询成功。 表2 SlotResResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 code int32 - 0 操作返回码。可以是如下值之一： 0：成功 非0：失败 0 data ARRAY_REFERENCE 详细请参见表3。 - - description string - - 描述信息。 Operation success 表3 SlotResData对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 nedn string - - 设备dn。 "047f72d1-7ad3-11e9-b906-000c29b01448" neName string - - 设备名称。 "FW_B" framedn string - - 机框dn。 "047f72d1-7ad3-11e9-b906-000c29b01448,FR=1" framename string - - 机框名称。 "Eudemon1000E-N6" frameno integer - - 机框序号。 1 slotdn string - - 单板dn。 "047f72d1-7ad3-11e9-b906-000c29b01448,FR=1,S=1" slotindex integer - - 单板索引。 67371017 slotno integer - - 单板序号。 1 vendortype string - - 厂商类型。 ".1.3.6.1.4.1.2011.20021210.12.16719978" descr string - - 单板描述。 "--" slotname string - - 单板名称。 "2XG8GE" physicalclass integer - - 设备上实体大类型： 3：框 4：背板 5：子槽 6：电源 7：风扇 9：板 10：端口 9 adminstatus integer - - 管理状态： 4、11：正常 2、3、12：错误 13：LoopBack 其他：未知 4 operstatus integer - - 操作状态： 3、11、13、15、16：正常 2、12、17：错误 4：离线 其他：未知 3 standbystatus integer - - 主备状态： 1：notSupported 2：hotStandby 3：coldStandby 4：providingService 1 hardversion string - - 硬件版本。 "VER.A" firmversion string - - 固件版本。 "221 Nov 28 2017 17:23:17" softversion string - - 软件版本。 "V500R001C80SPC100" serialnum string - - 序列号。 "210235G7FW0123456789" mfgname string - - 组件名称。 "Huawei" modelname string - - 模块名称。 "huawei" alarmlight string - - 预留字段，当前无意义。 "huawei" 返回状态码为400：参数错误。 详细信息请参见实际响应消息体。 返回状态码为404：rest接口没找到。 详细信息请参见实际响应消息体。 返回状态码为500：默认ServiceException异常码，应用内部错误。 详细信息请参见实际响应消息体。

URI /rest/openapi/network/slot 表1 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 nedn 否 string 1~100个字符。 - 设备DN。 "047f72d1-7ad3-11e9-b906-000c29b01448" nename 否 string 1~100个字符。 - 设备名称。 "FW_B" framedn 否 string 1~100个字符。 - 机框DN。 "047f72d1-7ad3-11e9-b906-000c29b01448,FR=1" framename 否 string 1~100个字符。 - 机框名称。 "Eudemon1000E-N6" frameno 否 integer 满足正则表达^([-+]?\d{1,10})$。 - 机框序号。 1 slotdn 否 string 1~100个字符。 - 单板Dn。 "047f72d1-7ad3-11e9-b906-000c29b01448,FR=1,S=1" slotindex 否 integer 满足正则表达^([-+]?\d{1,10})$。 - 单板索引。 67371017 slotno 否 integer 满足正则表达^([-+]?\d{1,10})$。 - 单板序号。 1 vendortype 否 string 1~100个字符。 - 厂商类型。 ".1.3.6.1.4.1.2011.20021210.12.16719978" descr 否 string 1~100个字符。 - 单板描述。 "--" slotname 否 string 1~100个字符。 - 单板名称。 "2XG8GE" physicalclass 否 integer 满足正则表达^([-+]?\d{1,10})$。 - 设备上实体大类型： 3：框 4：背板 5：子槽 6：电源 7：风扇 9：板 10：端口 9 adminstatus 否 integer 满足正则表达^([-+]?\d{1,10})$。 - 管理状态： 4、11：正常 2、3、12：错误 13：LoopBack 其他：未知 4 operstatus 否 integer 满足正则表达^([-+]?\d{1,10})$。 - 操作状态： 3、11、13、15、16：正常 2、12、17：错误 4：离线 其他：未知 3 standbystatus 否 integer 满足正则表达^([-+]?\d{1,10})$。 - 主备状态： 1：notSupported 2： hotStandby 3：coldStandby 4：providingService 1 hardversion 否 string 1~100个字符。 - 硬件版本。 "VER.A" firmversion 否 string 1~100个字符。 - 固件版本。 "221 Nov 28 2017 17:23:17" softversion 否 string 1~100个字符。 - 软件版本。 "V500R001C80SPC100" serialnum 否 string 1~100个字符。 - 序列号。 "210235G7FW0123456789" mfgname 否 string 1~100个字符。 - 组件名称。 "Huawei" modelname 否 string 1~100个字符。 - 模块名称。 "huawei" alarmlight 否 string 1~100个字符。 - 预留字段，当前无意义。 "huawei" start 否 integer - 0 指定从哪个起始记录位置开始返回查询结果集。缺省值是0。说明： 如果值小于0，将使用缺省值。 0 size 否 integer - 20 指定返回查询结果集总数。缺省值是20。说明： 1、如果值小于0，将使用缺省值。2、数据的size，最大建议10000条。 20 orderby 否 string - nedn 指定查询结果集采用的排序字段。缺省排序字段是nedn。可指定的排序字段包括：nedn、nename、framedn、framename、slotdn说明：指定多个排序字段时字段间用英文半角逗号“,”分隔。 "nedn" desc 否 boolean - false 指定查询结果是否按降序排序。缺省值是false。说明： 此请求参数只有指定了“orderby”请求参数后才有效。 true fields 否 string - - 指定查询结果所包含的列。需要查询的列名为fields参数的值，多个列名时可用英文逗号隔开。说明：此请求参数只有指定了“fields”请求参数后才有效，不指定默认返回所有字段。 "nedn"

请求示例 cURL示例 curl -k -s -L -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'Accept-Language: en-US' -H 'X-ACCESS-TOKEN: CA48D152F6B19D84:637C38259E6974E17788348128A430FEE150E874752CE754B6BF855281219925' 'https://{ip:port}/restconf/operations/huawei-ac-restconf-transactions:commit' -d '{"huawei-ac-applications:input":{"trans-id":"83bac01c-df39-473a-aa27-789549ff98bf"}}，"force":false,"no-network":false' HTTP示例 POST /restconf/operations/huawei-ac-restconf-transactions:commit HTTP/1.1 Host: {ip:port} Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: CA48D152F6B19D84:637C38259E6974E17788348128A430FEE150E874752CE754B6BF855281219925

响应参数 表4 CommitOutput对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 huawei-ac-restconf-transactions:output REFERENCE 详细信息请参见表 huawei-ac-restconf-transactions:output对象的参数列表。 - 表5 huawei-ac-restconf-transactions:output对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 reason string 0~255个字符 - 失败原因。 result boolean - - 是否成功。 extra-info REFERENCE - - 额外异步任务 表6 extra-info对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 async-task-id string 0~255个字符 额外异步任务ID 返回状态码为200：提交成功。 返回状态为400或500：提交失败。 表7 错误码描述 Status Code Error Code Error Message Parameter 错误说明 500 0x00c80022 {0}下发转发器失败，“{1}”。 {0}：节点名称，“{1}”：详细原因。 下发转发器失败，请检查预配置；如果预配置正确，请根据对应设备的详细错误信息进行分析。 400 0x00c80055 {0}重复。 {0} ：系统配置。 业务分解出的网元数据与系现存的配置存在重复。 500 0x01600004 业务{0}分解的网元数据{1}存在冲突，请重新编辑。 {0}：业务名称，{1}，网元数据Path。 两个业务修改了同一个网元数据，并且数据不一致。 500 0x01600001 事务\"{0}\"已经过期，未下发的配置已经失效。 {0}：用户事务ID。 事务默认5天过期，或者该事务已经被提交。 500 0x00c8004c 设备{0} netconf通信失败。 {0}：转发器ID。 设备netconf协议断链。

响应示例 HTTP/1.1 200 OK Date: Tue,30 Oct 2018 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "huawei-ac-restconf-transactions:output": { "result": true } }

请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 commitInput 是 REFERENCE 详细信息请参见表 commitInput对象的参数列表。 提交修改参数。 表2 commitInput对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 huawei-ac-restconf-transactions:input 否 REFERENCE 详细信息请参见表 huawei-ac-restconf-transactions:commit 对象的参数列表。 - 表3 huawei-ac-restconf-transactions:commit 对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 trans-id 是 string 1~255个字符 - 事务ID。 force 否 boolean - false 是否强制提交。当为true，强制下发配置到设备。 no-network 否 boolean - false 是否将配置发送到设备。当为false，将配置下发到设备。 async-execution 否 boolean - false 是否异步执行。如果为true，将通过任务管理下发 only-service 否 boolean - false 是否不分解和部署到设备。 service-parallel 否 boolean - false 是否并行执行。 by-user 否 boolean - false 是否是用户操作模式。 time-out 否 int - - 设置超时时间

响应示例 返回状态码为200：任务进展 HTTP/1.1 200 OK Date: Tue,30 Oct 2018 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "error_code": 0, "error_msg": "Successful.", "syncResult": "SUCCESS", "syncDetails": [ { "itemName": "ipaddress", "itemProgress": "SUCCESS" }, { "itemName": "interface", "itemProgress": "SUCCESS" }, { "itemName": "trunkif", "itemProgress": "SUCCESS" } ] }

响应参数 返回状态码为200：任务进展 表2 ApiIfSyncProgressResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 error_code int32 - 0 错误码。 - error_msg string - Successful. 错误消息。 - syncResult string WAITING SYNCING PARSING SUCCESS FAILURE PARTLYSUCCESS DUPLICATETASK REACHLIMIT NENOTEXIST NEUNMANAGED NEOFFLINE FULLTASKRUNNING NECANNOTSYNCING TASKNOTEXIST PROTOCOLERROR - 同步的整体结果 - syncDetails ARRAY_REFERENCE 详细请参见表3。 特性同步结果 - 表3 ApiIfItemResult对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 itemName string - - 特性名称 - itemProgress string WAITING SYNCING PARSING SUCCESS FAILURE - 特性同步结果 -

URI /rest/openapi/networkinventoryservice/v1/interfaces/sync-task/action 表1 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 id 是 string 1~36个字符。满足正则表达[a-zA-Z0-9_@\\-]{1,36}。 - 任务ID "00000000-0000-0000-0000-000000000000"

请求示例 cURL的示例 curl -k -s -L -i -X GET -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'Accept-Language: en-US' -H 'X-ACCESS-TOKEN: x-rwld6ng9vy2rg96llg85sbdisbmrfw1gdfamaoepoahcaq2nliams8s8epapiofx2r5druhi5g7wmmjzc5btftlduo7w88bybuqp7xmlup9htd5gpg4bmmrufvnt4aan' 'https://192.168.1.125:18002/rest/openapi/networkinventoryservice/v1/interfaces/sync-task/action?id=00000000-0000-0000-0000-000000000000' HTTP的示例 GET /rest/openapi/networkinventoryservice/v1/interfaces/sync-task/action?id=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-rwld6ng9vy2rg96llg85sbdisbmrfw1gdfamaoepoahcaq2nliams8s8epapiofx2r5druhi5g7wmmjzc5btftlduo7w88bybuqp7xmlup9htd5gpg4bmmrufvnt4aan

响应示例 返回状态码为200：Successful operation HTTP/1.1 200 OK 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-binding:template-binding/{template-binding-id}/template/{template-id} 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 template-binding-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}。 - the identifier of the template binding. "e5f97d04-7c18-41b7-a25a-702db1c108d7" template-id 是 string 1~128个字节。 - the identifier of the template. "a926f75d-ccff-4ea3-afb4-8d04ac3100c2"

请求示例 HTTP的示例 DELETE /restconf/data/huawei-nce-aoc-config-template-binding:template-binding/e5f97d04-7c18-41b7-a25a-702db1c108d7/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

请求示例 cURL的示例 curl -k -s -L -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'Accept-Language: en-US' -H 'X-ACCESS-TOKEN: x-yyyyyy' 'https://192.168.1.125:18002/rest/openapi/network/wlan/region-topo/regions/action/delete' -d '{ "siteId" : "", "objIds" : [ "" ] }' HTTP的示例 POST /rest/openapi/network/wlan/region-topo/regions/action/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 { "siteId" : "", "objIds" : [ "" ] }

响应参数 返回状态码为200：返回操作是否成功 OpenApiOperationRegionResponse对象的参数列表，详细请参见表3。 返回状态码为400：参数错误 详细信息请参见实际响应消息体。 返回状态码为403：URL鉴权 详细信息请参见实际响应消息体。 返回状态码为404：rest接口没找到 详细信息请参见实际响应消息体。 返回状态码为406：流控限流 详细信息请参见实际响应消息体。 返回状态码为500：默认ServiceException异常码，应用内部错误 详细信息请参见实际响应消息体。 返回状态码为502：网关错误 详细信息请参见实际响应消息体。 返回状态码为503：服务不可用 详细信息请参见实际响应消息体。 返回状态码为504：表示时间超时，总线超时时间300s 详细信息请参见实际响应消息体。

响应示例 返回状态码为200：返回操作是否成功 HTTP/1.1 200 OK { "errorCode": 0, "errorMsg": null, "data": [ { "operErrorCode": 0, "resultMsg": null, "tenantId": "efabceb476d7416291c7470270237613", "name": "N5-1", "regionType": 5, "objId": "e8175163-0761-414d-bef1-9cb0b493391c", "siteId": "4d7fafd6-5ea9-49b9-a295-f95a91b1f72c", "parentObjId": "0cb7cebc-3ed5-4c1f-848d-7dd797d5c386" } ] } 返回状态码为400：参数错误 HTTP/1.1 400 Bad Request Date: Tue,30 Oct 2018 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为403：URL鉴权 HTTP/1.1 403 Forbidden Date: Tue,30 Oct 2018 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为404：rest接口没找到 HTTP/1.1 404 Not Found Date: Tue,30 Oct 2018 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为406：流控限流 HTTP/1.1 406 Not Acceptable Date: Tue,30 Oct 2018 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：默认ServiceException异常码，应用内部错误 HTTP/1.1 500 Internal Server Error Date: Tue,30 Oct 2018 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为502：网关错误 HTTP/1.1 502 Bad Gateway Date: Tue,30 Oct 2018 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为503：服务不可用 HTTP/1.1 503 Service Unavailable Date: Tue,30 Oct 2018 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为504：表示时间超时，总线超时时间300s HTTP/1.1 504 Gateway Timeout Date: Tue,30 Oct 2018 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

IPv6静态路由缺省模板介绍（仅V300版本AR设备） 表1 CreateIpv6StaticRouting模板参数解释 参数名称 类型 取值范围 参数解释 routing_instance_name String 1～31 路由VPN实例的名称，必须为开局中存在的VPN示例名称，如“underlay_1”。 routing_protocol_name String - 路由协议实例的名称，不支持空格、中文，区分大小写，记录的名称不能含有“@”、“%”、“*”等特殊字符。 destination_prefix String 0～128 IPv6地址前缀的长度，即掩码中连续“1”的个数。“1”必须是连续的。 next_hop_address String - 下一跳的IPv6地址，格式为X:X:X:X:X:X:X:X。 tag Int 1～4294967295 路由标记的值，配置不同的tag属性值，可对静态路由进行分类，以实现不同的路由管理策略。 description String 1～80 指定静态路由的描述信息，当前需要配置为“agile-controller”。 下发到设备的命令行： ipv6 route-static vpn-instance underlay_1 next_hop_address destination_prefix tag tag description agile-controller 父主题： iMaster NCE-Campus内置缺省模板参数介绍

数据规划 表1 无线访客数据规划 配置项 数据 SSID模板 模板名称：wlan-net-ssid SSID名称：Guest 转发模式：隧道转发 业务VLAN：VLAN20 绑定AP组：default 安全模板 名称：wlan-net-security 安全策略：Portal认证 HACA接入配置 服务器IP地址：华为乾坤云平台南向IP地址139.9.137.139 URL：https://139.9.137.139:19008/portal 报文端口号：50100 重定向配置： AC-MAC关键字/AC-MAC：wac-mac 用户访问URL关键字：redirect-url 用户MAC关键字：umac 用户IP地址关键字：uaddress SSID关键字：ssid

操作步骤 配置Hub1站点的静态路由。 在“Underlay配置”页签，选择待配置的站点（如：Hub1）。 图1 Underlay配置页签入口 在“WAN路由”页签中，单击“点击添加路由协议”，在显示的对话框中，选择“IPv4 Static”，单击“确定”。 图2 添加路由协议 单击“创建”，添加静态路由，如图3所示。各路由参数值请参考Underlay网络数据规划。 图3 Hub1的静态路由 采用相同方式配置Hub2、Site1的静态路由。 各路由参数值请参考Underlay网络数据规划。

分支互连 对于多园区/分支网络，云管理网络为海量分支提供SD-WAN和IPsec VPN两种互联方案： SD-WAN：属于一种动态的VPN，可以按需在站点间建立隧道，动态发布路由。SD-WAN通过在站点间建立GRE隧道来创建VPN通道，同时支持在GRE隧道上进行IPsec加密，以实现隧道的加密安全。另外SD-WAN可以基于应用、策略选择质量较优的链路发送数据，实现基于应用、策略的智能选路。 IPsec VPN：属于一种静态的VPN，通过在站点之间建立IPsec隧道来创建VPN通道，根据配置静态网段引流到VPN隧道中，实现站点间的业务通过VPN隧道进行访问。 SD-WAN和IPsec VPN互联方案还提供了丰富多样的组网能力，通过Hub-Spoke、Full-Mesh等组网模型，满足不同分支需求，实现分支到Internet、分支到总部或数据中心、分支到分支等多种业务需求。

网络数字地图 网络数字地图是网络的数字孪生。它通过实时采集海量数据，在数字空间中重建物理世界的网络，以一张数字地图的形式清晰地展示网络的基础信息、用户体验和应用体验。这张地图能够实现全网一图可视，帮助用户直观地感知网络状态，提高网络运维效率。 华为乾坤网络数字地图是华为乾坤云管理网络提供的网络数字地图。当客户购买了华为乾坤云管理网络服务，且完成必要配置，即可使用华为乾坤网络数字地图功能。 华为乾坤网络数字地图具备三层状态感知、分钟级AI定位和一站式体验保障等亮点能力，能够主动感知网络故障和业务体验问题，快速定位，从而保障关键业务的体验。 三层状态感知 网络层、用户层和应用层的状态感知，全网状态一图清晰可见。 分钟级AI定位 用户旅程支持时间和空间回放，体验问题易回溯。 应用质量端到端随流检测，体验问题易定位。 一站式体验保障 VIP用户、重点应用（如：音视频）等一站式保障，体验实时感知，快速优化。 关于华为乾坤网络数字地图更详细的介绍，请参考《（eBook）华为乾坤-网络数字地图》。

站点管理 用户可以把同一管理范围内的设备添加到同一站点中，方便在华为乾坤云平台上进行统一管理。 站点管理：包括站点创建、修改和删除等。 站点拓扑管理：对于已创建的站点，可以直接进入站点首页，而且无论通过何种方式在站点中添加了设备信息，都可以在站点首页以拓扑形式展示。站点拓扑可以更直观地呈现当前站点网络信息，同时也可以从拓扑视角更方便快捷地进行网络业务配置和调整。 站点业务配置：站点创建完成后，可以在站点上进行网络业务配置，待站点设备在华为乾坤云平台上线后，设备侧业务配置将自动下发。配置完成后，还可以查看配置结果，查看当前站点业务配置在设备的下发情况。

背景信息 WLAN网络是以射频信号（例如频率为2.4GHz或5GHz的无线电磁波）作为传输介质的，无线电磁波在空气中的传播会因为周围环境影响而导致无线信号衰减等现象，进而影响无线用户上网的服务质量。通过调整信道和功率，可以使各AP的信道和功率保持相对平衡，保证AP工作在最佳状态。 在AP上按实际需要配置握手协议模式、空口扫描参数和天线增益等，可以合理控制AP的无线网络覆盖区域、减少射频干扰和数据传输冲突。通过为射频功能配置定时开启/关闭策略，可以降低不必要的能耗。 在不同的国家和地区，法律法规为无线通信规定了不同的工作信道和功率，使用AP部署无线网络时，射频参数必须符合当地法律法规。在华为技术支持网站搜索并下载“国家码&信道顺从表”，可以查看具体约束信息。 企业用户技术支持网站：https://support.huawei.com/enterprise 运营商用户技术支持网站：https://support.huawei.com

配置思路 图1是典型网络部署流程和步骤，如果您的网络业务有特殊需求，可以在此基础上进行调整。 图1 配置流程图 本案例以第三方路由器作为网关设备，核心交换机作为DHCP Server，且通过命令行配置上云，上云后可通过远程方式进行业务配置。核心交换机下挂的接入交换机和所有AP通过DHCP Option148方式注册上线。 数据规划。 使用工具自动规划AP的安装点位，确保AP的无线信号对酒店全覆盖。 规划网络信息，包括组网方案、设备款型、接口、无线业务等。 配置前准备。 （可选）手机下载并安装华为乾坤APP软件，用于网络验收。 现场安装设备，包括硬装、连线、上电，按组网图完成设备间连接以及两台核心交换机完成堆叠配置等。 第三方路由器作为出口网关，已接入运营商网络。 设备上线。 创建站点并添加设备：在华为乾坤云平台创建站点，将所有设备加入同一个站点，以便统一配置。 配置核心交换机接入Internet：通过第三方路由器接入运营商网络，采用命令行进行配置。 配置设备上线云平台： 核心交换机注册上线：采用命令行方式配置对接云平台。 核心交换机下挂设备注册上线：在核心交换机（作为DHCP Server）上配置下挂设备的地址池和DHCP Option148参数。接入交换机和AP采用DHCP Option148方式注册上线，也就是从DHCP Server上获取IP地址的同时也获取云管理平台的IP/URL地址和端口号，完成注册上线。 在华为乾坤云平台配置网络业务。 配置交换机业务。 配置核心交换机、接入交换机上行、下行接口，以及接口允许通过的VLAN等参数。 配置用户接入认证。 员工Wi-Fi采用802.1X认证。 访客Wi-Fi采用Portal+短信认证，配置华为乾坤云平台与短信平台对接，定制Portal推送页面、推送策略、认证规则等。 有线哑终端通过MAC认证：认证点在接入交换机，认证服务器是华为乾坤云平台。 结果验证：确认终端可以正常上网，可以在华为乾坤云平台监控各设备状态信息。 父主题： 仅核心交换机+接入交换机+云AP组网场景

WAN链路模板规划 不同的站点往往需要配置相同的网关类型、WAN链路条数和传输网络。通过定制链路模板可以将这些重复的配置信息模块化。 图1 总部WAN链路模板规划图 表1 WAN链路模板（总部站点） 参数 数据 模板名 Double_RR_internet_links 单/双网关 双网关 支持多子接口 OFF WAN链路 名称 Device1_internet Device2_internet 设备 Device1 Device2 端口 GE0/0/1 GE0/0/1 Overlay隧道 ON ON 传输网络 Internet Internet 角色 Active Active 互联链路 使用LAN侧二层物理口 OFF VLAN ID 4086～4094 设备1端口 GE0/0/5 GE0/0/6 设备2端口 GE0/0/5 GE0/0/6 图2 分支站点WAN链路模板规划图 表2 WAN链路模板（分支站点） 参数 数据 模板名 Single_CPE_Mix 单/双网关 单网关 支持多子接口 OFF WAN链路 名称 Internet_1 Internet_2 设备 Device1 Device1 端口 GE0/0/8 LTE0/0/0（LTE端口） Overlay隧道 ON ON 传输网络 Internet Internet 角色 Active Active 父主题： 开局部署数据规划