验收标准 客户通过官网单击验收，确认如下文档（必选）作为验收合格依据： 服务项 交付件（必选） 企业上云网络专家支持服务 《XX项目服务咨询报告》 企业网络部署规划设计服务 《XX项目企业网络部署规划设计方案》 线下线上业务融合规划设计服务 《XX项目线下线上业务融合规划设计方案》 IPv6改造规划设计服务 《XX项目IPv6改造规划设计方案》 可根据客户诉求，提供《XX项目计划》（可选）、《XX项目网络规划调研报告》（可选）和《XX项目网络现状分析》（可选）。

服务流程 流程 流程说明 完成标准 项目启动 召开项目开工会，明确项目角色分工，明确项目交付范围和交付规划，完成初期调研工作，了解客户基本信息等情况 召开项目启动会，双方确认《项目启动计划》 信息收集评估 通过工具、访谈、信息表等收集当前数据中心组网信息，并进行组网方案评估 根据客户诉求，华为云提交《组网现状分析》、《项目网络规划调研报告》，客户确认报告内容，双方达成一致 方案规划设计 进行组网方案设计 根据客户预期目标华为云提交《项目网络规划方案》，客户确认报告内容，双方达成一致 服务验收与移交 完成评审和验收移交 华为云提交《服务验收报告》客户签名确认，完成验收 如果客户仅购买云网络方案咨询服务，不涉及现网信息收集评估与方案规划设计，华为云提供网络方案咨询服务，提交《服务咨询报告》、《服务验收报告》，客户签名完成验收。

责任分工 企业上云网络规划设计服务责任分工如下（S：Support/支持方；R：Responsibility/责任方）。 表1 企业上云网络规划设计服务责任分工 编号 活动 华为职责 客户职责 1 业务现状调研 R S 2 需求范围澄清，交付范围澄清核对 R R 3 流程设计，根据客户需求、确认的交付范围进行流程文档设计输出 R S 4 规范制度，基于交付范围输出规范制度 R S 5 项目培训，基于项目交付内容的培训 R S 共同职责 双方商定并确认具体业务目标及范围。 完成合同签订。 客户职责 客户须指派一位项目负责人协助华为云顺利执行实施服务。此负责人应负责双方之协调及管理，负责审核、验收华为云服务。 客户必须提供数据中心组网规划相关的信息（包括但不限于IP规划、组网架构、业务网络规划等）； 在华为云提供服务的过程中，如客户提供的资料中含有第三方软件，客户须负责与第三方厂商交涉，协助华为云解决问题； 授权华为团队组网信息收集的相关的操作权限。 华为职责 华为需明确项目的负责人，因特殊情况华为人员变更，需要提前3个工作日知会客户，直至项目最终验收完成。 提供网络规划建议、业务改造网路规划建议，对方案中的技术部分进行可行性技术探讨。 得到用户相关授权后，仅限于组网信息收集中涉及的相关操作，不得超出限定范围，并制定出操作流程，依步骤执行。

