查询用户日志

接口说明

面向政企版租户开放日志管理-用户日志接口 业务逻辑:支持通过操作类型、操作结果、时间选择(开始时间和结束时间)、登录账号/电脑ID/设备型号/设备id/设备IP/设备MAC地址的分页查询用户日志,信息包括登录账号、操作类型、操作时间、客户端(类型和版本号)、客户端IP、电脑ID、租户名称、设备型号、设备id、设备IP、设备MAC地址、操作结果、失败原因,支持分页查询(单页默认10,最大50)。 限流:根据租户实现用户级别的限流,限制为100次每秒


推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

URL

POST https://ecloud.10086.cn/api/Computer_api/cem_openapi/ccacem/api/v1/operation/userLoginInfo/page

请求参数

Body

参数名称
类型
必填
描述
userLoginInfoReqDto
CcempUserLoginInfoReqDtos
是

userLoginInfoReqDto

deviceModel
string
否

设备型号

deviceUid
string
否

设备id

endTime
string
否

结束时间

ipAddress
string
否

设备ip地址

macAddress
string
否

设备Mac地址

machineId
string
否

云电脑id

mopUserName
string
否

租户名称

operationResult
string
否

操作结果 0 是成功 ;1 是失败

operationType
string
否

操作类型 0 是登录 ;1 是登出

startTime
string
否

开始时间

userName
string
否

登录账号

page
string
否

当前页

pageSize
string
否

分页大小

请求示例

POST https://ecloud.10086.cn/api/Computer_api/cem_openapi/ccacem/api/v1/operation/userLoginInfo/page
{
	"deviceModel":"HUAWEI QingYun L420 KLVV-W5821D",
	"deviceUid":"73589e84-828a-42b7-8f89-02f6aa101a93",
	"userName":"jql.Aeshi001",
	"ipAddress":"100.72.1.7",
	"macAddress":"fc:86:2a:b6:fd:c8",
	"machineId":null,
	"mopUserName":"csy_csb_saas_test_008",
	"operationResult":"0",
	"operationType":"0",
	"startTime":"2024-08-14 00:00:00",
	"endTime":"2024-08-14 23:59:59",
	"page":"1",
	"pageSize":"10"
}

返回参数

返回码:200
OK
参数名称
类型
描述
body
CcempUserLoginInfoRespDto
records
<LoginRecords> array

成功集合

userName
string

用户名

mopUserName
string

租户名称

operationType
string

操作类型: 0 是登录 ;1 是登出

operationResult
string

操作结果: 0 是成功 ;1 是失败

operationTime
integer(int64)

操作时间

operateDate
string

操作时间 yyyy-MM-dd HH:mm:ss

clientType
string

客户端版本类型

clientVersion
string

客户端版本号

userId
string

用户Id

ipAddr
string

客户端ip

operateFailReason
string

失败原因

machineId
string

云电脑id

userType
string

用户类型: 0 是公众版用户 ;1 是政企版用户

deviceName
string

设备名称

deviceModel
string

设备型号

deviceUid
string

设备id

ipAddress
string

设备ip地址

macAddress
string

设备Mac地址

loginTime
integer(int64)

登录时间

logoutTime
integer(int64)

登出时间

errorCode
string
errorMessage
string
requestId
string
state
enum(OK,ERROR,EXCEPTION,FORBIDDEN,REMAINING,TIMEOUT)

返回示例

返回码:200
OK
{
	"state":"OK",
	"body":{
		"records":[
			{
				"userName":"jql.Aeshi001",
				"mopUserName":"csy_csb_saas_test_008",
				"operationType":"0",
				"operationResult":"0",
				"operationTime":1723109834000,
				"operateDate":null,
				"clientType":"linux_arm64",
				"clientVersion":"3.1.3",
				"userId":"1760915093129457665",
				"ipAddr":"100.72.1.7",
				"operateFailReason":null,
				"machineId":null,
				"userType":"1",
				"deviceName":"ecloudComputer-PC",
				"deviceModel":"HUAWEI QingYun L420 KLVV-W5821D",
				"deviceUid":"73589e84-828a-42b7-8f89-02f6aa101a93",
				"ipAddress":"192.168.155.3",
				"macAddress":"fc:86:2a:b6:fd:c8",
				"loginTime":1723109834000,
				"logoutTime":null
			}
		]
	},
	"errorCode":"200",
	"errorMessage":"",
	"requestId":"124861b13e39430797585ba5ed6c9494"
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。