本文导读

典型场景
接口功能
接口约束
调用方法
URI
请求参数
请求示例
响应参数
响应示例

展开导读

文档首页/ 华为乾坤/ 云管理网络/ API参考/ 接口参考/ 准入/ 用户上下线日志查询/ 查询用户radius上下线日志信息

查询用户radius上下线日志信息

更新时间：2025-02-17 GMT+08:00

查看PDF

典型场景

提供租户查询指定时间内用户RADIUS上下线信息，按分页返回查询结果。例如：查询8月1日至8月7号这段时间哪些用户上线过。

接口功能

页面功能：监控/事件日志/终端认证日志/RADIUS上下线日志/查询操作

根据租户ID查询指定时间内RADIUS上下线信息，每次最多返回101条数据，不足101条时表示当前数据已查询完；等于101条表示后续还有数据。下一页查询以上一次查询返回的endRowKey的值作为本次查询条件startRowKey的值。

接口约束

该接口支持租户下北向管理员（用户角色为“Open Api Operator”）访问，必须在用户会话建立后使用。

调用方法

POST

URI

/controller/campus/v1/accountservice/user/radiuslog

请求参数

表1 body参数列表
参数名称	必选	类型	参数值域	默认值	参数说明	参数示例
body	是	REFERENCE	详细请参见表2。		终端上下线radius日志查询条件	-

