在线用户管理-华为云

华为乾坤-查询在线用户:响应示例

响应示例返回状态码为200：查询成功。响应体参考QueryPortalOnlineUserInfoOutputDto。 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" : "", "totalRecords" : 1, "data" : [ { "id" : "2eab8922-a37d-4355-9788-33caade63b5a", "userId" : "43218922-a37d-43b2-9788-33caade63b5a", "userName" : "user1", "userGroupId" : "12345678-a37d-43b2-9788-33caade63b", "userGroupName" : "ROOT\\Guest", "siteId" : "11111111-a37d-43b2-9788-33caade63b5a", "loginTime" : 1541389780672, "deviceId" : "34567890-a37d-43b2-9788-33caade63b5a", "accessPolicy" : "policy_for_guest", "onlineuserTerminalIp" : "10.10.10.10", "terminalMac" : "XX-XX-XX-XX-XX-XX", "ssid" : "portal-guest", "authMode" : "1", "userType" : "0", "imsi" : "150000000000000", "imei" : "150000000000000", "mobileTerminalInfo" : "APN={APN},MSISDN={MSISDN},ULI={ULI},RAT={RAT}", "name" : "", "authPolicy" : "authrule01", "uclGroupName" : "uclGroup01", "terminalDeviceType" : "Mobile Phone/Huawei/Mate 30 5G", "osName" : "Google/Android/Android 4.4.X", "remoteIAEName" : "IAE01", "deviceIp" : "10.10.10.10", "devicePort" : "GigabitEthernet0/0/8", "deviceVlan" : "1", "accessResultId" : "44567890-a37d-43b2-9788-33caade63b5b", "accessResultName" : "accessResult01", "nasPortId" : "slot=0;sublot=0;port=8;vlanid=1;interfaceName=GigabitEthernet0/0/8", "telephone" : "8615000000000", "accessDeviceIp" : "10.10.10.10", "accessDevicePort" : "GigabitEthernet0/0/8", "accessDeviceVlan" : "1", "accessDeviceMac" : "XX-XX-XX-XX-XX-XX", "natTerminalIp" : "10.10.10.10", "natStartPort" : "10235", "natEndPort" : "10260", "autoAccess" : false, "hasMdmInfo" : false, "role" : "", "securityGroupId" : "", "stationId" : "", "sysName" : "", "terminalGroup" : "", "vipType" : "", "bypassScene" : "", "externalGroupName" : "/group" } ] } ] 返回状态码为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

华为乾坤在线用户管理

华为乾坤-查询在线用户:响应参数

响应参数返回状态码为200：查询成功。响应体参考QueryPortalOnlineUserInfoOutputDto。表2 QueryPortalOnlineUserInfoOutputDto对象的参数列表参数名称类型参数值域默认值参数说明参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" totalRecords int32 - - 总行数 1 data ARRAY_REFERENCE 详细请参见表3。在线用户详情 - 表3 PortalOnlineUserInfoDto对象的参数列表参数名称类型参数值域默认值参数说明参数示例 id string - - 在线用户ID。UUID格式 "2eab8922-a37d-4355-9788-33caade63b5a" userId string - - 用户ID。UUID格式 "43218922-a37d-43b2-9788-33caade63b5a" userName string - - 用户名。 "user1" userGroupId string - - 用户组ID。UUID格式 "12345678-a37d-43b2-9788-33caade63b" userGroupName string - - 用户组名。 "ROOT\\Guest" siteId string - - 站点ID。UUID格式 "11111111-a37d-43b2-9788-33caade63b5a" loginTime int64 - - 登录时间。 1541389780672 deviceId string - - 设备id。UUID格式 "34567890-a37d-43b2-9788-33caade63b5a" accessPolicy string - - 认证策略名。 "policy_for_guest" onlineuserTerminalIp string - - 该字段可能包含敏感信息和个人数据，请妥善做好保护。认证终端IP。 "10.10.10.10" terminalMac string - - 该字段可能包含敏感信息和个人数据，请妥善做好保护。认证终端MAC。 "XX-XX-XX-XX-XX-XX" ssid string - - SSID。 "portal-guest" authMode int64 - - 认证方式。 "1" userType int64 - - 用户类型。 "0" imsi string - - 该字段可能包含敏感信息和个人数据，请妥善做好保护。 imsi "150000000000000" imei string - - 该字段可能包含敏感信息和个人数据，请妥善做好保护。 imei "150000000000000" mobileTerminalInfo string - - 该字段可能包含敏感信息和个人数据，请妥善做好保护。移动终端信息 "APN={APN},MSISDN={MSISDN},ULI={ULI},RAT={RAT}" name string 0~64个字符。 - 该字段可能包含敏感信息和个人数据，请妥善做好保护。姓名 "" authPolicy string 0~128个字符。 - 认证规则名称 "authrule01" uclGroupName string 0~128个字符。 - 安全组名称 "uclGroup01" terminalDeviceType string 0~128个字符。 - 终端设备类型 "Mobile Phone/Huawei/Mate 30 5G" osName string 0~128个字符。 - 操作系统 "Google/Android/Android 4.4.X" remoteIAEName string 0~128个字符。 - 拉远组件名称 "IAE01" deviceIp string 0~32个字符。 - 设备Ip "10.10.10.10" devicePort string 0~32个字符。 - 设备端口 "GigabitEthernet0/0/8" deviceVlan string 0~8个字符。 - 设备Vlan "1" accessResultId string 32~36个字符。 - 授权结果Id "44567890-a37d-43b2-9788-33caade63b5b" accessResultName string 0~128个字符。 - 授权结果名称 "accessResult01" nasPortId string 0~256个字符。 - 认证设备端口vlan详细信息 "slot=0;sublot=0;port=8;vlanid=1;interfaceName=GigabitEthernet0/0/8" telephone string 0~32个字符。 - 电话号码 "8615000000000" accessDeviceIp string 0~32个字符。 - 接入设备Ip "10.10.10.10" accessDevicePort string 0~32个字符。 - 接入设备端口 "GigabitEthernet0/0/8" accessDeviceVlan string 0~8个字符。 - 接入设备Vlan "1" accessDeviceMac string 0~32个字符。 - 接入设备MAC "XX-XX-XX-XX-XX-XX" natTerminalIp string 0~32个字符。 - 公网Ip地址 "10.10.10.10" natStartPort string 0~8个字符。 - 公网地址起始端口 "10235" natEndPort string 0~8个字符。 - 公网地址结束端口 "10260" autoAccess boolean true false - 是否自动接入。默认值为false。 false hasMdmInfo boolean true false - 是否有mdm信息。默认值为false。 false role string 0~64个字符。 - 角色名称 - securityGroupId string 32~36个字符。 - 安全组id - stationId string 32~36个字符。 - Radius属性携带的Called-Station-Id字段，一般为认证设备标识信息 - sysName string 0~64个字符。 - 系统名称 - terminalGroup string 32~36个字符。 - 终端组id - vipType int32 [0-100] - vip类型 - bypassScene string 0~1个字符。 - 是否逃生场景 '0' 非逃生 '1' 逃生 - externalGroupName string 0~1024个字符。 - 外部组名称 "/group" 返回状态码为400：操作失败。详细信息请参见实际响应消息体。返回状态码为500：内部错误。详细信息请参见实际响应消息体。