响应示例 返回状态码为200：查询成功。 { "errcode": "0", "errmsg": "", "data": { "id": "242214f2-8a69-4b48-bf8c-1988e78cb9be", "siteId": "1c5e4554-aee4-4f62-ac3e-1460d6a6e3bf", "tenantId": "120196a60c6e4dde8a024a6f2039869b", "progress": 100, "deviceCreationResult": { "successList": [ { "id": "8015be0e-0e38-4dba-8378-bf7451d62393", "name": "CORE1", "esn": "2102355HUL2023021801", "type": "S16700-4", "deviceRole": "CORE", "description": "", "stackName": null, "stackSlotId": null, "stackPriority": null, "wacEsn": "", "wacName": null, "mlagName": "CORE", "mlagMode": "active-active", "mlagPriority": 150 }, { "id": "e83febb7-6894-4bc9-ad40-85c242a85d59", "name": "CORE2", "esn": "2102355HUN0123451108", "type": "S16700-4", "deviceRole": "CORE", "description": "", "stackName": null, "stackSlotId": null, "stackPriority": null, "wacEsn": "", "wacName": null, "mlagName": "CORE", "mlagMode": "active-active", "mlagPriority": null }, { "id": "6cb43fa7-c79c-4f77-baa7-8b13501365c9", "name": "AGG1_1", "esn": "102225213523", "type": "S6730-H24X6C-V2", "deviceRole": "AGG", "description": "", "stackName": null, "stackSlotId": null, "stackPriority": null, "wacEsn": "", "wacName": null, "mlagName": "AGG1", "mlagMode": "active-active", "mlagPriority": 150 }, { "id": "19556b05-96f4-4ce0-b613-e82d520524f5", "name": "AGG1_2", "esn": "102358054998", "type": "S6730-H48X6CZ-V2", "deviceRole": "AGG", "description": "", "stackName": null, "stackSlotId": null, "stackPriority": null, "wacEsn": "", "wacName": null, "mlagName": "AGG1", "mlagMode": "active-active", "mlagPriority": null } ], "failedList": [] }, "boardCreationResult": { "successList": [ { "devId": "8015be0e-0e38-4dba-8378-bf7451d62393", "deviceName": "CORE1", "slotId": "slot3", "slotType": "LSH7C36HX1E0" }, { "devId": "e83febb7-6894-4bc9-ad40-85c242a85d59", "deviceName": "CORE2", "slotId": "slot3", "slotType": "LSH7C36HX1E0" }, { "devId": "8015be0e-0e38-4dba-8378-bf7451d62393", "deviceName": "CORE1", "slotId": "slot2", "slotType": "LSH7L36QX1E0" }, { "devId": "e83febb7-6894-4bc9-ad40-85c242a85d59", "deviceName": "CORE2", "slotId": "slot2", "slotType": "LSH7L36QX1E0" }, { "devId": "8015be0e-0e38-4dba-8378-bf7451d62393", "deviceName": "CORE1", "slotId": "slot1", "slotType": "LSH7C18HX1E0" }, { "devId": "e83febb7-6894-4bc9-ad40-85c242a85d59", "deviceName": "CORE2", "slotId": "slot4", "slotType": "LSH7X48SX1E0" } ], "failedList": [] }, "linkCreationResult": { "successList": [ { "srcPortName": "100GE3/0/35", "srcDevName": "CORE1", "srcEthTrunk": "Eth-Trunk1", "srcEthPnpStartSwitchEnable": false, "dstPortName": "100GE3/0/34", "dstDevName": "CORE2", "dstEthTrunk": "Eth-Trunk1", "dstEthPnpStartSwitchEnable": false, "mlagLinkType": "peer-link", "mlagIpPoolName": "", "mlagId": null }, { "srcPortName": "100GE3/0/35", "srcDevName": "CORE1", "srcEthTrunk": "Eth-Trunk1", "srcEthPnpStartSwitchEnable": false, "dstPortName": "100GE3/0/35", "dstDevName": "CORE2", "dstEthTrunk": "Eth-Trunk1", "dstEthPnpStartSwitchEnable": false, "mlagLinkType": "peer-link", "mlagIpPoolName": "", "mlagId": null }, { "srcPortName": "100GE3/0/35", "srcDevName": "CORE1", "srcEthTrunk": "Eth-Trunk1", "srcEthPnpStartSwitchEnable": false, "dstPortName": "100GE3/0/34", "dstDevName": "CORE2", "dstEthTrunk": "Eth-Trunk1", "dstEthPnpStartSwitchEnable": false, "mlagLinkType": "peer-link", "mlagIpPoolName": "", "mlagId": null }, { "srcPortName": "100GE3/0/35", "srcDevName": "CORE1", "srcEthTrunk": "Eth-Trunk1", "srcEthPnpStartSwitchEnable": false, "dstPortName": "100GE3/0/35", "dstDevName": "CORE2", "dstEthTrunk": "Eth-Trunk1", "dstEthPnpStartSwitchEnable": false, "mlagLinkType": "peer-link", "mlagIpPoolName": "", "mlagId": null }, { "srcPortName": "40GE2/0/34", "srcDevName": "CORE1", "srcEthTrunk": "", "srcEthPnpStartSwitchEnable": true, "dstPortName": "40GE2/0/34", "dstDevName": "CORE2", "dstEthTrunk": "", "dstEthPnpStartSwitchEnable": false, "mlagLinkType": "dual-active-detect-link", "mlagIpPoolName": "1", "mlagId": null }, { "srcPortName": "10GE1/0/3", "srcDevName": "AGG1_1", "srcEthTrunk": "Eth-Trunk1", "srcEthPnpStartSwitchEnable": false, "dstPortName": "10GE1/0/1", "dstDevName": "AGG1_2", "dstEthTrunk": "Eth-Trunk1", "dstEthPnpStartSwitchEnable": false, "mlagLinkType": "peer-link", "mlagIpPoolName": "", "mlagId": null }, { "srcPortName": "10GE1/0/3", "srcDevName": "AGG1_1", "srcEthTrunk": "Eth-Trunk1", "srcEthPnpStartSwitchEnable": false, "dstPortName": "10GE1/0/2", "dstDevName": "AGG1_2", "dstEthTrunk": "Eth-Trunk1", "dstEthPnpStartSwitchEnable": false, "mlagLinkType": "peer-link", "mlagIpPoolName": "", "mlagId": null }, { "srcPortName": "10GE1/0/3", "srcDevName": "AGG1_1", "srcEthTrunk": "Eth-Trunk1", "srcEthPnpStartSwitchEnable": false, "dstPortName": "10GE1/0/3", "dstDevName": "AGG1_2", "dstEthTrunk": "Eth-Trunk1", "dstEthPnpStartSwitchEnable": false, "mlagLinkType": "peer-link", "mlagIpPoolName": "", "mlagId": null }, { "srcPortName": "10GE1/0/3", "srcDevName": "AGG1_1", "srcEthTrunk": "Eth-Trunk1", "srcEthPnpStartSwitchEnable": false, "dstPortName": "10GE1/0/1", "dstDevName": "AGG1_2", "dstEthTrunk": "Eth-Trunk1", "dstEthPnpStartSwitchEnable": false, "mlagLinkType": "peer-link", "mlagIpPoolName": "", "mlagId": null }, { "srcPortName": "10GE1/0/3", "srcDevName": "AGG1_1", "srcEthTrunk": "Eth-Trunk1", "srcEthPnpStartSwitchEnable": false, "dstPortName": "10GE1/0/2", "dstDevName": "AGG1_2", "dstEthTrunk": "Eth-Trunk1", "dstEthPnpStartSwitchEnable": false, "mlagLinkType": "peer-link", "mlagIpPoolName": "", "mlagId": null }, { "srcPortName": "10GE1/0/3", "srcDevName": "AGG1_1", "srcEthTrunk": "Eth-Trunk1", "srcEthPnpStartSwitchEnable": false, "dstPortName": "10GE1/0/3", "dstDevName": "AGG1_2", "dstEthTrunk": "Eth-Trunk1", "dstEthPnpStartSwitchEnable": false, "mlagLinkType": "peer-link", "mlagIpPoolName": "", "mlagId": null }, { "srcPortName": "10GE1/0/3", "srcDevName": "AGG1_1", "srcEthTrunk": "Eth-Trunk1", "srcEthPnpStartSwitchEnable": false, "dstPortName": "10GE1/0/1", "dstDevName": "AGG1_2", "dstEthTrunk": "Eth-Trunk1", "dstEthPnpStartSwitchEnable": false, "mlagLinkType": "peer-link", "mlagIpPoolName": "", "mlagId": null }, { "srcPortName": "10GE1/0/3", "srcDevName": "AGG1_1", "srcEthTrunk": "Eth-Trunk1", "srcEthPnpStartSwitchEnable": false, "dstPortName": "10GE1/0/2", "dstDevName": "AGG1_2", "dstEthTrunk": "Eth-Trunk1", "dstEthPnpStartSwitchEnable": false, "mlagLinkType": "peer-link", "mlagIpPoolName": "", "mlagId": null }, { "srcPortName": "10GE1/0/3", "srcDevName": "AGG1_1", "srcEthTrunk": "Eth-Trunk1", "srcEthPnpStartSwitchEnable": false, "dstPortName": "10GE1/0/3", "dstDevName": "AGG1_2", "dstEthTrunk": "Eth-Trunk1", "dstEthPnpStartSwitchEnable": false, "mlagLinkType": "peer-link", "mlagIpPoolName": "", "mlagId": null }, { "srcPortName": "10GE1/0/4", "srcDevName": "AGG1_1", "srcEthTrunk": "", "srcEthPnpStartSwitchEnable": true, "dstPortName": "10GE1/0/4", "dstDevName": "AGG1_2", "dstEthTrunk": "", "dstEthPnpStartSwitchEnable": false, "mlagLinkType": "dual-active-detect-link", "mlagIpPoolName": "1", "mlagId": null } ], "failedList": [] }, "stackCreationResult": { "successList": [], "failedList": [] }, "mlagGroupCreationResult": { "successList": [ { "id": "1218fc42-7a6b-451a-a042-cfda7bab81f3", "name": "CORE", "groupId": 1, "mode": null, "mlagMember": [ { "id": "8015be0e-0e38-4dba-8378-bf7451d62393", "name": "CORE1", "esn": "2102355HUL2023021801", "type": "S16700-4", "deviceRole": "CORE", "description": "", "stackName": null, "stackSlotId": null, "stackPriority": null, "wacEsn": "", "wacName": null, "mlagName": "CORE", "mlagMode": "active-active", "mlagPriority": 150 }, { "id": "e83febb7-6894-4bc9-ad40-85c242a85d59", "name": "CORE2", "esn": "2102355HUN0123451108", "type": "S16700-4", "deviceRole": "CORE", "description": "", "stackName": null, "stackSlotId": null, "stackPriority": null, "wacEsn": "", "wacName": null, "mlagName": "CORE", "mlagMode": "active-active", "mlagPriority": null } ] }, { "id": "d12eed03-e7fd-4e0e-b4bb-113da7851514", "name": "AGG1", "groupId": 1, "mode": null, "mlagMember": [ { "id": "6cb43fa7-c79c-4f77-baa7-8b13501365c9", "name": "AGG1_1", "esn": "102225213523", "type": "S6730-H24X6C-V2", "deviceRole": "AGG", "description": "", "stackName": null, "stackSlotId": null, "stackPriority": null, "wacEsn": "", "wacName": null, "mlagName": "AGG1", "mlagMode": "active-active", "mlagPriority": 150 }, { "id": "19556b05-96f4-4ce0-b613-e82d520524f5", "name": "AGG1_2", "esn": "102358054998", "type": "S6730-H48X6CZ-V2", "deviceRole": "AGG", "description": "", "stackName": null, "stackSlotId": null, "stackPriority": null, "wacEsn": "", "wacName": null, "mlagName": "AGG1", "mlagMode": "active-active", "mlagPriority": null } ] } ], "failedList": [] } } } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,16 Feb 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,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