表2 QueryRadiusLogsInputDto对象的参数列表
参数名称	必选	类型	参数值域	默认值	参数说明	参数示例
branchId	否	string	-	-	拉远组件，预留。	""
logType	是	string	-	-	日志类型，取值范围：account--计费，authen--认证。	"authen"
siteId	否	UUID	-	-	站点ID，uuid格式，当queryMode为单站点查询模式，站点ID必填。	"bdfc1aa5-93dc-4a7d-87c6-8cee03f20f2e"
authenResultCode	否	int32	-	-	认证结果。取值范围：0--成功，1--失败。当logType为authen时，authenResultCode必填。	0
authenStartTime	否	int64	-	-	查询认证开始时间（接口调用方格林威治时间戳），单位：毫秒。当logType为authen时，authenStartTime必填。	1574208000000
authenEndTime	否	int64	-	-	查询认证截止时间（接口调用方格林威治时间戳），单位：毫秒。当logType为authen时，authenEndTime必填。查询时不允许查询时间跨度大于7天的数据。	1574726400000
failReasonCode	否	int32	-	0	认证失败原因，取值范围：0--全部 100--未知错误 101--帐号、密码或数据源错误或接入设备密钥配置错误 102--账号未配置接入参数 105--帐号因为多次口令校验失败，被临时锁定 106--帐号已过期 1060--无可用流量或在线时长 107--帐号被停用 108--超过帐号允许最大接入数 109--访客账号不支持1x认证 110--认证规则不允许使用该认证协议 111--终端接入MAC不匹配 112--终端接入IP不匹配 113--终端接入设备IP不匹配 114--终端接入设备端口不匹配 115--终端接入设备VLAN不匹配 116--认证超时 117--授权策略的授权结果为拒绝接入 118--不支持的客户端认证协议 121--未找到mac账号 125--PEAP或TLS协议内层身份验证失败 126--设备业务只支持PAP和CHAP，不支持EAP 127--mac地址被加入黑名单或白名单不存在该mac 128--License许可不足或者License已过期 129--客户端证书不是X509证书 130--客户端证书过期 131--未找到与对端证书匹配的根证书 132--证书停用或尚未生效 133--用户使用的证书在服务器上没有建立对应的映射帐号 135--远程RADIUS服务器认证失败 136--接入设备密钥配置错误 137--没有找到接入设备 138--没有License或者License已失效 139--匹配认证策略丢掉报文 140--帐号已被锁定 141--帐号未到起始生效时间 142--数据源连接不上 143--帐号的认证类型和数据源不一致 144--系统内部异常 145--终端接入IMSI不匹配 146--客户端校验服务器证书失败 147--AD/LDAP服务器返回密码过期 148--帐号被禁用 149--账号过期 151--帐号必须重设密码后才能登录 152--帐号不能在这个时间段登录 153--匹配不到授权规则 154--PEAP认证链路异常 155--超过RADIUS服务器最大允许接入数 156--该帐号类型不支持使用EAP-MSCHAPv2协议 157--该帐号不存在或者过期、禁用 158--该帐号不存在或者非本地帐号（非本地帐号不支持CHAP协议） 159--第三方RADIUS服务器认证超时 160--第三方RADIUS服务器认证失败 162--OCSP服务器校验失败 163--终端接入ESN不匹配 172--帐号不存在，验证失败 174--自学习接入参数绑定个数超上限 180--设备license存在问题 181--设备或RADIUS服务器配置错误 182--证书链校验错误 183--用户处于黑名单中 184--当前用户仅用于移动证书认证 185--用户登录类型不匹配 186--MAC帐号已过期 189--第三方HTTP服务器未启用 190--社交媒体认证未启用 191--Mac免认证缓存已过期 198--无可用终端即插即用License 300--获取运营商网络终端信息失败 301--运营商网络终端信息校验失败 302--运营商网络终端用户名或密码错误 303--运营商网络终端被加入黑名单 304--终端接入IMSI不匹配 305--终端接入IMEI不匹配 306--终端接入MSISDN不匹配 642--校验失败：动态验证码不正确或为空 643--校验失败：动态验证码过期 644--发送验证码失败：手机号未设置 645--发送验证码失败：邮箱未设置 646--发送验证码失败：短信网关未设置 647--发送验证码失败：未知错误 648--发送验证码失败：邮箱服务器未设置 649--不支持该帐号类型：不同步AD/LDAP帐号，或帐号不存在 2101--AD/LDAP服务器返回帐号禁用或时间段内不能登录 2106--linux环境下密码错误 2109--微软AD未知错误。当logType为authen时，且认证结果authenResultCode取1--失败时，failReasonCode必填。	0
terminalIp	否	string	-	-	该字段可能包含敏感信息和个人数据，请妥善做好保护。终端ip，既支持IPV4地址，也支持IPV6地址。	"10.2.3.2"
terminalMac	否	string	-	-	该字段可能包含敏感信息和个人数据，请妥善做好保护。终端mac地址，mac格式：XX-XX-XX-XX-XX-XX。	"XX-XX-XX-XX-XX-XX"
accessSsid	否	string	0~128个字符。	-	访问ssid。不支持模糊匹配。	"aacc1112"
imsi	否	string	0~20个字符。	-	该字段可能包含敏感信息和个人数据，请妥善做好保护。国际移动用户ID	"aacc1112"
imei	否	string	0~20个字符。	-	该字段可能包含敏感信息和个人数据，请妥善做好保护。国际移动设备ID	"aacc1112"
userTypeCode	否	int32	-	-	用户类型，取值范围：-1--全部，0--普通用户，1--短信注册用户，2--自注册用户，4--社交媒体用户，5--微信用户，6--Passcode用户，7--第三方用户，10--AD用户，11--PPSK用户，12---RADIUS Token用户，13--LDAP用户，14--SAML认证用户，20--普通访客，21--MAC帐号，22--第三方HTTP用户，23--未知用户，24--公共二维码用户，27--第三方数据库用户，64--匿名用户。	-1
userName	否	string	0~128个字符。	-	用户名。	"zhangsan123"
userGroupName	否	string	0~128个字符。	-	用户组名称。	"AA"
name	否	string	0~128个字符。	-	姓名。	"zhangsan"
authenTypeCode	否	int32	-	-	认证类型，取值范围：-1--全部，8--802.1X认证，9--MAC认知，11--Portal2.0/CMCC 认证，13--MAC免认证，14--设备管理认证，15--FW SSL VPN认证，16--CWA 认证，17--RADIUS中继认证，18--运营商网络终端认证，99--未知。	-1
authenServerIp	否	string	-	-	认证服务器ip，只支持IPV4。	"10.22.22.1"
accInitStartTime	否	int64	-	-	查询计费起始的开始时间（接口调用方格林威治时间戳），单位：毫秒。当logType为account时，accInitStartTime必填。	1574208000000
accInitEndTime	否	int64	-	-	查询计费起始的截止时间（接口调用方格林威治时间戳），单位：毫秒。当logType为account时，accInitEndTime必填。查询时不允许查询时间跨度大于7天的数据。	1574726400000
accTermStartTime	否	int64	-	-	查询计费结束的开始时间（接口调用方格林威治时间戳），单位：毫秒。	1574208000000
accTermEndTime	否	int64	-	-	查询计费结束的截止时间（接口调用方格林威治时间戳），单位：毫秒。	1574726400000
pageSize	是	int32	[1-101]	-	查询条数。	101
pageIndex	是	int32	-	-	查询页码，与startRowKey配合使用时建议取1。	1
startRowKey	否	string	-	-	起始rowkey（首次查询为空字符串，分页查询时取上一次查询结果endRowKey的值。	"1"
queryMode	否	string	ONE_SITE NOT_IN_SITE	ONE_SITE	查询模式：ONE_SITE--单站点，NOT_IN_SITE--未加入站点	"ONE_SITE"

