查询连接使用统计

接口说明

面向政企版租户开放使用统计-连接维度 业务逻辑:支持查看时间段内已售电脑中每个电脑连接数据统计,信息包括:电脑连接次数、使用总时长、平均使用时长、最长使用时长、最近一次连接时间,支持分页查询(单页默认10,最大50)。 限流:根据租户实现用户级别的限流,限制为100次每秒


推荐使用API Explorer调试

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

URL

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

请求参数

Body

参数名称
类型
必填
描述
connectUsageStatReqDto
CcempConnectUsageStatReqDto
是

connectUsageStatReqDto

machineName
string
否

电脑名称

machineId
string
否

电脑id

userName
string
否

用户名

startTime
string
是

开始时间

endTime
string
是

结束时间

page
integer(int32)
是

当前页

pageSize
integer(int32)
是

分页大小

请求示例

POST https://ecloud.10086.cn/api/Computer_api/cem_openapi/ccacem/api/v1/operation/connectUsageStatistics/page
{
	"startTime":"2025-04-08 00:00:00",
	"endTime":"2025-04-14 23:59:59",
	"page":"1",
	"pageSize":"10"
}

返回参数

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

使用统计数据列表

avgOnlineTime
string

平均在线时长

companyName
string

所属企业

connectCount
string

连接次数

latestOnlineTime
integer(int64)

最近一次连接时间

longestOnlineTime
string

最长在线时长

machineId
string

桌面Id

machineName
string

桌面名称

mopUserName
string

租户名

onlineTotalTime
string

在线总时长

orderSourceCode
string

所属渠道code

orderSourceName
string

所属渠道

tenantId
integer(int64)

租户表主键Id

userId
string

用户id

userName
string

用户名/授权用户

total
integer(int32)

总数据数

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

返回示例

返回码:200
OK
{
	"state":"OK",
	"body":{
		"records":[
			{
				"machineId":"ece7802e-81b9-486c-8e09-07826565834d",
				"machineName":"二轮_麒麟",
				"tenantId":2,
				"mopUserName":"test",
				"userId":"1904732539063758849",
				"userName":"V240_haha",
				"companyName":"企业测试",
				"orderSourceName":"云管分配",
				"orderSourceCode":"0",
				"connectCount":"45",
				"onlineTotalTime":"3小时21分",
				"avgOnlineTime":"4分",
				"latestOnlineTime":1744642740343,
				"longestOnlineTime":"47分"
			},
			{
				"machineId":"06d3e230-53a7-46e0-91c6-4892bb594f08",
				"machineName":"我的电脑",
				"tenantId":2,
				"mopUserName":"test",
				"userId":"1904057710737551362",
				"userName":"lty",
				"companyName":"企业测试",
				"orderSourceName":"云管分配",
				"orderSourceCode":"0",
				"connectCount":"2",
				"onlineTotalTime":"1小时2分",
				"avgOnlineTime":"31分",
				"latestOnlineTime":1744608368474,
				"longestOnlineTime":"1小时1分"
			}
		],
		"total":9
	},
	"errorCode":"200",
	"errorMessage":"",
	"requestId":"7bc7ba162dc02715"
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。