华为云用户手册

响应参数 返回状态码为200：接口调用成功，响应体参考QueryVpnRoutePolicyResponse。 表2 QueryVpnRoutePolicyResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" totalRecords int32 - - 总的数据条数。 200 pageSize int32 - - 每页显示数量。 20 pageIndex int32 - - 当前页数。 1 data ARRAY_REFERENCE 0-1000个列表项，详细请参见表20。 VPN路由策略信息。 - 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。

请求示例 HTTP的示例 DELETE /restconf/v2/data/huawei-ac-nes-device:nes/ne/00000000-0000-0000-0000-000000000000/huawei-nce-e-bd:bd/10 HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-AC CES S-TOKEN: x-yyyyyy restconf-transaction-id: "00000000-0000-0000-0000-000000000000"

URI /restconf/v2/data/huawei-ac-nes-device:nes/ne/{id}/huawei-nce-e-bd:bd/{bd-id} 表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" bd-id 是 int64 [1-16777215] - Bridge Domain ID，单一主键字段。 "10"

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

响应示例 返回状态码为200：接口调用成功，响应体参考SsidListDto。 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 { "totalRecords" : "", "ssidConfigDto" : [ { "id" : "", "ssidName" : "", "enable" : false, "wlanId" : "10", "authenticationMode" : "open", "upFlow" : "", "downFlow" : "", "terminalNum" : "", "bssid" : "", "apTagList" : [ { "id" : "c4150671-22fe-4dc9-9915-555e52b17fc6", "name" : "tag" } ], "relativeRadios" : [ "2.4G,5G" ] } ], "errcode" : "0", "message" : "error" } 返回状态码为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

请求示例 HTTP的示例 GET /controller/campus/v5/performance/ssid/devicessidconfiglist?deviceId=ea25fdbf-8dee-4823-bac2-5bfe8e3359ca HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy

响应示例 返回状态码为200：查询成功返回体。 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" : { "iwgPolicyInfos" : [ { "id" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6", "siteId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6", "localVpnId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6", "remoteVpnImportRt" : ["123:123","124:124"], "remoteVpnExportRt" : ["123:123","124:124"], "remoteVpnIpv6ImportRt" : ["123:123","124:124"], "remoteVpnIpv6ExportRt" : ["123:123","124:124"], "diffservMode" : "pipe", "mplsExp" : 1 } ] } } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

响应参数 返回状态码为200：查询成功返回体。 表2 QueryIwgPolicyResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" data REFERENCE 详细请参见表3。 IWG Policy信息 - 表3 IwgPolicyInfos对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 iwgPolicyInfos ARRAY_REFERENCE 1-16个列表项，详细请参见表5。 IWG Policy信息。 - 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。

URI /controller/campus/v1/sdwan/overlay-network/iwg-interworking 表1 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 iwgPolicyId 否 uuid - - IWG Policy ID，UUID格式，如果传该参数，则vpnId，siteId不生效。 "a99f794e-b510-438c-a75d-de59f02347eb" vpnId 否 uuid - - VPN ID，UUID格式。 "a99f794e-b510-438c-a75d-de59f02347eb" siteId 否 uuid - - Site ID，UUID格式。 "a99f794e-b510-438c-a75d-de59f02347eb"

请求示例 HTTP的示例 GET /controller/campus/v1/sdwan/overlay-network/iwg-interworking?iwgPolicyId=a99f794e-b510-438c-a75d-de59f02347eb&vpnId=a99f794e-b510-438c-a75d-de59f02347eb&siteId=a99f794e-b510-438c-a75d-de59f02347eb 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