请求示例

HTTP的示例

POST /controller/campus/v1/accountservice/user/radiuslog 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
{
	"branchId" : "",
	"logType" : "authen",
	"siteId" : "bdfc1aa5-93dc-4a7d-87c6-8cee03f20f2e",
	"authenResultCode" : 0,
	"authenStartTime" : 1574208000000,
	"authenEndTime" : 1574726400000,
	"failReasonCode" : 0,
	"terminalIp" : "10.2.3.2",
	"terminalMac" : "XX-XX-XX-XX-XX-XX",
	"accessSsid" : "aacc1112",
	"imsi" : "aacc1112",
	"imei" : "aacc1112",
	"userTypeCode" : -1,
	"userName" : "zhangsan123",
	"userGroupName" : "AA",
	"name" : "zhangsan",
	"authenTypeCode" : -1,
	"authenServerIp" : "10.22.22.1",
	"accInitStartTime" : 1574208000000,
	"accInitEndTime" : 1574726400000,
	"accTermStartTime" : 1574208000000,
	"accTermEndTime" : 1574726400000,
	"pageSize" : 101,
	"pageIndex" : 1,
	"startRowKey" : "1",
	"queryMode" : "ONE_SITE"
}

响应参数

返回状态码为200：查询成功，响应体参考QueryRadiusLogsOutputDto。

表3 QueryRadiusLogsOutputDto对象的参数列表
参数名称	类型	参数值域	默认值	参数说明	参数示例
errcode	string	0~32个字符。	-	错误码。	"0"
errmsg	string	0~512个字符。	-	错误信息。	""
startRowKey	string	0~256个字符。	-	查询结果中起始rowkey值。	"1529648614575D431E4891D734D68B89FD14BAC639C47"
endRowKey	string	0~256个字符。	-	查询结果中结束rowkey值。	"15296432844906C2BC8D50ED94D9A87C4660E418E6472"
totalSize	int64	-	-	当前页查询总条数。	101
pageSize	int32	[1-101]	-	查询条数。	101
pageIndex	int32	-	-	查询页码。	1
data	ARRAY_REFERENCE	0-101个列表项，详细请参见表4。		日志详情。	-