响应参数 返回状态码为200：查询成功。 表2 TopoPlanQueryResDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~64个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "参数非法" data REFERENCE 详细请参见表3。 返回数据 - 表3 TopoPlanQueryModelDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id uuid 36个字符。 - 网络规划主键ID。 "bc1846c5-2eff-6d4d-2a2d-23dff3d12344" siteId uuid 36个字符。 - 站点ID。 "acc846c5-2fff-694d-2b2d-12dff3d1231a" tenantId string 32个字符。 - 租户ID。 "fbb684c80d37496fbafa4b06d5151e2e" progress integer [0-100] - 网络规划创建进度。取值范围0-100，100表示资源创建完成。 0 deviceCreationResult REFERENCE 详细请参见表4。 - - boardCreationResult REFERENCE 详细请参见表9。 - - linkCreationResult REFERENCE 详细请参见表12。 - - stackCreationResult REFERENCE 详细请参见表15。 - - mlagGroupCreationResult REFERENCE 详细请参见表18。 - - 表4 DeviceCreationResult对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 successList ARRAY_REFERENCE 0-500个列表项，详细请参见表5。 创建设备成功列表 - failedList ARRAY_REFERENCE 0-500个列表项，详细请参见表6。 创建设备失败列表 - 表5 TopoPlanDeviceDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 order int32 [0-500] - 设备序号 0 id uuid 36个字符。 - 设备id，UUID格式。 "813a76d4-6eec-4264-ae45-a6f261482b60" name string 1~64个字符。 - 设备名称。最多允许输入64个字符。设备名称不能重复。 "device1" esn string 0~40个字符。 - 设备ESN。10~40个字符，由英文字母和数字组成。如果“ESN”为空，则“设备名称”和“设备型号”为必填字段。如果“ESN”不为空，也推荐填写“设备型号”，否则可能添加失败。 "AA980106121234567893" type string 0~32个字符。 - 设备型号。 "S12704" deviceRole string 0~32个字符。满足正则表达^(CORE|Gateway|Gateway\+CORE|Gateway\+vRR|Firewall|ACC|AGG|WAC|AP|)$。 ACC 设备角色，取值：CORE|Gateway|Gateway+CORE|Gateway+vRR|Firewall|ACC|AGG|WAC|AP "ACC" description string 0~255个字符。 - 描述 "ACC1" stackName string 0~64个字符。 - 堆叠名称。（堆叠设备必填，非堆叠设备无需填写），不能包含“？”'、"?"或制表符TAB "ACC1" stackSlotId int32 [0-9] - （堆叠设备必填，非堆叠设备无需填写）盒式设备范围为0~9，框式设备范围为1~2，并且同一堆叠内的堆叠编号不重复。 1 stackPriority int32 [1-255] 100 堆叠优先级。（非必填）请输入数字，范围为1~255。如果堆叠设备此字段不填写，默认为100 2 wacEsn string 0~40个字符。 - WAC设备ESN。（非必填）由英文字母和数字组成。将Fit Ap设备与所填写的WAC ESN关联。 "AA980106121234567893" wacName string 0~64个字符。 - WAC设备名称。 "device1" mlagName string 0~64个字符。 - M-LAG组名称。(非必填) 1、相同MLAG组名称的设备,自动组成M-LAG设备组 2、DFS Group ID默认为1, 随机生成认证密码, 优先级随机取一台为150 3、成员口为双活模式。最多允许输入64个字符。 "mlag1" mlagMode string 0~20个字符。满足正则表达^(active-active|active-standby|)$。 - M-LAG模式,active-active / active-standby。 "active-active" mlagPriority int32 [1-255] - M-LAG优先级。 2 表6 DeviceCreationFailDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode REFERENCE 详细请参见表7。 错误码 - errmsg REFERENCE 详细请参见表8。 错误描述 - topoPlanDeviceDto REFERENCE 详细请参见表5。 设备创建失败信息 - 表7 Errcode对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 Errcode string 0~36个字符。 - 错误码 - 表8 Errmsg对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 Errmsg string 0~256个字符。 - 错误描述 - 表9 BoardCreationResult对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 successList ARRAY_REFERENCE 0-500个列表项，详细请参见表10。 创建单板成功列表 - failedList ARRAY_REFERENCE 0-500个列表项，详细请参见表11。 创建单板失败列表 - 表10 TopoPlanBoardDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 devId string 36个字符。 - 设备id，UUID格式。 "813a76d4-6eec-4264-ae45-a6f261482b60" deviceName string 1~64个字符。 - 设备名称。（必填）堆叠设备支持填写设备名称或堆叠名称。 "21500829352SH1904172" slotId string 0~8个字符。 - 堆叠编号，v5盒式设备为0-8，pnf盒式设备为1-9,框式设备为1-2。 "slot1/4" slotType string 1~12个字符。 - 单板型号。 "LSG7SRUEX500" 表11 BoardCreationFailDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode REFERENCE 详细请参见表7。 错误码 - errmsg REFERENCE 详细请参见表8。 错误描述 - topoPlanBoardDto REFERENCE 详细请参见表10。 创建单板失败信息 - 表12 LinkCreationResult对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 successList ARRAY_REFERENCE 0-2000个列表项，详细请参见表13。 创建链路成功列表 - failedList ARRAY_REFERENCE 0-2000个列表项，详细请参见表14。 创建链路失败列表 - 表13 TopoPlanLinkDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 order int32 [0-2000] - 设备链路序号 0 srcPortName string 1~30个字符。 - 上游设备物理端口号。设备真实存在的物理端口 "GigabitEthernet0/0/1" srcDevName string 1~64个字符。 - 上游设备名称。堆叠设备支持填写设备名称或堆叠名称。 "device1" srcEthTrunk string 0~14个字符。 - 上游设备端Eth-Trunk名称。（Eth-Trunk链路必填）Eth-Trunk1~1023之间的整数。当前接口是下行接口，除M-LAG Peer-Link与双主检测链路外，均默认开启Eth-Trunk自协商（单设备的Eth-Trunk不可重复使用） "Eth-Trunk1" srcEthPnpStartSwitchEnable boolean true false false 源EthTrunk PNP启动开关使能。 false dstPortName string 1~30个字符。 - 下游设备物理端口号。设备真实存在的物理端口 "GigabitEthernet1/0/1" dstDevName string 1~64个字符。 - 下游设备名称。（必填）最多允许输入64个字符。堆叠设备支持填写设备名称或堆叠名称。 "device2" dstEthTrunk string 0~14个字符。 - 下游设备端Eth-Trunk名称。（Eth-Trunk链路必填）Eth-Trunk1~1023之间的整数（单设备的Eth-Trunk不可重复使用） "Eth-Trunk2" dstEthPnpStartSwitchEnable boolean true false false 目的EthTrunk PNP启动开关使能。 false mlagLinkType string 0~24个字符。满足正则表达^(peer-link|member-link|dual-active-detect-link|)$。 - M-LAG链路类型。peer-link|member-link|dual-active-detect-link "peer-link" mlagIpPoolName string 0~32个字符。 - 双主检测链路IP资源池。(M-LAG链路类型为双主检测链路时必填)允许输入1~32位英文字母、数字或特殊符号(问号和空格除外) "pool1" mlagId string 0~12个字符。 - 上、下游端口M-LAG ID。(非必填)双归接入端口跨设备定义为相同的ID，M-LAG ID取值范围1-2048。上、下游值需用","分隔，同时指定。上下游端口M-LAG ID输入示例 "1,2"， 指定上游端口M-LAG ID示例 "1" "1,2" 表14 LinkCreationFailDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode REFERENCE 详细请参见表7。 错误码 - errmsg REFERENCE 详细请参见表8。 错误描述 - topoPlanLinkDto REFERENCE 详细请参见表13。 创建链路失败信息 - 表15 StackCreationResult对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 successList ARRAY_REFERENCE 0-500个列表项，详细请参见表16。 创建堆叠成功列表 - failedList ARRAY_REFERENCE 0-500个列表项，详细请参见表17。 创建堆叠失败列表 - 表16 TopoPlanStackDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id uuid 36个字符。 - 堆叠设备id，UUID格式。 "813a76d4-6eec-4264-ae45-a6f261482b60" name string 1~64个字符。 - 堆叠设备名称。 "stack1" stackRole string 0~32个字符。 - 堆叠角色。 "CORE" stackMember ARRAY_REFERENCE 1-9个列表项，详细请参见表5。 堆叠成员信息。 - 表17 StackCreationFailDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode REFERENCE 详细请参见表7。 错误码 - errmsg REFERENCE 详细请参见表8。 错误描述 - topoPlanStackDto REFERENCE 详细请参见表16。 创建堆叠失败信息 - 表18 MlagGroupCreationResult对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 successList ARRAY_REFERENCE 0-500个列表项，详细请参见表19。 创建M-Lag组成功列表 - failedList ARRAY_REFERENCE 0-500个列表项，详细请参见表20。 创建M-Lag组失败列表 - 表19 TopoPlanMlagGroupDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string 36个字符。 - M-Lag组id。 "18f461fa-4f1b-3e2b-90e4-f3d29d0dcf9b" name string 0~64个字符。 - M-Lag组名称。 "mlag1" groupId int32 [1-2048] - M-LAG ID 1 mode string 0~20个字符。满足正则表达^(active-active|active-standby|)$。 - M-LAG模式,active-active / active-standby。 "active-active" mlagMember ARRAY_REFERENCE 0-6个列表项，详细请参见表5。 M-LAG成员 - 表20 TopoPlanMlagGroupFailDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode REFERENCE 详细请参见表7。 错误码 - errmsg REFERENCE 详细请参见表8。 错误描述 - topoPlanMlagGroupDto REFERENCE 详细请参见表19。 创建M-LAG失败信息 - 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。