请求示例 HTTP的示例 POST /controller/campus/v1/sdwan/policy/traffic/qos-policies 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 { "effectImmediate" : true, "fullReplace" : true, "qosPolicies" : [ { "id" : "00000000-0000-0000-0000-000000000000", "vpnId" : "00000000-0000-0000-0000-000000000000", "vpnGroupId" : "00000000-0000-0000-0000-000000000000", "name" : "qos1", "direction" : "", "qosRules" : [ { "qosRuleId" : "00000000-0000-0000-0000-000000000000", "qosClassificationId" : "00000000-0000-0000-0000-000000000000", "qosClassificationName" : "qosClassificationName", "qosProfileId" : "00000000-0000-0000-0000-000000000000", "qosProfileName" : "templateName", "lanQosProfileId" : "00000000-0000-0000-0000-000000000000", "lanQosProfileName" : "templateName", "effectiveTimeId" : "00000000-0000-0000-0000-000000000000", "effectiveTimeName" : "effectiveTimeName", "qosPriority" : 1 } ], "status" : 1, "isActive" : true, "bindMode" : "siteMode" } ] }

响应示例 返回状态码为201：创建成功，响应体参考QosPolicyResponse。 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" : [ { "id" : "00000000-0000-0000-0000-000000000000", "vpnId" : "00000000-0000-0000-0000-000000000000", "vpnGroupId" : "00000000-0000-0000-0000-000000000000", "name" : "qos1", "direction" : "", "qosRules" : [ { "qosRuleId" : "00000000-0000-0000-0000-000000000000", "qosClassificationId" : "00000000-0000-0000-0000-000000000000", "qosClassificationName" : "qosClassificationName", "qosProfileId" : "00000000-0000-0000-0000-000000000000", "qosProfileName" : "templateName", "lanQosProfileId" : "00000000-0000-0000-0000-000000000000", "lanQosProfileName" : "templateName", "effectiveTimeId" : "00000000-0000-0000-0000-000000000000", "effectiveTimeName" : "effectiveTimeName", "qosPriority" : 1 } ], "status" : 1, "isActive" : true, "bindMode" : "siteMode" } ], "fail" : [ { "errcode" : "0x00c8000c", "errmsg" : "The parameter is invalid.", "data" : { "id" : "00000000-0000-0000-0000-000000000000", "vpnId" : "00000000-0000-0000-0000-000000000000", "vpnGroupId" : "00000000-0000-0000-0000-000000000000", "name" : "qos1", "direction" : "", "qosRules" : [ { "qosRuleId" : "00000000-0000-0000-0000-000000000000", "qosClassificationId" : "00000000-0000-0000-0000-000000000000", "qosClassificationName" : "qosClassificationName", "qosProfileId" : "00000000-0000-0000-0000-000000000000", "qosProfileName" : "templateName", "lanQosProfileId" : "00000000-0000-0000-0000-000000000000", "lanQosProfileName" : "templateName", "effectiveTimeId" : "00000000-0000-0000-0000-000000000000", "effectiveTimeName" : "effectiveTimeName", "qosPriority" : 1 } ], "status" : 1, "isActive" : true, "bindMode" : "siteMode" } } ] } 返回状态码为400：请求参数错误，无响应体。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部错误，无响应体。 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

响应示例 返回状态码为201：创建成功，响应体参考VpnBandwidthPolicyResponse。 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" : [ { "id" : "00000000-0000-0000-0000-000000000000", "name" : "VpnBandwidthPolicy", "direction" : "outbound", "enableStatistic" : false, "enableFixMode" : false, "bandwidthAllocations" : [ { "vpnId" : "00000000-0000-0000-0000-000000000000", "vpnGroupId" : "00000000-0000-0000-0000-000000000000", "bandwidth" : 10 } ] } ], "fail" : [ { "errcode" : "0x00c8000c", "errmsg" : "The parameter is invalid.", "data" : { "id" : "00000000-0000-0000-0000-000000000000", "name" : "VpnBandwidthPolicy", "direction" : "outbound", "enableStatistic" : false, "enableFixMode" : false, "bandwidthAllocations" : [ { "vpnId" : "00000000-0000-0000-0000-000000000000", "vpnGroupId" : "00000000-0000-0000-0000-000000000000", "bandwidth" : 10 } ] } } ], "processInstanceId" : "" } 返回状态码为204：执行成功，无响应体。 HTTP/1.1 204 No Content 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的示例 POST /controller/campus/v1/sdwan/policy/traffic/vpn-bandwidth-policies 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 { "bandwidthPolicies" : [ { "id" : "00000000-0000-0000-0000-000000000000", "name" : "VpnBandwidthPolicy", "direction" : "outbound", "enableStatistic" : false, "enableFixMode" : false, "bandwidthAllocations" : [ { "vpnId" : "00000000-0000-0000-0000-000000000000", "vpnGroupId" : "00000000-0000-0000-0000-000000000000", "bandwidth" : 10 } ] } ] }

