云服务器内容精选

  • 请求示例 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-AC CES S-TOKEN: x-yyyyyy
  • 响应示例 返回状态码为200:查询成功,返回站点下符合条件的PPSK帐号列表,响应体参考PpskGetResponseDto。 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 } }
  • 响应参数 返回状态码为200:查询成功,返回站点下符合条件的PPSK帐号列表,响应体参考PpskGetResponseDto。 表3 PpskGetResponseDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~64个字符。 - 错误码,错误码为0表示操作成功。 "0" errmsg string 0~256个字符。 - 错误信息。 "" totalrecords integer - - 总记录数。 20 data ARRAY_REFERENCE 详细请参见表6。 PSK帐号数据列表。 -
  • URI /controller/campus/v1/authconfigservice/accessconfig/{siteId}/ppsk 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteId 是 string - - 站点ID,UUID格式。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e" 表2 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 account 否 string - - 帐号名称。 "PPSK001" ssidName 否 string - - SSID名称。 "Huawei-Guest" vlan 否 integer - - 帐号绑定的VLAN。 100 pageIndex 否 integer - - 页面索引。 1 pageSize 否 integer - - 每页显示记录数。 20
  • 响应示例 返回状态码为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,16 Feb 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"
  • 响应示例 返回状态码为200:删除成功,响应体参考BatchDeletePpskResponseDto。 HTTP/1.1 200 OK 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 { "errmsg" : "", "errcode" : "", "successList" : ["00000000000000000000000000000000"], "failList" : [ { "errmsg" : "", "errcode" : "0", "ppskId" : "00000000000000000000000000000000" } ] } 返回状态码为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
  • 请求示例 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-ACCESS-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"
  • 请求参数 表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"
  • 请求示例 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,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "" }
  • 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,16 Feb 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" }