请求示例 HTTP的示例 GET /v1/networkservice/sites/f3a4f7d3-2f1e-4b2a-9f4c-1c2d2a4e5b6c/topo-plans/bc1846c5-2eff-6d4d-2a2d-23dff3d12344 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 /v1/networkservice/sites/{siteId}/topo-plans/{id} 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteId 是 uuid 36个字符。 - 站点id "f3a4f7d3-2f1e-4b2a-9f4c-1c2d2a4e5b6c" id 是 uuid 36个字符。 - 网络规划创建时的id "bc1846c5-2eff-6d4d-2a2d-23dff3d12344"

请求示例 HTTP的示例 { "deviceList": [ { "esn": "2102355HUL2023021801", "name": "CORE1", "type": "S16700-4", "description": "", "stackName": "", "stackSlotId": "", "stackPriority": "", "wacEsn": "", "mlagName": "CORE", "deviceRole": "CORE" }, { "esn": "2102355HUN0123451108", "name": "CORE2", "type": "S16700-4", "description": "", "stackName": "", "stackSlotId": "", "stackPriority": "", "wacEsn": "", "mlagName": "CORE", "deviceRole": "CORE" }, { "esn": "102225213523", "name": "AGG1_1", "type": "S6730-H24X6C-V2", "description": "", "stackName": "", "stackSlotId": "", "stackPriority": "", "wacEsn": "", "mlagName": "AGG1", "deviceRole": "AGG" }, { "esn": "102358054998", "name": "AGG1_2", "type": "S6730-H48X6CZ-V2", "description": "", "stackName": "", "stackSlotId": "", "stackPriority": "", "wacEsn": "", "mlagName": "AGG1", "deviceRole": "AGG" } ], "slotList": [ { "deviceName": "CORE1", "slotId": "slot3", "slotType": "LSH7C36HX1E0" }, { "deviceName": "CORE2", "slotId": "slot3", "slotType": "LSH7C36HX1E0" }, { "deviceName": "CORE1", "slotId": "slot2", "slotType": "LSH7L36QX1E0" }, { "deviceName": "CORE2", "slotId": "slot2", "slotType": "LSH7L36QX1E0" }, { "deviceName": "CORE1", "slotId": "slot1", "slotType": "LSH7C18HX1E0" }, { "deviceName": "CORE2", "slotId": "slot4", "slotType": "LSH7X48SX1E0" } ], "linkList": [ { "srcPortName": "100GE3/0/34", "srcDevName": "CORE1", "srcEthTrunk": "Eth-Trunk1", "dstPortName": "100GE3/0/34", "dstDevName": "CORE2", "dstEthTrunk": "Eth-Trunk1", "mlagLinkType": "peer-link", "mlagId": "", "mlagIpPoolName": "" }, { "srcPortName": "100GE3/0/35", "srcDevName": "CORE1", "srcEthTrunk": "Eth-Trunk1", "dstPortName": "100GE3/0/35", "dstDevName": "CORE2", "dstEthTrunk": "Eth-Trunk1", "mlagLinkType": "peer-link", "mlagId": "", "mlagIpPoolName": "" }, { "srcPortName": "40GE2/0/34", "srcDevName": "CORE1", "srcEthTrunk": "", "dstPortName": "40GE2/0/34", "dstDevName": "CORE2", "dstEthTrunk": "", "mlagLinkType": "dual-active-detect-link", "mlagId": "", "mlagIpPoolName": "ipPoolName" }, { "srcPortName": "10GE1/0/1", "srcDevName": "AGG1_1", "srcEthTrunk": "Eth-Trunk1", "dstPortName": "10GE1/0/1", "dstDevName": "AGG1_2", "dstEthTrunk": "Eth-Trunk1", "mlagLinkType": "peer-link", "mlagId": "", "mlagIpPoolName": "" }, { "srcPortName": "10GE1/0/2", "srcDevName": "AGG1_1", "srcEthTrunk": "Eth-Trunk1", "dstPortName": "10GE1/0/2", "dstDevName": "AGG1_2", "dstEthTrunk": "Eth-Trunk1", "mlagLinkType": "peer-link", "mlagId": "", "mlagIpPoolName": "" }, { "srcPortName": "10GE1/0/3", "srcDevName": "AGG1_1", "srcEthTrunk": "Eth-Trunk1", "dstPortName": "10GE1/0/3", "dstDevName": "AGG1_2", "dstEthTrunk": "Eth-Trunk1", "mlagLinkType": "peer-link", "mlagId": "", "mlagIpPoolName": "" }, { "srcPortName": "10GE1/0/4", "srcDevName": "AGG1_1", "srcEthTrunk": "", "dstPortName": "10GE1/0/4", "dstDevName": "AGG1_2", "dstEthTrunk": "", "mlagLinkType": "dual-active-detect-link", "mlagId": "", "mlagIpPoolName": "ipPoolName" } ] }