请求示例 HTTP的示例 PUT /v1/performanceservice/flow/instances 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" : "指定流名称", "profileId" : "9a157da3-9e59-41c9-8312-254a38a3b275", "profileName" : "识别流模板名称", "enable" : true, "dscp" : 63, "vpnPorts" : [ { "operate" : 0, "interfaceName" : "GigabiEthernet0/0/1", "deviceName" : "设备001", "deviceId" : "9a157da3-9e59-41c9-8312-254a38a3b275", "vpnId" : "9a157da3-9e59-41c9-8312-254a38a3b276", "vpnName" : "vpn1" } ], "id" : "512" }

响应示例 返回状态码为200：设置随流检测配置成功后的状态返回码。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "Success", "id" : "512" } 返回状态码为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参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 flowPutInput 否 REFERENCE 详细请参见表2。 修改随流检测配置 - 表2 FlowPutInput对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 name 否 string 1~256个字符。 - 指定流名称 "指定流名称" profileId 否 string 1~36个字符。 - 识别流模板id "9a157da3-9e59-41c9-8312-254a38a3b275" profileName 否 string 0~256个字符。 - 识别流模板名称 "识别流模板名称" enable 否 boolean true false true 启用状态 true-打开 false-关闭 true dscp 否 int32 [0-63] - 静态流排序号 63 vpnPorts 否 ARRAY_REFERENCE 0-200个列表项，详细请参见表3。 设备接口接口信息 - id 否 string 0~5个字符。 - 流id "512"

URI /controller/campus/v1/sdwan/routing-protocol/bgp-advance-config 表1 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 vpnId 否 uuid - - VPN ID。查询vpnv4 bgp时不填，其余场景vpnId与tnpId二者必填其一，UUID格式。 "a99f794e-b510-438c-a75d-de59f02347eb" tnpId 否 uuid - - TNP ID。查询vpnv4 bgp时不填，其余场景vpnId与tnpId二者必填其一，UUID格式。 "a99f794e-b510-438c-a75d-de59f02347eb" siteId 是 uuid - - 站点ID，UUID格式。 "a99f794e-b510-438c-a75d-de59f02347eb" deviceId 否 uuid - - 设备ID，UUID格式。 "a99f794e-b510-438c-a75d-de59f02347eb"

响应参数 返回状态码为200：接口调用成功，响应体参考QueryBgpAdvanceResponse。 表2 QueryBgpAdvanceResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码：0 表示接口执行成功，非0 表示接口执行失败。 "0" errmsg string - - 错误信息。 "" data ARRAY_REFERENCE 0-2个列表项，详细请参见表3。 BGP路由信息。 - 表3 BgpAdvanceInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 siteId uuid - - 站点ID，UUID格式，更新时必填。 "fbb684c8-0d37-496f-bafa-4b06d515j7l6" deviceId uuid - - 设备ID，UUID格式。 "fbb684c8-0d37-496f-bafa-4b06d515j7l6" tnpId uuid - - tnpID，UUID格式。 "fbb684c8-0d37-496f-bafa-4b06d515j7l6" vpnId uuid - - vpnID，UUID格式。 "fbb684c8-0d37-496f-bafa-4b06d515j7l6" addressFamilyGlobals ARRAY_REFERENCE 0-1个列表项，详细请参见表46。 BGP地址族全局配置。当前只支持ipv4-unicast。 - 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。

请求示例 HTTP的示例 GET /controller/campus/v1/sdwan/routing-protocol/bgp-advance-config?vpnId=a99f794e-b510-438c-a75d-de59f02347eb&tnpId=a99f794e-b510-438c-a75d-de59f02347eb&siteId=a99f794e-b510-438c-a75d-de59f02347eb&deviceId=a99f794e-b510-438c-a75d-de59f02347eb HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy

响应示例 返回状态码为200：接口调用成功，响应体参考QueryBgpAdvanceResponse。 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" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6", "deviceId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6", "tnpId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6", "vpnId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6", "addressFamilyGlobals" : [ { "familyType" : "ipv4-unicast", "externalPreference" : 201, "maxLoadBalanceNum" : 1, "defaultRouteRedistribution" : false, "compareDifAsMed" : true, "routeRedistribution" : [ "direct" ], "aggregationRoute" : [ "192.168.10.0/24" ] } ] } ] } 返回状态码为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的示例 DELETE /restconf/v2/data/huawei-ac-nes-device:nes/ne/00000000-0000-0000-0000-000000000000/huawei-nce-e-arp:arp 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"

URI /restconf/v2/data/huawei-ac-nes-device:nes/ne/{id}/huawei-nce-e-arp:arp 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 id 是 string 36个字符。满足正则表达[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}。 - 设备ID。 "00000000-0000-0000-0000-000000000000"

响应示例 返回状态码为200：操作成功。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为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/performance/spr-statistics/query-metrics-detailed 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", "metrics" : "pkgLoss", "metricDistbt" : ["0-1","1-5","5-10","10-100"], "startTime" : 1616824800000, "endTime" : 1616828400000 }

响应示例 返回状态码为200：查询成功，响应体参考StatisticsRsp。 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" : "", "total" : 10, "data" : [ { "key" : "link1", "value" : "35" } ] } 返回状态码为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的示例 PUT /controller/campus/v1/authconfigservice/accessconfig/fbb684c8-0d37-496f-bafa-4b06d5151e2e/ppsk/PPSK001 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 { "psk" : "pskofPPSK001", "vlan" : 100, "description" : "", "accDevNum" : 0, "macAddress" : "XX-XX-XX-XX-XX-XX", "ssidName" : "Huawei-Guest" }

响应示例 返回状态码为200：修改PPSK帐号成功，返回创建的帐号信息，响应体参考PpskPostOrPutResponseDto。 HTTP/1.1 200 OK Date: Tue,16 Aug 2022 10:00:00 GMT Server: example-server Content-Type: application/json { "errcode" : "0", "errmsg" : "", "data" : { "psk" : null, "vlan" : 100, "accDevNum" : 0, "macAddress" : "XX-XX-XX-XX-XX-XX", "ssidName" : "Huawei-Guest", "account" : "PPSK001", "id" : "00000000-0000-0000-0000-000000000000", "modifyTime" : 1534848006000, "ppskInfoList": null } } 返回状态码为400：校验异常，响应体参考BaseResponseDto。 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 { "errcode" : "0", "errmsg" : "" }

请求参数 表2 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 body 是 REFERENCE 详细请参见表3。 PPSK帐号信息参数体。 - 表3 PPSKPutRequestDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 psk 是 password 8~63个字符。 - 该字段可能包含敏感信息和个人数据，请妥善做好保护。 接入密钥。创建、修改和查询账号时psk返回值为空。 "pskofPPSK001" vlan 否 integer [0-4094] - 绑定VLAN，值为0表示不绑定VLAN。 100 description 否 string 0~255个字符。 - 描述。 - accDevNum 否 integer [0-250] - 接入终端数，值为0表示不限制接入终端数，当macAddress参数非空时，接入终端数固定为1。 0 macAddress 否 string - - 帐号绑定的MAC地址，大小写不敏感，MAC地址支持三种格式：XX:XX:XX:XX:XX:XX/XX-XX-XX-XX-XX-XX/XXXX-XXXX-XXXX。创建和修改账号时该返回值为空。 "XX-XX-XX-XX-XX-XX" ssidName 是 string 1~32个字符。 - SSID名称。 "Huawei-Guest"

URI /controller/campus/v1/authconfigservice/accessconfig/{siteId}/ppsk/{account} 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteId 是 string - - 站点ID，UUID格式。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e" account 是 string 1~64个字符。 - PPSK帐号名称。 "PPSK001"