华为云用户手册

请求参数 表2 header参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 restconf-transaction-id 是 string - - 事务ID。 "00000000-0000-0000-0000-000000000000" 表3 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 huawei-nce-e-queue-template:user-queue-profile 是 REFERENCE 详细请参见表4。 QoS模板。 -

响应示例 返回状态码为200：请求成功，返回体参考QueryMirrorPortResponse。 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" : 100, "data" : [ { "portId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e", "portName" : "GE0/0/1", "inboundEnable" : true, "outboundEnable" : true } ] } 返回状态码为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/lanwan/mirror/{observeId}/mirrorport-query 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 observeId 是 string 36个字符。 - 观察口标识。uuid格式。与查询观察端口返回体中portId一致。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e"

请求示例 HTTP的示例 POST /controller/campus/v1/lanwan/mirror/fbb684c8-0d37-496f-bafa-4b06d5151e2e/mirrorport-query 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 { "siteId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e", "keyword" : "GE0/0/1", "pageSize" : 10, "pageIndex" : 10 }

响应参数 返回状态码为200：请求成功，返回体参考QueryMirrorPortResponse。 表4 QueryMirrorPortResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~64个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "" totalRecords int32 [0-1000000] - 总记录数。 100 data ARRAY_REFERENCE 0-1000个列表项，详细请参见表5。 查询到的镜像口集合。 - 表5 MirrorPortInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 portId string 36个字符。 - 端口标识。uuid格式。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e" portName string 0~128个字符。 - 镜像端口名称。 "GE0/0/1" inboundEnable boolean true false - 入方向镜像。 true outboundEnable boolean true false - 出方向镜像。 true 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。

请求参数 表2 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 QueryPortRequest 是 REFERENCE 详细请参见表3。 查询镜像口请求体。 - 表3 QueryPortRequest对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteId 否 string 36个字符。 - 站点标识。uuid格式。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e" keyword 否 string 0~128个字符。 - 筛选条件。 "GE0/0/1" pageSize 是 int32 [0-1000] - 当前页面显示数据条数。 10 pageIndex 是 int32 [0-1000] - 页数。 10