华为乾坤在线用户管理

华为乾坤-查询在线用户:请求示例

请求示例 HTTP的示例 GET /controller/campus/v1/accountservice/onlineusers?userType=0&authMode=1&pageIndex=1&pageSize=20&userName=user1&beginTimeLong=1541389780672&endTimeLong=1541390000000&accessPolicy=policy_for_guest&terminalIp=10.10.10.10&terminalMac=XX-XX-XX-XX-XX-XX&ssid=portal-guest&userGroupId=2eab8922-a37d-43b2-9788-33caade63b5a&siteId=2eab8922-a37d-43b2-9788-33caade63b5a&name=yonghuxingming&bypassScene=0 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

华为乾坤在线用户管理

华为乾坤-查询在线用户:URI

URI /controller/campus/v1/accountservice/onlineusers 表1 query参数列表参数名称必选类型参数值域默认值参数说明参数示例 userType 否 string 0 1 2 4 5 6 7 10 11 12 13 14 20 21 22 24 27 64 - 用户类型：0：普通用户 1：短信注册用户 2：自注册用户 4：社交媒体用户 5：微信用户 6：Passcode用户 7：第三方用户 10：AD用户 11：PPSK用户 12：RADIUS Token用户 13：LDAP用户 14：SAML认证用户 20：普通访客 21：MAC帐号 22：第三方HTTP用户 24：公共二维码 27：已废弃 64：匿名用户。如果不填，查询所有类型。 "0" authMode 否 string 1 2 3 4 8 9 10 11 13 14 15 16 17 18 - 认证方式：1：Portal HACA认证。2、Mac免认证。3、第三方认证。4、PPSK。8、802.1x。9、Mac。10、云平台中继Radius认证。11、Portal2.0/CMCC认证。13、第三方HTTP认证。14、设备管理认证。15、FW SSL VPN认证。16、Portal2.0 Mac免认证。17、Radius中继认证。18、运营商网络终端认证。如果不填，查询所有类型。 "1" pageIndex 否 int32 - 1 起始页。 1 pageSize 否 int32 [20-100] 20 分页大小。 20 userName 否 string - - 用户名。用户名使用模糊查询。 "user1" beginTimeLong 否 int64 - - 查询起始时间。 1541389780672 endTimeLong 否 int64 - - 查询结束时间。 1541390000000 accessPolicy 否 string - - 认证策略名。 "policy_for_guest" terminalIp 否 string - - 认证终端IP。 "10.10.10.10" terminalMac 否 string - - 认证终端MAC，大小写敏感，MAC地址只支持一种格式：XX-XX-XX-XX-XX-XX。 "XX-XX-XX-XX-XX-XX" ssid 否 string - - SSID。 "portal-guest" userGroupId 否 string - - 用户组ID。UUID格式 "2eab8922-a37d-43b2-9788-33caade63b5a" siteId 否 string - - 站点ID。UUID格式 "2eab8922-a37d-43b2-9788-33caade63b5a" name 否 string 0~128个字符。 - 姓名 "yonghuxingming" bypassScene 否 string 0~1个字符。 - 是否逃生场景 "0"

华为乾坤在线用户管理

华为乾坤-管理员强制在线用户下线:请求示例

请求示例 HTTP的示例 POST /controller/campus/v1/accountservice/onlineusers/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 { "onlineUserIds" : [ "2eab8922-a37d-4355-9788-33caade63b5a" ], "userType" : 5 }

华为乾坤在线用户管理

华为乾坤-管理员强制在线用户下线:响应示例

响应示例返回状态码为200：操作成功。响应体参考CutPortalOnlineUserOutputDto。 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" : "Partially successful.", "success" : [ "2eab8922-a37d-4355-9788-33caade63b5a" ], "failure" : [ { "errcode" : "3201", "errmsg" : "The parameter is incorrect, the user does not exist, or the user has gone offline.", "data" : "aaab8922-a37d-4355-9788-33caade63b5a" } ] } 返回状态码为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

华为乾坤在线用户管理

云服务器内容精选

在线用户管理

7*24

备案

专业服务

退订

建议反馈

售前咨询热线