表4 RadiusLogInfoDto对象的参数列表
参数名称	类型	参数值域	默认值	参数说明	参数示例
id	string	-	-	RADIUS日志id。	"1bfa53069969491bbe495fcbb65c486a"
siteName	string	0~64个字符。	-	站点名称。	"AA"
userName	string	0~128个字符。	-	用户名。	"user1"
userGroupName	string	0~128个字符。	-	用户组名称。	"Guest"
userTypeCode	int32	-	-	用户类型，取值范围：0--普通用户，1--短信注册用户，2--自注册用户，4--社交媒体用户，5--微信用户，6--Passcode用户，7--第三方用户，10--AD用户，11--PPSK用户，12---RADIUS Token用户，13--LDAP用户，14--SAML认证用户，20--普通访客，21--MAC帐号，22--第三方HTTP用户，23--未知用户，24--公共二维码用户，27--第三方数据库用户，64--匿名用户。	0
terminalIpV4	string	-	-	该字段可能包含敏感信息和个人数据，请妥善做好保护。终端ipv4地址。	"10.85.73.8"
terminalIpV6	string	-	-	该字段可能包含敏感信息和个人数据，请妥善做好保护。终端ipv6地址。	""
terminalMac	string	-	-	该字段可能包含敏感信息和个人数据，请妥善做好保护。终端mac地址，mac格式：XX-XX-XX-XX-XX-XX。	"XX-XX-XX-XX-XX-XX"
deviceIp	string	-	-	设备ip。	"10.165.34.179"
deviceMac	string	-	-	设备mac，mac格式：XX:XX:XX:XX:XX:XX。	"XX-XX-XX-XX-XX-XX"
authenRule	string	0~30个字符。	-	认证规则名称。	"Default"
authorRule	string	0~128个字符。	-	授权规则名称。	""
authenTypeCode	int32	-	-	认证类型，取值范围：8--802.1X认证，9--MAC认知，11--Portal2.0/CMCC 认证，13--MAC免认证，14--设备管理认证，15--FW SSL VPN认证，16--CWA 认证，17--RADIUS中继认证，18--运营商网络终端认证，99--未知。	8
authenServerIp	string	-	-	认证服务器ip。	"192.168.5.202"
accessSsid	string	0~128个字符。	-	ssid名称。	"1234"
authenTime	string	-	-	认证时间，时间戳，单位：毫秒。	"1574208000000"
authenResultCode	int32	-	-	认证结果。取值范围：0--成功，1--失败。	0
failReasonCode	int32	-	-	认证失败原因，取值范围： 100--未知错误 101--帐号、密码或数据源错误或接入设备密钥配置错误 102--账号未配置接入参数 105--帐号因为多次口令校验失败，被临时锁定 106--帐号已过期 1060--无可用流量或在线时长 107--帐号被停用 108--超过帐号允许最大接入数 109--访客账号不支持1x认证 110--认证规则不允许使用该认证协议 111--终端接入MAC不匹配 112--终端接入IP不匹配 113--终端接入设备IP不匹配 114--终端接入设备端口不匹配 115--终端接入设备VLAN不匹配 116--认证超时 117--授权策略的授权结果为拒绝接入 118--不支持的客户端认证协议 121--未找到mac账号 125--PEAP或TLS协议内层身份验证失败 126--设备业务只支持PAP和CHAP，不支持EAP 127--mac地址被加入黑名单或白名单不存在该mac 128--License许可不足或者License已过期 129--客户端证书不是X509证书 130--客户端证书过期 131--未找到与对端证书匹配的根证书 132--证书停用或尚未生效 133--用户使用的证书在服务器上没有建立对应的映射帐号 135--远程RADIUS服务器认证失败 136--接入设备密钥配置错误 137--没有找到接入设备 138--没有License或者License已失效 139--匹配认证策略丢掉报文 140--帐号已被锁定 141--帐号未到起始生效时间 142--数据源连接不上 143--帐号的认证类型和数据源不一致 144--系统内部异常 145--终端接入IMSI不匹配 146--客户端校验服务器证书失败 147--AD/LDAP服务器返回密码过期 148--帐号被禁用 149--账号过期 151--帐号必须重设密码后才能登录 152--帐号不能在这个时间段登录 153--匹配不到授权规则 154--PEAP认证链路异常 155--超过RADIUS服务器最大允许接入数 156--该帐号类型不支持使用EAP-MSCHAPv2协议 157--该帐号不存在或者过期、禁用 158--该帐号不存在或者非本地帐号（非本地帐号不支持CHAP协议） 159--第三方RADIUS服务器认证超时 160--第三方RADIUS服务器认证失败 162--OCSP服务器校验失败 163--终端接入ESN不匹配 172--帐号不存在，验证失败 174--自学习接入参数绑定个数超上限 180--设备license存在问题 181--设备或RADIUS服务器配置错误 182--证书链校验错误 183--用户处于黑名单中 184--当前用户仅用于移动证书认证 185--用户登录类型不匹配 186--MAC帐号已过期 189--第三方HTTP服务器未启用 190--社交媒体认证未启用 191--Mac免认证缓存已过期 198--无可用终端即插即用License 300--获取运营商网络终端信息失败 301--运营商网络终端信息校验失败 302--运营商网络终端用户名或密码错误 303--运营商网络终端被加入黑名单 304--终端接入IMSI不匹配 305--终端接入IMEI不匹配 306--终端接入MSISDN不匹配 642--校验失败：动态验证码不正确或为空 643--校验失败：动态验证码过期 644--发送验证码失败：手机号未设置 645--发送验证码失败：邮箱未设置 646--发送验证码失败：短信网关未设置 647--发送验证码失败：未知错误 648--发送验证码失败：邮箱服务器未设置 649--不支持该帐号类型：不同步AD/LDAP帐号，或帐号不存在 2101--AD/LDAP服务器返回帐号禁用或时间段内不能登录 2106--linux环境下密码错误 2109--微软AD未知错误。	101
accInitTime	string	-	-	计费开始时间，时间戳，单位：毫秒。	"1574208000001"
accTermTime	string	-	-	计费结束时间，时间戳，单位：毫秒。	"1574208000002"
accTermReasonCode	int32	-	-	下线原因，取值范围： 1--设备发起计费停止请求 11--在线用户的授权规则变更 14--帐号过期下线 15--超过流量或在线时长 16--管理员强制下线。 18--设备与radius服务器的心跳超时 19--CWA账号Portal侧注销下线 20--Portal侧CWA新账号上线 21--设备异常，强制用户下线 22--终端异常下线 23--用户主动下线 24--设备主动下线或终端断开连接	1
imsi	string	-	-	该字段可能包含敏感信息和个人数据，请妥善做好保护。 imsi	"150000000000000"
imei	string	-	-	该字段可能包含敏感信息和个人数据，请妥善做好保护。 imei	"150000000000000"
mobileTerminalInfo	string	-	-	该字段可能包含敏感信息和个人数据，请妥善做好保护。移动终端信息	"APN={APN},MSISDN={MSISDN},ULI={ULI},RAT={RAT}"
name	string	0~64个字符。	-	该字段可能包含敏感信息和个人数据，请妥善做好保护。姓名	""
serialnumber	string	0~64个字符。	-	证书认证客户端证书序列号。	"D01E40900000274B0000000100000004"
extraInfo	string	-	-	日志扩展信息	""