请求示例 HTTP的示例 POST /controller/campus/v3/networkconfig/customized/fbde1c5d-5b94-49e3-a912-48641015e45c/apssid 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" : "Huawei-Guest", "pki" : "default", "tags" : [ { "name" : "testApTag" } ], "strategyId" : "6e930b21-a107-45a9-96a2-f1443ca82f39", "enable" : true, "connectionMode" : "bridge", "vlans" : [ { "priority" : 0, "vlanId" : 10, "vlanDesc" : "work", "tags" : [ { "name" : "testApTag" } ] } ], "vlanId" : 10, "vlanDesc" : "work", "vlanMode" : "vlanId", "vlanPoolId" : "1e930b21-a307-45a9-96a2-f1443ca84f39", "vlanPoolName" : "vlanPool", "hidedEnable" : false, "autoOffTrackLinkEnable" : false, "arpCheckEnable" : true, "ipCheckEnable" : true, "dhcpStrictEnable" : false, "dhcpv6SlaacStrictEnable" : 0, "mdnsSnoopingEnable" : false, "dnsSnoopingEnable" : false, "gameSpeedUpEnable" : false, "relativeRadios" : 3, "relativeOnlyTwoRadios" : 3, "dtimInterval" : 1, "advertiseApNameSwitch" : true, "frequencyNavigation" : true, "maxUserNumber" : 10, "userSeparation" : false, "separationOption" : "disable", "userL2LanIsolate" : false, "staNetworkDetect" : true, "muMiMo" : true, "associationTimeout" : 5, "erSuSwitch" : true, "userFlowSyslogEnable" : false, "multiLinkOper" : false, "lay3RoamSwitch" : true, "suExtendedRangeSwitch" : false, "muRtsSwitch" : false, "muRtsThreshold" : 2347, "forbiddenOldTerminal" : false, "reachMaxSta" : 1, "igmpSnooping" : false, "multicast2Unicast" : "disable", "bcmcDenyAll" : false, "bonjourTransparent" : false, "powerSave" : false, "beacon2gRate" : "1Mbps", "beacon5gRate" : "6Mbps", "beacon6gRate" : "6Mbps", "sipPort" : 5060, "timeTemplateId" : "b90f8190-e12f-4323-95f3-4018309209c4", "timeTemplateName" : "全天", "seaSwitch" : false, "overDsPrivate" : "disable", "blackAndWhite" : { "bindingType" : 2, "terminalMacList" : [ "XX:XX:XX:XX:XX:XX" ], "terminalOUIList" : [ "02:02:01" ] }, "ssidAuth" : { "mode" : "ppsk", "oweTransitionMode" : true, "transitionOpenSsid" : "de5813f8ff1e41f5ba9c324da70b49ed", "pskEncryptType" : "wpa2", "wepType" : "WEP40", "wepDefaultKey" : 0, "enableMacAuth" : false, "saeEncryptType" : "", "saeSecurityKey" : "", "pskSaeEncryptType" : "", "pskSaeSecurityKey" : "", "securityKey" : "", "securityKeyType" : "AES", "dot1xEncryptType" : "", "dot1xQuietPeriod" : 60, "dot1xQuietTimes" : 10, "portal" : { "mode" : "portalDisable", "pushProtocol" : "https", "freeAuthEnable" : true, "authExpireUnit" : "day", "authExpire" : 10, "escapeStrategy" : 2, "escapeProfileName" : "escapeStrategy1", "escapeProfileId" : "5871926c-2a5e-4340-a931-19ce019a231c", "freeAclTmplId" : "b90f8190-e12f-4323-95f3-4018309209c4", "freeAclTmplName" : "free-rule", "controllerPortalType" : "haca", "masterPortalTmplId" : "0b6d8077-947a-41d0-a539-c8a02c5fe6dc", "masterPortalTmplName" : "", "bakPortalEnable" : false, "bakPortalTmplId" : "0b6d8077-947a-41d0-a539-c8a02c5fe6dc", "bakPortalTmplName" : "", "authRedirectUrlCarryEnable" : false, "radiusEnable" : false, "radiusTmplId" : "0b6d8077-947a-41d0-a539-c8a02c5fe6dc", "radiusTmplName" : "", "fastPushEnable" : true, "portalPageId" : "0b6d8077-947a-41d0-a539-c8a02c5fe6dc", "wechatUrlAuthEnable" : false, "weComAuthEnable" : false, "dingTalkEnable" : false, "normalEnable" : false, "registerEnable" : false, "registerExpire" : 2, "registerExpireUnit" : "hour", "userRegisterMaxAccessNumber" : 0, "userGroupId" : "0b6d8077-947a-41d0-a539-c8a02c5fe6dc", "smsAuthEnable" : false, "smsPasswordExpire" : 5, "smsPasswordExpireUnit" : "minute", "smsUserRegisterEnable" : false, "smsUserExpire" : 2, "smsUserExpireUnit" : "hour", "smsUserMaxAccessNumber" : 0, "smsUserGroupId" : "0b6d8077-947a-41d0-a539-c8a02c5fe6dc", "emailAuthEnable" : false, "passCodeEnable" : false, "oneKeyAuthEnable" : false, "anonymousEnable" : false, "socialMediaEnable" : false, "twitterEnable" : false, "sinaEnable" : false, "qqEnable" : false, "qrCodeAuthEnable" : false, "qrCodeRegisterEnable" : false, "googleEnable" : false, "accountingEnable" : false, "accountingExpire" : 15, "interconnectionMode" : "API", "userNameKey" : "用户", "passwordKey" : "", "urlMatchMode" : 0, "successUrlKey" : "", "authFailedUrlKey" : "", "logoutSuccessUrlKey" : "", "logoutFailedUrlKey" : "", "logoutUrlKey" : "", "radiusModelId" : "0b6d8077-947a-41d0-a539-c8a02c5fe6dc" }, "radius" : { "radiusTmplId" : "", "radiusTmplName" : "", "staticEnable" : "", "iconnectAccessEnable" : "", "autoReauthenTime" : "", "hacaEnable" : "" }, "macAutoBinding" : true, "macAuthMethod" : "", "escapeStrategy" : "noAuth", "escapeProfileName" : "escapeStrategy1", "escapeProfileId" : "5871926c-2a5e-4340-a931-19ce019a231c", "haca" : { "authComponentId" : "00000000-0000-0000-0000-000000000000", "authComponentIp" : "10.20.0.0", "bakAuthComponentId" : "00000000-0000-0000-0000-000000000000", "bakAuthComponentIp" : "10.20.0.0" } }, "vapBackupConfig" : { "vapBackupEnable" : false, "radiusBackupTmplId" : "cf23f275-01e6-4301-890e-407e1d78c53e", "rejectNewAccess" : false }, "ssidPolicy" : { "securityPolicy" : { "highReliableSliceAclTplId" : "b90f8190-e12f-4323-95f3-4018309209c4", "highReliableSliceAclTplName" : "test-slice-acl", "highReliableSliceAclTplIdIpv6" : "b90f8190-e12f-4323-95f3-4018309209c4", "highReliableSliceAclTplNameIpv6" : "test-slice-acl", "securityAclTmplId" : "b90f8190-e12f-4323-95f3-4018309209c4", "securityAclTmplName" : "test-security-acl", "securityIPv6AclTmplId" : "b90f8190-e12f-4323-95f3-4018309209c4", "securityIPv6AclTmplName" : "test-security-acl", "tunnelAclTmplId" : "b90f8190-e12f-4323-95f3-4018309209c5", "tunnelAclTmplName" : "test-tunnel-acl", "ipsecAclTmplId" : "b90f8190-e12f-4323-95f3-4018309209c5", "ipsecAclTmplName" : "test-ipsec-acl", "tcpAdjustMss" : 1380, "appTrafficAcls" : { "appTrafficAclList" : [ { "direction" : "inbound", "index" : 0, "dscp" : 1, "appTrafficAclTplId" : "b90f8190-e12f-4323-95f3-4018309209c5", "appTrafficAclName" : "test-tunnel-acl" } ] }, "urlFilter" : { "enable" : true, "mode" : 1, "urls" : [ "" ], "hostNames" : [ "" ] }, "appsPolicys" : { "siteSaList" : [ { "appId" : 1, "type" : "app", "appType" : 1, "appName" : "test_name", "action" : "permit", "dscp" : 1, "car" : 1000 } ] } }, "ssidRateLimit" : { "upEnable" : true, "upLimit" : "50.0", "downEnable" : true, "downLimit" : "50.0" }, "terminalRateLimit" : { "upEnable" : true, "upLimit" : "50.0", "downEnable" : true, "downLimit" : "50.0", "timeRange" : [ { "timeTemplateId" : "b90f8190-e12f-4323-95f3-4018309209c4", "upEnable" : true, "upLimit" : "50.0", "downEnable" : true, "downLimit" : "50.0" } ] }, "terminalDynamicRateLimit" : { "dynamicEnable" : false, "dynamicLimit" : 16 }, "ipv6Enable" : false, "ndTrustPort" : false }, "dot11r" : false, "overDs" : false, "reassociateTimeout" : 1, "serviceGuarantee" : "performanceFirst", "activeDullClient" : false, "wmmScene" : "default", "edcaClientConfigList" : [ { "accessCategory" : "acvo", "aifsn" : 10, "ecwmax" : 10, "ecwmin" : 10, "txoplimit" : 10 } ], "insertOption82Enable" : false, "option82" : { "circuitId" : { "connectorPattern" : "colon", "contentType" : "ap-mac", "format" : "ascii", "userDefinedText" : "xxx" }, "remoteId" : { "connectorPattern" : "colon", "contentType" : "ap-mac", "format" : "ascii", "userDefinedText" : "xxx" } }, "forwardMode" : "direct", "softgreProfileId" : "fbde1c5d-5b94-49e3-a912-48641015e45f", "configName" : "ssid-config-name", "phyProtection" : "security-priority" }

