响应示例 返回状态码为200：删除成功，响应体参考BatchDeletePpskResponseDto。 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 { "errmsg" : "", "errcode" : "", "successList" : ["00000000000000000000000000000000"], "failList" : [ { "errmsg" : "", "errcode" : "0", "ppskId" : "00000000000000000000000000000000" } ] } 返回状态码为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的示例 POST /controller/campus/v1/authconfigservice/accessconfig/fbb684c8-0d37-496f-bafa-4b06d5151e2e/ppsk/batch-delete 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 { "ppskIdList" : ["00000000000000000000000000000000"] }

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

请求示例 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"

响应示例 返回状态码为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": [ { "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 } ] } } 返回状态码为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" : "" }

请求示例 HTTP的示例 PUT /controller/campus/v1/authconfigservice/accessconfig/fbb684c8-0d37-496f-bafa-4b06d5151e2e/ppsk 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", "id" : "5b8b59d30bf042e6adfd4097a2c72b99", "account" : "PPSK001", "ppskInfoList" : [ { "psk" : "pskofPPSK001", "vlan" : 100, "description" : "", "accDevNum" : 0, "macAddress" : "XX-XX-XX-XX-XX-XX", "ssidName" : "Huawei-Guest", "id" : "5b8b59d30bf042e6adfd4097a2c72b99", "account" : "PPSK001" } ] }

请求参数 表2 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 body 是 REFERENCE 详细请参见表3。 PPSK帐号信息参数体。 - 表3 PPSKModifyRequestDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 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" id 否 string 0~36个字符。 - ppsk账号的id，填写id字段时，以id为准修改ppsk账号，不填写时以account为准，id与account不能同时为空。 "5b8b59d30bf042e6adfd4097a2c72b99" account 否 string 0~64个字符。 - PPSK帐号名称，不支持修改。 "PPSK001" ppskInfoList 否 ARRAY_REFERENCE 1-500个列表项，详细请参见表4。 批量PPSK帐号信息的数据结构。 - 表4 ModifyRequestBaseDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 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" id 否 string 0~36个字符。 - ppsk账号的id，填写id字段时，以id为准修改ppsk账号，不填写时以account为准，id与account不能同时为空。 "5b8b59d30bf042e6adfd4097a2c72b99" account 否 string 0~64个字符。 - PPSK帐号名称，不支持修改。 "PPSK001"

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"

响应示例 返回状态码为200：删除PPSK帐号成功，响应体参考PpskDeleteResponseDto。 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 { "id" : "00000000-0000-0000-0000-00000000000", "account" : "PPSK001" }

请求示例 HTTP的示例 DELETE /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

响应参数 返回状态码为200：删除PPSK帐号成功，响应体参考PpskDeleteResponseDto。 表2 PpskDeleteResponseDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string - - PPSK帐号ID。 "00000000-0000-0000-0000-00000000000" account string 1~64个字符。 - PPSK帐号名称。 "PPSK001"

请求示例 HTTP的示例 GET /controller/campus/v1/authconfigservice/accessconfig/fbb684c8-0d37-496f-bafa-4b06d5151e2e/ppsk?account=PPSK001&ssidName=Huawei-Guest&vlan=100&pageIndex=1&pageSize=20 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