响应参数 返回状态码为201：操作成功。 表7 TopoPlanCreationResDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~64个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "参数非法" data REFERENCE 详细请参见表8。 返回数据 - 表8 TopoPlanCreationModelDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id uuid 36个字符。 - 网络规划主键ID。 "bc1846c5-2eff-6d4d-2a2d-23dff3d12344" siteId uuid 36个字符。 - 站点ID。 "acc846c5-2fff-694d-2b2d-12dff3d1231a" tenantId string 32个字符。 - 租户ID。 "fbb684c80d37496fbafa4b06d5151e2e" 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。

响应示例 返回状态码为201：操作成功。 { "errcode": "0", "errmsg": "", "data": { "id": "48f1f2c7-f01c-4fc6-87fd-47607897b50e", "siteId": "e42ee2d7-d083-4faa-bff0-1970b3c4eb08", "tenantId": "df8efdaebc9f4b019667b62775dd2c3b" } } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,16 Feb 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,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

请求参数 表2 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 input 是 REFERENCE 详细请参见表3。 网络规划创建接口入参 - 表3 CreateTopoPlanDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 deviceList 否 ARRAY_REFERENCE 1-500个列表项，详细请参见表4。 网络规划设备信息 - slotList 否 ARRAY_REFERENCE 0-500个列表项，详细请参见表5。 网络规划单板信息 - linkList 否 ARRAY_REFERENCE 0-2000个列表项，详细请参见表6。 网络规划链路信息 - 表4 TopoPlanDeviceDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 order 否 int32 [0-500] - 设备序号 0 id 否 uuid 36个字符。 - 设备id，UUID格式。 "813a76d4-6eec-4264-ae45-a6f261482b60" name 是 string 1~64个字符。 - 设备名称。最多允许输入64个字符。设备名称不能重复。 "device1" esn 否 string 0~40个字符。 - 设备ESN。10~40个字符，由英文字母和数字组成。如果“ESN”为空，则“设备名称”和“设备型号”为必填字段。如果“ESN”不为空，也推荐填写“设备型号”，否则可能添加失败。 "AA980106121234567893" type 否 string 0~32个字符。 - 设备型号。 "S12704" deviceRole 否 string 0~32个字符。满足正则表达^(CORE|Gateway|Gateway\+CORE|Gateway\+vRR|Firewall|ACC|AGG|WAC|AP|)$。 ACC 设备角色，取值：CORE|Gateway|Gateway+CORE|Gateway+vRR|Firewall|ACC|AGG|WAC|AP "ACC" description 否 string 0~255个字符。 - 描述 "ACC1" stackName 否 string 0~64个字符。 - 堆叠名称。（堆叠设备必填，非堆叠设备无需填写），不能包含“？”'、"?"或制表符TAB "ACC1" stackSlotId 否 int32 [0-9] - （堆叠设备必填，非堆叠设备无需填写）盒式设备范围为0~9，框式设备范围为1~2，并且同一堆叠内的堆叠编号不重复。 1 stackPriority 否 int32 [1-255] 100 堆叠优先级。（非必填）请输入数字，范围为1~255。如果堆叠设备此字段不填写，默认为100 2 wacEsn 否 string 0~40个字符。 - WAC设备ESN。（非必填）由英文字母和数字组成。将Fit Ap设备与所填写的WAC ESN关联。 "AA980106121234567893" wacName 否 string 0~64个字符。 - WAC设备名称。 "device1" mlagName 否 string 0~64个字符。 - M-LAG组名称。(非必填) 1、相同MLAG组名称的设备,自动组成M-LAG设备组 2、DFS Group ID默认为1, 随机生成认证密码, 优先级随机取一台为150 3、成员口为双活模式。最多允许输入64个字符。 "mlag1" mlagMode 否 string 0~20个字符。满足正则表达^(active-active|active-standby|)$。 - M-LAG模式,active-active / active-standby。 "active-active" mlagPriority 否 int32 [1-255] - M-LAG优先级。 2 表5 TopoPlanBoardDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 devId 否 string 36个字符。 - 设备id，UUID格式。 "813a76d4-6eec-4264-ae45-a6f261482b60" deviceName 是 string 1~64个字符。 - 设备名称。（必填）堆叠设备支持填写设备名称或堆叠名称。 "21500829352SH1904172" slotId 是 string 0~8个字符。 - 堆叠编号，v5盒式设备为0-8，pnf盒式设备为1-9,框式设备为1-2。 "slot1/4" slotType 是 string 1~12个字符。 - 单板型号。 "LSG7SRUEX500" 表6 TopoPlanLinkDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 order 否 int32 [0-2000] - 设备链路序号 0 srcPortName 是 string 1~30个字符。 - 上游设备物理端口号。设备真实存在的物理端口 "GigabitEthernet0/0/1" srcDevName 是 string 1~64个字符。 - 上游设备名称。堆叠设备支持填写设备名称或堆叠名称。 "device1" srcEthTrunk 否 string 0~14个字符。 - 上游设备端Eth-Trunk名称。（Eth-Trunk链路必填）Eth-Trunk1~1023之间的整数。当前接口是下行接口，除M-LAG Peer-Link与双主检测链路外，均默认开启Eth-Trunk自协商（单设备的Eth-Trunk不可重复使用） "Eth-Trunk1" srcEthPnpStartSwitchEnable 否 boolean true false false 源EthTrunk PNP启动开关使能。 false dstPortName 是 string 1~30个字符。 - 下游设备物理端口号。设备真实存在的物理端口 "GigabitEthernet1/0/1" dstDevName 是 string 1~64个字符。 - 下游设备名称。（必填）最多允许输入64个字符。堆叠设备支持填写设备名称或堆叠名称。 "device2" dstEthTrunk 否 string 0~14个字符。 - 下游设备端Eth-Trunk名称。（Eth-Trunk链路必填）Eth-Trunk1~1023之间的整数（单设备的Eth-Trunk不可重复使用） "Eth-Trunk2" dstEthPnpStartSwitchEnable 否 boolean true false false 目的EthTrunk PNP启动开关使能。 false mlagLinkType 否 string 0~24个字符。满足正则表达^(peer-link|member-link|dual-active-detect-link|)$。 - M-LAG链路类型。peer-link|member-link|dual-active-detect-link "peer-link" mlagIpPoolName 否 string 0~32个字符。 - 双主检测链路IP资源池。(M-LAG链路类型为双主检测链路时必填)允许输入1~32位英文字母、数字或特殊符号(问号和空格除外) "pool1" mlagId 否 string 0~12个字符。 - 上、下游端口M-LAG ID。(非必填)双归接入端口跨设备定义为相同的ID，M-LAG ID取值范围1-2048。上、下游值需用","分隔，同时指定。上下游端口M-LAG ID输入示例 "1,2"， 指定上游端口M-LAG ID示例 "1" "1,2"

响应参数 返回状态码为200：删除成功。 表2 DeleteTopoPlanOutputDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~64个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "参数非法" id string 36个字符。 - 网络规划创建时的id。 "bc1846c5-2eff-6d4d-2a2d-23dff3d12344" 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。

响应示例 返回状态码为200：删除成功。 { "errcode": "0", "errmsg": "", "id": "bc1846c5-2eff-6d4d-2a2d-23dff3d12344" } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

URI /v1/networkservice/sites/{siteId}/topo-plans/{id} 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteId 是 uuid 36个字符。 - 站点id "f3a4f7d3-2f1e-4b2a-9f4c-1c2d2a4e5b6c" id 是 string 36个字符。 - 网络规划创建时的id。 "bc1846c5-2eff-6d4d-2a2d-23dff3d12344"

请求示例 HTTP的示例 DELETE /v1/networkservice/sites/f3a4f7d3-2f1e-4b2a-9f4c-1c2d2a4e5b6c/topo-plans/bc1846c5-2eff-6d4d-2a2d-23dff3d12344 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