响应示例 返回状态码为201：新增SSID成功，返回结构体参见ConfigSsidResponse。 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" : "de5813f8ff1e41f5ba9c324da70b49ed", "name" : "Huawei-Guest", "pki" : "default", "tags" : [ { "name" : "testApTag" } ], "strategyId" : "6e930b21-a107-45a9-96a2-f1443ca82f39", "enable" : true, "connectionMode" : "bridge", "vlans" : [ { "priority" : 0, "vlanId" : 10, "vlanDesc" : "work", "tags" : [ { "name" : "testApTag" } ] } ], "vlanId" : 10, "vlanDesc" : "work", "vlanMode" : "vlanId", "vlanPoolId" : "1e930b21-a307-45a9-96a2-f1443ca84f39", "vlanPoolName" : "vlanPool", "hidedEnable" : false, "autoOffTrackLinkEnable" : false, "arpCheckEnable" : true, "ipCheckEnable" : true, "dhcpStrictEnable" : false, "dhcpv6SlaacStrictEnable" : 0, "mdnsSnoopingEnable" : false, "dnsSnoopingEnable" : false, "gameSpeedUpEnable" : false, "relativeRadios" : 3, "relativeOnlyTwoRadios" : 3, "dtimInterval" : 1, "advertiseApNameSwitch" : true, "frequencyNavigation" : true, "maxUserNumber" : 10, "userSeparation" : false, "separationOption" : "disable", "userL2LanIsolate" : false, "staNetworkDetect" : true, "muMiMo" : true, "associationTimeout" : 5, "erSuSwitch" : true, "userFlowSyslogEnable" : false, "multiLinkOper" : false, "lay3RoamSwitch" : true, "suExtendedRangeSwitch" : false, "muRtsSwitch" : false, "muRtsThreshold" : 2347, "forbiddenOldTerminal" : false, "reachMaxSta" : 1, "igmpSnooping" : false, "multicast2Unicast" : "disable", "bcmcDenyAll" : false, "bonjourTransparent" : false, "powerSave" : false, "beacon2gRate" : "1Mbps", "beacon5gRate" : "6Mbps", "beacon6gRate" : "6Mbps", "sipPort" : 5060, "timeTemplateId" : "b90f8190-e12f-4323-95f3-4018309209c4", "timeTemplateName" : "全天", "seaSwitch" : false, "overDsPrivate" : "disable", "blackAndWhite" : { "bindingType" : 2, "terminalMacList" : [ "XX:XX:XX:XX:XX:XX" ], "terminalOUIList" : [ "02:02:01" ] }, "ssidAuth" : { "mode" : "ppsk", "oweTransitionMode" : true, "transitionOpenSsid" : "de5813f8ff1e41f5ba9c324da70b49ed", "pskEncryptType" : "wpa2", "wepType" : "WEP40", "wepDefaultKey" : 0, "enableMacAuth" : false, "saeEncryptType" : "", "saeSecurityKey" : "", "pskSaeEncryptType" : "", "pskSaeSecurityKey" : "", "securityKey" : "", "securityKeyType" : "AES", "dot1xEncryptType" : "", "dot1xQuietPeriod" : 60, "dot1xQuietTimes" : 10, "portal" : { "mode" : "portalDisable", "pushProtocol" : "https", "freeAuthEnable" : true, "authExpireUnit" : "day", "authExpire" : 10, "escapeStrategy" : 2, "escapeProfileName" : "escapeStrategy1", "escapeProfileId" : "5871926c-2a5e-4340-a931-19ce019a231c", "freeAclTmplId" : "b90f8190-e12f-4323-95f3-4018309209c4", "freeAclTmplName" : "free-rule", "controllerPortalType" : "haca", "masterPortalTmplId" : "0b6d8077-947a-41d0-a539-c8a02c5fe6dc", "masterPortalTmplName" : "", "bakPortalEnable" : false, "bakPortalTmplId" : "0b6d8077-947a-41d0-a539-c8a02c5fe6dc", "bakPortalTmplName" : "", "authRedirectUrlCarryEnable" : false, "radiusEnable" : false, "radiusTmplId" : "0b6d8077-947a-41d0-a539-c8a02c5fe6dc", "radiusTmplName" : "", "fastPushEnable" : true, "portalPageId" : "0b6d8077-947a-41d0-a539-c8a02c5fe6dc", "wechatUrlAuthEnable" : false, "weComAuthEnable" : false, "dingTalkEnable" : false, "normalEnable" : false, "registerEnable" : false, "registerExpire" : 2, "registerExpireUnit" : "hour", "userRegisterMaxAccessNumber" : 0, "userGroupId" : "0b6d8077-947a-41d0-a539-c8a02c5fe6dc", "smsAuthEnable" : false, "smsPasswordExpire" : 5, "smsPasswordExpireUnit" : "minute", "smsUserRegisterEnable" : false, "smsUserExpire" : 2, "smsUserExpireUnit" : "hour", "smsUserMaxAccessNumber" : 0, "smsUserGroupId" : "0b6d8077-947a-41d0-a539-c8a02c5fe6dc", "emailAuthEnable" : false, "passCodeEnable" : false, "oneKeyAuthEnable" : false, "anonymousEnable" : false, "socialMediaEnable" : false, "twitterEnable" : false, "sinaEnable" : false, "qqEnable" : false, "qrCodeAuthEnable" : false, "qrCodeRegisterEnable" : false, "googleEnable" : false, "accountingEnable" : false, "accountingExpire" : 15, "interconnectionMode" : "API", "userNameKey" : "用户", "passwordKey" : "", "urlMatchMode" : 0, "successUrlKey" : "", "authFailedUrlKey" : "", "logoutSuccessUrlKey" : "", "logoutFailedUrlKey" : "", "logoutUrlKey" : "", "radiusModelId" : "0b6d8077-947a-41d0-a539-c8a02c5fe6dc" }, "radius" : { "radiusTmplId" : "", "radiusTmplName" : "", "staticEnable" : "", "iconnectAccessEnable" : "", "autoReauthenTime" : "", "hacaEnable" : "" }, "macAutoBinding" : true, "macAuthMethod" : "", "escapeStrategy" : "noAuth", "escapeProfileName" : "escapeStrategy1", "escapeProfileId" : "5871926c-2a5e-4340-a931-19ce019a231c", "haca" : { "authComponentId" : "00000000-0000-0000-0000-000000000000", "authComponentIp" : "10.20.0.0", "bakAuthComponentId" : "00000000-0000-0000-0000-000000000000", "bakAuthComponentIp" : "10.20.0.0" } }, "vapBackupConfig" : { "vapBackupEnable" : false, "radiusBackupTmplId" : "cf23f275-01e6-4301-890e-407e1d78c53e", "rejectNewAccess" : false }, "ssidPolicy" : { "securityPolicy" : { "highReliableSliceAclTplId" : "b90f8190-e12f-4323-95f3-4018309209c4", "highReliableSliceAclTplName" : "test-slice-acl", "highReliableSliceAclTplIdIpv6" : "b90f8190-e12f-4323-95f3-4018309209c4", "highReliableSliceAclTplNameIpv6" : "test-slice-acl", "securityAclTmplId" : "b90f8190-e12f-4323-95f3-4018309209c4", "securityAclTmplName" : "test-security-acl", "securityIPv6AclTmplId" : "b90f8190-e12f-4323-95f3-4018309209c4", "securityIPv6AclTmplName" : "test-security-acl", "tunnelAclTmplId" : "b90f8190-e12f-4323-95f3-4018309209c5", "tunnelAclTmplName" : "test-tunnel-acl", "ipsecAclTmplId" : "b90f8190-e12f-4323-95f3-4018309209c5", "ipsecAclTmplName" : "test-ipsec-acl", "tcpAdjustMss" : 1380, "appTrafficAcls" : { "appTrafficAclList" : [ { "direction" : "inbound", "index" : 0, "dscp" : 1, "appTrafficAclTplId" : "b90f8190-e12f-4323-95f3-4018309209c5", "appTrafficAclName" : "test-tunnel-acl" } ] }, "urlFilter" : { "enable" : true, "mode" : 1, "urls" : [ "" ], "hostNames" : [ "" ] }, "appsPolicys" : { "siteSaList" : [ { "appId" : 1, "type" : "app", "appType" : 1, "appName" : "test_name", "action" : "permit", "dscp" : 1, "car" : 1000 } ] } }, "ssidRateLimit" : { "upEnable" : true, "upLimit" : "50.0", "downEnable" : true, "downLimit" : "50.0" }, "terminalRateLimit" : { "upEnable" : true, "upLimit" : "50.0", "downEnable" : true, "downLimit" : "50.0", "timeRange" : [ { "timeTemplateId" : "b90f8190-e12f-4323-95f3-4018309209c4", "upEnable" : true, "upLimit" : "50.0", "downEnable" : true, "downLimit" : "50.0" } ] }, "terminalDynamicRateLimit" : { "dynamicEnable" : false, "dynamicLimit" : 16 }, "ipv6Enable" : false, "ndTrustPort" : false }, "dot11r" : false, "overDs" : false, "reassociateTimeout" : 1, "serviceGuarantee" : "performanceFirst", "activeDullClient" : false, "wmmScene" : "default", "edcaClientConfigList" : [ { "accessCategory" : "acvo", "aifsn" : 10, "ecwmax" : 10, "ecwmin" : 10, "txoplimit" : 10 } ], "insertOption82Enable" : false, "option82" : { "circuitId" : { "connectorPattern" : "colon", "contentType" : "ap-mac", "format" : "ascii", "userDefinedText" : "xxx" }, "remoteId" : { "connectorPattern" : "colon", "contentType" : "ap-mac", "format" : "ascii", "userDefinedText" : "xxx" } }, "forwardMode" : "direct", "softgreProfileId" : "fbde1c5d-5b94-49e3-a912-48641015e45f", "configName" : "ssid-config-name", "phyProtection" : "security-priority" } } 返回状态码为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

