云服务器内容精选

  • URI /controller/cloud/v2/northbound/accessuser/haca/authorizationresult/{terminalid} 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 terminalid 是 string - - 终端ID, 长度1-128。 "5ea660be98a84618fa3d6d03f65f47ab578ba3b4216790186a932f9e8c8c880d" 表2 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 nodeIp 否 string - - 授权节点地址,ipv4地址。 "192.168.211.236"
  • 响应示例 返回状态码为200:添加成功。响应体参考CommonAuthorizationOutputDto。 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 { "errcode" : "0", "errmsg" : "", "psessionid" : "5ea660be98a84618fa3d6d03f65f47ab578ba3b4216790186a932f9e8c8c880d" } 返回状态码为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
  • 请求示例 HTTP的示例 GET /controller/cloud/v2/northbound/accessuser/haca/authorizationresult/5ea660be98a84618fa3d6d03f65f47ab578ba3b4216790186a932f9e8c8c880d?nodeIp=192.168.211.236 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:查询成功。响应体参考CutUserOutputDto。 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 { "errcode" : "0", "errmsg" : "", "success" : [ { "message" : "success", "psessionid" : "5ea660be98a84618fa3d6d03f65f47ab578ba3b4216790186a932f9e8c8c880d" } ], "failure" : [ { "message" : "success", "psessionid" : "5ea660be98a84618fa3d6d03f65f47ab578ba3b4216790186a932f9e8c8c880d" } ] } 返回状态码为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
  • 请求示例 HTTP的示例 POST /controller/cloud/v2/northbound/accessuser/haca/cutuser 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 { "thirdUserInfos" : [ { "deviceMac" : "XX-XX-XX-XX-XX-XX", "deviceEsn" : "21500829352SG5900059", "terminalIpV4" : "10.66.85.177", "terminalIpV6" : "FC00::1101", "terminalMac" : "XX-XX-XX-XX-XX-XX", "userName" : "test", "psessionid" : "5ea660be98a84618fa3d6d03f65f47ab578ba3b4216790186a932f9e8c8c880d", "nodeIp" : "192.168.211.236" } ] }
  • 响应参数 返回状态码为200:查询成功。响应体参考CutUserOutputDto。 表4 CutUserOutputDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息描述。 "" success ARRAY_REFERENCE 详细请参见表5。 成功下线用户信息。 - failure ARRAY_REFERENCE 详细请参见表5。 下线失败用户信息。 - 表5 CutUserData对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 message string - - 成功结果。 "success" psessionid string - - 用户会话ID, 长度1-128。 "5ea660be98a84618fa3d6d03f65f47ab578ba3b4216790186a932f9e8c8c880d" 返回状态码为400:校验异常。 详细信息请参见实际响应消息体。 返回状态码为500:内部错误。 详细信息请参见实际响应消息体。
  • 请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 body 是 REFERENCE 详细请参见表2。 用户信息。 - 表2 CutUserInputDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 thirdUserInfos 否 ARRAY_REFERENCE 1-100个列表项,详细请参见表3。 三方认证用户信息 - 表3 thirdUserInfoData对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 deviceMac 否 string - - 设备MAC地址,MAC和ESN至少有一个必填,大小写不敏感,支持的格式:xx-xx-xx-xx-xx-xx/xx:xx:xx:xx:xx:xx/xxxxxxxxxxxx。 "XX-XX-XX-XX-XX-XX" deviceEsn 否 string - - 设备ESN地址,MAC和ESN至少有一个必填。 "21500829352SG5900059" terminalIpV4 否 string - - 该字段可能包含敏感信息和个人数据,请妥善做好保护。 终端IPV4地址,terminalIpV4和terminalIpV6有且只有一个。 "10.66.85.177" terminalIpV6 否 string - - 该字段可能包含敏感信息和个人数据,请妥善做好保护。 终端IPV6地址,terminalIpV4和terminalIpV6有且只有一个,Ipv6地址例如:FC00::1101。 "FC00::1101" terminalMac 是 string - - 该字段可能包含敏感信息和个人数据,请妥善做好保护。 终端MAC,大小写不敏感,支持的格式:xx-xx-xx-xx-xx-xx/xx:xx:xx:xx:xx:xx/xxxxxxxxxxxx。 "XX-XX-XX-XX-XX-XX" userName 是 string - - 用户名,不支持模糊匹配。 "test" psessionid 是 string - - 会话ID,长度1-128。 "5ea660be98a84618fa3d6d03f65f47ab578ba3b4216790186a932f9e8c8c880d" nodeIp 否 string - - 授权节点地址,ipv4地址。 "192.168.211.236"
  • 响应示例 返回状态码为200:操作成功,返回会话ID。响应体参考CommonAuthorizationOutputDto。 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 { "errcode" : "0", "errmsg" : "", "psessionid" : "5ea660be98a84618fa3d6d03f65f47ab578ba3b4216790186a932f9e8c8c880d" } 返回状态码为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
  • 请求示例 HTTP的示例 POST /controller/cloud/v2/northbound/accessuser/haca/authorization 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 { "deviceMac" : "XX-XX-XX-XX-XX-XX", "deviceEsn" : "21500829352SG5900059", "apMac" : "XX-XX-XX-XX-XX-XX", "ssid" : "dcd=", "policyName" : "aa", "terminalIpV4" : "10.66.85.177", "terminalIpV6" : "FC00::1101", "terminalMac" : "XX-XX-XX-XX-XX-XX", "userName" : "test", "nodeIp" : "10.1.1.1", "temPermitTime" : 300, "thirdAuthType" : 3, "userGroupName" : "ROOT1", "telephone" : "15000000000" }
  • 响应参数 返回状态码为200:操作成功,返回会话ID。响应体参考CommonAuthorizationOutputDto。 表3 CommonAuthorizationOutputDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息描述。 "" psessionid string - - 会话ID。 "5ea660be98a84618fa3d6d03f65f47ab578ba3b4216790186a932f9e8c8c880d" 返回状态码为400:校验异常。 详细信息请参见实际响应消息体。 返回状态码为500:内部错误。 详细信息请参见实际响应消息体。
  • 请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 body 是 REFERENCE 详细请参见表2。 授权信息。 - 表2 UserAuthorizationInputDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 deviceMac 否 string - - 设备MAC地址,MAC和ESN至少有一个必填,大小写不敏感,支持的格式:xx-xx-xx-xx-xx-xx/xx:xx:xx:xx:xx:xx/xxxxxxxxxxxx。 "XX-XX-XX-XX-XX-XX" deviceEsn 否 string - - 设备ESN地址,MAC和ESN至少有一个必填。 "21500829352SG5900059" apMac 否 string - - AP的MAC地址,大小写不敏感,支持的格式:xx-xx-xx-xx-xx-xx/xx:xx:xx:xx:xx:xx/xxxxxxxxxxxx。 "XX-XX-XX-XX-XX-XX" ssid 是 string - - AP SSID名称的BASE64编码,交换机有线场景,SSID名称固定使用“PUxzd1NzaWRQbGFjZWhvbGRlcj0=”。 "dcd=" policyName 否 string - - 授权结果名称,只支持精确匹配,不支持中文。约束:该授权结果必须被任意一条开启HACA协议的授权规则绑定。 "aa" terminalIpV4 否 string - - 该字段可能包含敏感信息和个人数据,请妥善做好保护。 终端IPV4地址,terminalIpV4和terminalIpV6有且只有一个必填。 "10.66.85.177" terminalIpV6 否 string - - 该字段可能包含敏感信息和个人数据,请妥善做好保护。 终端IPV6地址,terminalIpV4和terminalIpV6有且只有一个必填,Ipv6地址例如:FC00::1101。 "FC00::1101" terminalMac 是 string - - 该字段可能包含敏感信息和个人数据,请妥善做好保护。 终端MAC,大小写不敏感,支持的格式:xx-xx-xx-xx-xx-xx/xx:xx:xx:xx:xx:xx/xxxxxxxxxxxx。 "XX-XX-XX-XX-XX-XX" userName 是 string - - 用户名,不支持模糊匹配。 "test" nodeIp 否 string - - 授权节点地址,ipv4地址。 "10.1.1.1" temPermitTime 否 int32 [0-360000] - 用户剩余时长,单位秒。报文中不传递此参数或取值为0时,终端用户访问网络无时间限制。 300 thirdAuthType 否 int32 [1-7] 7 第三方认证方式,不传递此参数时,默认为第三方认证。1-用户名密码,2-匿名认证,3-短信认证,4-社交媒体认证,5-微信认证,6-Passcode认证,7-第三方认证 3 userGroupName 否 string 0~128个字符。 - 用户组。 "ROOT1" telephone 否 string 0~32个字符。 - 电话号码。 "15000000000"