返回状态码为400：校验异常。

详细信息请参见实际响应消息体。

返回状态码为500：内部错误。

详细信息请参见实际响应消息体。

响应示例

返回状态码为200：查询成功，响应体参考QueryRadiusLogsOutputDto。

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" : "",
	"startRowKey" : "1529648614575D431E4891D734D68B89FD14BAC639C47",
	"endRowKey" : "15296432844906C2BC8D50ED94D9A87C4660E418E6472",
	"totalSize" : 101,
	"pageSize" : 101,
	"pageIndex" : 1,
	"data" : [
		{
			"id" : "1bfa53069969491bbe495fcbb65c486a",
			"siteName" : "AA",
			"userName" : "user1",
			"userGroupName" : "Guest",
			"userTypeCode" : 0,
			"terminalIpV4" : "10.85.73.8",
			"terminalIpV6" : "",
			"terminalMac" : "XX-XX-XX-XX-XX-XX",
			"deviceIp" : "10.165.34.179",
			"deviceMac" : "XX-XX-XX-XX-XX-XX",
			"authenRule" : "Default",
			"authorRule" : "",
			"authenTypeCode" : 8,
			"authenServerIp" : "192.168.5.202",
			"accessSsid" : "1234",
			"authenTime" : "1574208000000",
			"authenResultCode" : 0,
			"failReasonCode" : 101,
			"accInitTime" : "1574208000001",
			"accTermTime" : "1574208000002",
			"accTermReasonCode" : 1,
			"imsi" : "150000000000000",
			"imei" : "150000000000000",
			"mobileTerminalInfo" : "APN={APN},MSISDN={MSISDN},ULI={ULI},RAT={RAT}",
			"name" : "",
			"serialnumber" : "D01E40900000274B0000000100000004",
			"extraInfo" : ""
		}
	]
}

返回状态码为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

父主题： 用户上下线日志查询

上一篇：用户上下线日志查询

下一篇：查询用户portal上下线日志信息

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

查询用户radius上下线日志信息

典型场景

接口功能

接口约束

调用方法

URI

请求参数

请求示例

响应参数

响应示例

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线

文档反馈