响应参数 返回状态码为201：创建设备全局参数成功，响应体参考DeviceGlobalConfigResponse。 表5 DeviceGlobalConfigResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 - errmsg string - - 错误信息。 - success ARRAY_REFERENCE 0-512个列表项，详细请参见表6。 成功的设备全局参数信息列表。 - fail ARRAY_REFERENCE 0-512个列表项，详细请参见表8。 失败的设备全局参数信息列表。 - 表6 DeviceGlobalConfig对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id uuid - - 设备全局参数ID。更新时必填，uuid格式。 "00000000-0000-0000-0000-000000000000" siteId uuid - - 站点ID。创建时必填，uuid格式。 "00000000-0000-0000-0000-000000000000" deviceId uuid - - 设备ID。创建时必填，uuid格式。 "00000000-0000-0000-0000-000000000000" deviceName string 0~256个字符。 - 设备名称。查询时返回。 "device1" ipv4TcpGlobal REFERENCE 详细请参见表7。 TCP全局参数。 - 表7 Ipv4TcpGlobal对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 tcpMaxMssEnable boolean true false - 使能TCP连接的MSS最大值。默认值为false。 true tcpMaxMss int32 [32-9600] - IPv4 TCP连接的MSS最大值，取值范围：32-9600。 216 tcpMinMssEnable boolean true false - 使能TCP连接的MSS最小值。默认值为false。 true tcpMinMss int32 [32-9600] - IPv4 TCP连接的MSS最小值，取值范围：32-9600。 216 表8 FailDeviceGlobalConfig对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 - errmsg string - - 错误信息。 - data REFERENCE 详细请参见表6。 设备全局参数信息。 - 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。

响应示例 返回状态码为201：创建设备全局参数成功，响应体参考DeviceGlobalConfigResponse。 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" : "", "errmsg" : "", "success" : [ { "id" : "00000000-0000-0000-0000-000000000000", "siteId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "deviceName" : "device1", "ipv4TcpGlobal" : { "tcpMaxMssEnable" : true, "tcpMaxMss" : 216, "tcpMinMssEnable" : true, "tcpMinMss" : 216 } } ], "fail" : [ { "errcode" : "", "errmsg" : "", "data" : { "id" : "00000000-0000-0000-0000-000000000000", "siteId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "deviceName" : "device1", "ipv4TcpGlobal" : { "tcpMaxMssEnable" : true, "tcpMaxMss" : 216, "tcpMinMssEnable" : true, "tcpMinMss" : 216 } } } ] } 返回状态码为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参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 globalConfigs 是 REFERENCE 详细请参见表2。 创建设备全局参数。 - 表2 DeviceGlobalConfigs对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 globalConfigs 否 ARRAY_REFERENCE 1-2个列表项，详细请参见表3。 设备全局参数信息。 - 表3 DeviceGlobalConfig对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 id 否 uuid - - 设备全局参数ID。更新时必填，uuid格式。 "00000000-0000-0000-0000-000000000000" siteId 否 uuid - - 站点ID。创建时必填，uuid格式。 "00000000-0000-0000-0000-000000000000" deviceId 否 uuid - - 设备ID。创建时必填，uuid格式。 "00000000-0000-0000-0000-000000000000" deviceName 否 string 0~256个字符。 - 设备名称。查询时返回。 "device1" ipv4TcpGlobal 否 REFERENCE 详细请参见表4。 TCP全局参数。 - 表4 Ipv4TcpGlobal对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 tcpMaxMssEnable 是 boolean true false - 使能TCP连接的MSS最大值。默认值为false。 true tcpMaxMss 否 int32 [32-9600] - IPv4 TCP连接的MSS最大值，取值范围：32-9600。 216 tcpMinMssEnable 是 boolean true false - 使能TCP连接的MSS最小值。默认值为false。 true tcpMinMss 否 int32 [32-9600] - IPv4 TCP连接的MSS最小值，取值范围：32-9600。 216

请求示例 HTTP的示例 POST /controller/campus/v1/sdwan/net/device/global-config 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 { "globalConfigs" : [ { "id" : "00000000-0000-0000-0000-000000000000", "siteId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "deviceName" : "device1", "ipv4TcpGlobal" : { "tcpMaxMssEnable" : true, "tcpMaxMss" : 216, "tcpMinMssEnable" : true, "tcpMinMss" : 216 } } ] }

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

请求示例 HTTP的示例 GET /restconf/v2/data/huawei-ac-nes-device:nes/ne/00000000-0000-0000-0000-000000000000/huawei-nce-e-arp:arp-if/GE0%2F0%2F3 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 { "huawei-nce-e-arp:arp-if" : [ { "config-status" : "configured-database-success", "last-committed-time" : "2022-01-01 00:00:00", "related-pkg-version" : "1.0.1", "edit-state" : "RUNNING", "if-name" : "GE0/0/3", "arp-proxy" : false, "route-proxy-enable" : true, "miss-anti-limit" : 333, "arp-limit" : [ { "vlan-id" : 444, "limit-num" : 555 } ], "ipv4" : { "static-arp" : [ { "ip-addr" : "10.1.1.4", "mac-addr" : "xxxx-xxxx-xxxx" } ] } } ] } 返回状态码为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：查询成功，响应体参考GetIPSecInfoRsp。 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" : 10, "totalRecords" : 100, "collectedTime" : "1693222020466", "data" : [ { "deviceId" : "00000000-0000-0000-0000-000000000000", "siteId" : "00000000-0000-0000-0000-000000000000", "deviceName" : "deviceName", "siteName" : "siteName", "ifmName" : "GE0/0/1", "peerAddress" : "192.168.1.1", "peerPort" : 1, "localAddress" : "192.168.1.1", "localPort" : 1, "status" : "siteName" } ] } 返回状态码为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：查询成功，响应体参考GetIPSecInfoRsp。 表3 GetIpsecInfoRsp对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~10个字符。 - 错误码。 "0" errmsg string 0~255个字符。 - 错误信息。 "" pageIndex int32 [1-10000] - 分页序号。 1 pageSize integer [1-100] - 分页大小。 10 totalRecords int32 [0-10000] - 条目总数。 100 collectedTime int64 - - 数据采集时间戳。 "1693222020466" data ARRAY_REFERENCE 0-10000个列表项，详细请参见表4。 设备IPSec信息结构体。 - 表4 IpsecInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 deviceId string 0~36个字符。 - 设备ID。 "00000000-0000-0000-0000-000000000000" siteId string 0~36个字符。 - 站点ID。 "00000000-0000-0000-0000-000000000000" deviceName string 0~256个字符。 - 设备名称。 "deviceName" siteName string 0~256个字符。 - 站点名称。 "siteName" ifmName string 0~256个字符。 - 接口名称。 "GE0/0/1" peerAddress string 0~256个字符。 - 对端IP地址。 "192.168.1.1" peerPort int32 [1-65535] - 对端UDP端口号。 1 localAddress string 0~256个字符。 - 对端IP地址。 "192.168.1.1" localPort int32 [1-65535] - 本端UDP端口号。 1 status string 0~256个字符。 - IPSec隧道状态，Up：IPSec隧道建立成功；Down ：IPSec隧道Down；Not found：设备无IPSec隧道；查询失败：设备在线状态异常，设备返回错误；版本不支持：设备版本不支持（V600R024C00、V300R023C00SPC100之前设备）。 "siteName" 返回状态码为400：请求参数错误。 详细信息请参见实际响应消息体。 返回状态码为500：内部异常。 详细信息请参见实际响应消息体。

请求示例 HTTP的示例 POST /controller/campus/v1/sdwan/ipsec/get-ipsec-infos 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 { "siteIds" : ["00000000-0000-0000-0000-000000000000"], "keyWord" : "deviceName", "peerAddress" : "192.168.1.1", "localAddress" : "192.168.1.1", "status" : "Down", "pageIndex" : 1, "pageSize" : 10, "isRealTime" : true }

响应示例 返回状态码为200：创建成功，返回结构体参见SiteTemplateAptunnelResponseDto。 HTTPS/1.1 200 OK Date: Thu,13 MAY 2023 10:00:00 GMT Server: example-server Content-Type: application/json { "errcode" : "0", "errmsg" : "", "data" : [ { "id" : "00000000000000000000000000000000", "tunnelName" : "tunnel1", "masterTunnelIp" : "192.168.0.1", "slaveTunnelIp" : "192.168.0.2", "autoRestoreEnable" : true, "autoRestoreDelay" : 100, "vlanRanges" : "20,30-200,500", "dtlsType" : "disable", "backUpDtlsType" : "disable" } ] } 返回状态码为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的示例 { "tunnelName" : "tunnel1", "masterTunnelIp" : "192.168.0.1", "slaveTunnelIp" : "192.168.0.2", "autoRestoreEnable" : true, "autoRestoreDelay" : 100, "vlanRanges" : "20,30-200,500", "dtlsType" : "disable", "backUpDtlsType" : "disable" }

请求参数 表2 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 ApTunnelCreateDto 是 REFERENCE 详细请参见表3。 站点模板AP隧道配置参数，结构体参见ApTunnelCreateDto - 表3 ApTunnelCreateDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 tunnelName 是 string 1~35个字符。 - 隧道名称。取值范围：1~35个半角字符，不能以双引号开头或结尾且不能包含空格和问号。不支持修改。 "tunnel1" masterTunnelIp 是 string 7~15个字符。 - 主隧道IP。 "192.168.0.1" slaveTunnelIp 否 string 7~15个字符。 - 备隧道IP。 "192.168.0.2" autoRestoreEnable 否 boolean true false false 自动恢复。默认值为false。 true autoRestoreDelay 否 int32 [60-600] - 自动恢复延时。 100 vlanRanges 是 string 1~100个字符。 - 2-4094范围内的整数或段，多个整数或段间用“,”分割，最多可输入10组。且配置的隧道VLAN不能与管理VLAN相同，否则隧道VLAN不生效。 "20,30-200,500" dtlsType 否 string 1~20个字符。满足正则表达disable|psk|mandatory-cert。 - 主隧道传输层数据包安全协议。取值范围：disable---不配置、psk---秘钥、mandatory-cert---证书。 "disable" securityKey 否 password 1~64个字符。 - 该字段可能包含敏感信息和个人数据，请妥善做好保护。 主隧道认证秘钥，当传输层数据包安全协议选择psk时生效。取值范围：8~32个字符，至少包含大写字母、小写字母、数字或特殊字符中的两种，不能包含问号和空格。 "tunnelkey" backUpDtlsType 否 string 1~20个字符。满足正则表达disable|psk|mandatory-cert。 - 备隧道传输层数据包安全协议。取值范围：disable---不配置、psk---秘钥、mandatory-cert---证书。 "disable" backUpSecurityKey 否 password 1~64个字符。 - 该字段可能包含敏感信息和个人数据，请妥善做好保护。 备隧道认证秘钥，当传输层数据包安全协议选择psk时生效。取值范围：8~32个字符，至少包含大写字母、小写字母、数字或特殊字符中的两种，不能包含问号和空格。 "tunnelkey" backUpKeyInvalid 否 boolean true false false 备用密钥是否有效。默认值为false。 true keyInvalid 否 boolean true false false 主密钥是否有效。默认值为false。 true

响应参数 返回状态码为200：创建成功，返回结构体参见SiteTemplateAptunnelResponseDto。 表4 SiteTemplateAptunnelResponseDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~64个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "" data ARRAY_REFERENCE 0-8个列表项，详细请参见表5。 站点模板AP隧道配置信息，结构体参见AptunnelResponseDto。 - 表5 AptunnelResponseDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string 32个字符。 - 隧道ID。 "00000000000000000000000000000000" tunnelName string 1~35个字符。 - 隧道名称。取值范围：1~35个半角字符，不能以双引号开头或结尾且不能包含空格和问号。不支持修改。 "tunnel1" masterTunnelIp string 7~15个字符。 - 主隧道IP。 "192.168.0.1" slaveTunnelIp string 7~15个字符。 - 备隧道IP。 "192.168.0.2" autoRestoreEnable boolean true false false 自动恢复。默认值为false。 true autoRestoreDelay int32 [60-600] - 自动恢复延时。 100 vlanRanges string 1~100个字符。 - 2-4094范围内的整数或段，多个整数或段间用“,”分割，最多可输入10组。且配置的隧道VLAN不能与管理VLAN相同，否则隧道VLAN不生效。 "20,30-200,500" dtlsType string 1~20个字符。 disable psk mandatory-cert - 主隧道传输层数据包安全协议。取值范围：disable---不配置、psk---秘钥、mandatory-cert---证书。 "disable" backUpDtlsType string 1~20个字符。 disable psk mandatory-cert - 备隧道传输层数据包安全协议。取值范围：disable---不配置、psk---秘钥、mandatory-cert---证书。 "disable" backUpKeyInvalid boolean true false false 备用密钥是否有效。默认值为false。 true keyInvalid boolean true false false 主密钥是否有效。默认值为false。 true 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部服务错误。 详细信息请参见实际响应消息体。

URI /controller/campus/v3/networkconfig/site-templates/{siteTemplateId}/aptunnel 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteTemplateId 是 string 36个字符。 - 站点模板标识，UUID格式。 "fbde1c5d-5b94-49e3-a912-48641015e45c"

请求示例 HTTP的示例 PUT /controller/campus/v1/sdwan/vty/acl 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", "aclNum" : 2100, "type" : "IPv4", "ruleList" : [ { "ruleId" : 10, "operateType" : 1, "ipRange" : "192.168.1.1/16" } ] }

响应示例 返回状态码为200：修改成功，响应体参考CommonRestResponse。 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" : { "siteId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "aclNum" : 2100, "type" : "IPv4", "ruleList" : [ { "ruleId" : 10, "operateType" : 1, "ipRange" : "192.168.1.1/16" } ] } } 返回状态码为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/overlay-network/vpn/route-policy 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" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6", "siteId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6", "exportRoutePolicy" : { "nodes" : [ { "nodeIndex" : 20000, "mode" : "permit", "matchCondition" : { "ipPrefix" : { "name" : "", "prefixFilters" : [ { "matchMode" : "permit", "ipv4Address" : "10.1.0.0", "maskLength" : 24, "greaterEqual" : 24, "lessEqual" : 24 } ] }, "ipv6Prefix" : { "name" : "", "ipv6PrefixFilters" : [ { "matchMode" : "permit", "ipv6Address" : "fc00::", "maskLength" : 96, "greaterEqual" : 96, "lessEqual" : 96 } ] }, "communityFilters" : [ { "name" : "filterName", "communityNodes" : [ { "matchMode" : "permit", "communityMembers" : [ "10" ] } ], "wholeMatch" : false } ] }, "applyAction" : { "applyCommunity" : { "communityNumbers" : [ "100" ], "additive" : false, "none" : false }, "applyExtCommunity" : { "rtFilters" : [ "100:1" ], "additive" : false }, "applyAsPath" : { "asNumbers" : [ "100" ], "additive" : false, "overwrite" : false, "none" : false }, "applyMetric" : { "cost" : "24", "sign" : "add" }, "localPreference" : 100, "preferredValue" : 100 }, "nextNode" : { "nextNodeIndex" : 20001 } } ] }, "importRoutePolicy" : { "nodes" : [ { "nodeIndex" : 20000, "mode" : "permit", "matchCondition" : { "ipPrefix" : { "name" : "", "prefixFilters" : [ { "matchMode" : "permit", "ipv4Address" : "10.1.0.0", "maskLength" : 24, "greaterEqual" : 24, "lessEqual" : 24 } ] }, "ipv6Prefix" : { "name" : "", "ipv6PrefixFilters" : [ { "matchMode" : "permit", "ipv6Address" : "fc00::", "maskLength" : 96, "greaterEqual" : 96, "lessEqual" : 96 } ] }, "communityFilters" : [ { "name" : "filterName", "communityNodes" : [ { "matchMode" : "permit", "communityMembers" : [ "10" ] } ], "wholeMatch" : false } ] }, "applyAction" : { "applyCommunity" : { "communityNumbers" : [ "100" ], "additive" : false, "none" : false }, "applyExtCommunity" : { "rtFilters" : [ "100:1" ], "additive" : false }, "applyAsPath" : { "asNumbers" : [ "100" ], "additive" : false, "overwrite" : false, "none" : false }, "applyMetric" : { "cost" : "24", "sign" : "add" }, "localPreference" : 100, "preferredValue" : 100 }, "nextNode" : { "nextNodeIndex" : 20001 } } ] } } ]

响应示例 返回状态码为201：接口调用成功，响应体参考VpnRoutePolicyResponse。 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" : [ { "vpnId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6", "siteId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6", "exportRoutePolicy" : { "nodes" : [ { "nodeIndex" : 20000, "mode" : "permit", "matchCondition" : { "ipPrefix" : { "name" : "", "prefixFilters" : [ { "matchMode" : "permit", "ipv4Address" : "10.1.0.0", "maskLength" : 24, "greaterEqual" : 24, "lessEqual" : 24 } ] }, "ipv6Prefix" : { "name" : "", "ipv6PrefixFilters" : [ { "matchMode" : "permit", "ipv6Address" : "fc00::", "maskLength" : 96, "greaterEqual" : 96, "lessEqual" : 96 } ] }, "communityFilters" : [ { "name" : "filterName", "communityNodes" : [ { "matchMode" : "permit", "communityMembers" : [ "10" ] } ], "wholeMatch" : false } ] }, "applyAction" : { "applyCommunity" : { "communityNumbers" : [ "100" ], "additive" : false, "none" : false }, "applyExtCommunity" : { "rtFilters" : [ "100:1" ], "additive" : false }, "applyAsPath" : { "asNumbers" : [ "100" ], "additive" : false, "overwrite" : false, "none" : false }, "applyMetric" : { "cost" : "24", "sign" : "add" }, "localPreference" : 100, "preferredValue" : 100 }, "nextNode" : { "nextNodeIndex" : 20001 } } ] }, "importRoutePolicy" : { "nodes" : [ { "nodeIndex" : 20000, "mode" : "permit", "matchCondition" : { "ipPrefix" : { "name" : "", "prefixFilters" : [ { "matchMode" : "permit", "ipv4Address" : "10.1.0.0", "maskLength" : 24, "greaterEqual" : 24, "lessEqual" : 24 } ] }, "ipv6Prefix" : { "name" : "", "ipv6PrefixFilters" : [ { "matchMode" : "permit", "ipv6Address" : "fc00::", "maskLength" : 96, "greaterEqual" : 96, "lessEqual" : 96 } ] }, "communityFilters" : [ { "name" : "filterName", "communityNodes" : [ { "matchMode" : "permit", "communityMembers" : [ "10" ] } ], "wholeMatch" : false } ] }, "applyAction" : { "applyCommunity" : { "communityNumbers" : [ "100" ], "additive" : false, "none" : false }, "applyExtCommunity" : { "rtFilters" : [ "100:1" ], "additive" : false }, "applyAsPath" : { "asNumbers" : [ "100" ], "additive" : false, "overwrite" : false, "none" : false }, "applyMetric" : { "cost" : "24", "sign" : "add" }, "localPreference" : 100, "preferredValue" : 100 }, "nextNode" : { "nextNodeIndex" : 20001 } } ] } } ], "fail" : [ { "errcode" : "0", "errmsg" : "", "data" : { "vpnId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6", "siteId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6", "exportRoutePolicy" : { "nodes" : [ { "nodeIndex" : 20000, "mode" : "permit", "matchCondition" : { "ipPrefix" : { "name" : "", "prefixFilters" : [ { "matchMode" : "permit", "ipv4Address" : "10.1.0.0", "maskLength" : 24, "greaterEqual" : 24, "lessEqual" : 24 } ] }, "ipv6Prefix" : { "name" : "", "ipv6PrefixFilters" : [ { "matchMode" : "permit", "ipv6Address" : "fc00::", "maskLength" : 96, "greaterEqual" : 96, "lessEqual" : 96 } ] }, "communityFilters" : [ { "name" : "filterName", "communityNodes" : [ { "matchMode" : "permit", "communityMembers" : [ "10" ] } ], "wholeMatch" : false } ] }, "applyAction" : { "applyCommunity" : { "communityNumbers" : [ "100" ], "additive" : false, "none" : false }, "applyExtCommunity" : { "rtFilters" : [ "100:1" ], "additive" : false }, "applyAsPath" : { "asNumbers" : [ "100" ], "additive" : false, "overwrite" : false, "none" : false }, "applyMetric" : { "cost" : "24", "sign" : "add" }, "localPreference" : 100, "preferredValue" : 100 }, "nextNode" : { "nextNodeIndex" : 20001 } } ] }, "importRoutePolicy" : { "nodes" : [ { "nodeIndex" : 20000, "mode" : "permit", "matchCondition" : { "ipPrefix" : { "name" : "", "prefixFilters" : [ { "matchMode" : "permit", "ipv4Address" : "10.1.0.0", "maskLength" : 24, "greaterEqual" : 24, "lessEqual" : 24 } ] }, "ipv6Prefix" : { "name" : "", "ipv6PrefixFilters" : [ { "matchMode" : "permit", "ipv6Address" : "fc00::", "maskLength" : 96, "greaterEqual" : 96, "lessEqual" : 96 } ] }, "communityFilters" : [ { "name" : "filterName", "communityNodes" : [ { "matchMode" : "permit", "communityMembers" : [ "10" ] } ], "wholeMatch" : false } ] }, "applyAction" : { "applyCommunity" : { "communityNumbers" : [ "100" ], "additive" : false, "none" : false }, "applyExtCommunity" : { "rtFilters" : [ "100:1" ], "additive" : false }, "applyAsPath" : { "asNumbers" : [ "100" ], "additive" : false, "overwrite" : false, "none" : false }, "applyMetric" : { "cost" : "24", "sign" : "add" }, "localPreference" : 100, "preferredValue" : 100 }, "nextNode" : { "nextNodeIndex" : 20001 } } ] } } } ] } 返回状态码为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：操作成功。 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的示例 PATCH /restconf/v2/data/huawei-ac-nes-device:nes/ne/00000000-0000-0000-0000-000000000000/huawei-nce-e-mpls:mpls 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-mpls:mpls" : { "enable" : true, "lsr-id" : "10.1.1.1" } }

请求参数 表2 header参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 restconf-transaction-id 是 string - - 事务ID。 "00000000-0000-0000-0000-000000000000" 表3 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 huawei-nce-e-mpls:mpls 是 REFERENCE 详细请参见表4。 全局MPLS配置参数。 - 表4 mpls-exclude-patch-false-augment对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 huawei-nce-e-mpls:mpls 否 REFERENCE 详细请参见表5。 全局MPLS配置参数。 - 表5 mpls-patch-false对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 enable 否 boolean true false - 使能。 true lsr-id 否 string 满足正则表达(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])(%[\p{N}\p{L}]+)?。 - LSR ID，IPv4地址格式。 "10.1.1.1"