查询硬终端详情

接口说明

面向政企版租户开放硬终端设备详情查询接口 业务逻辑:支持指定设备ID的硬终端详情,信息包括①基本信息包含:设备名称、设备id、设备型号(例如W600D)、IP地址(支持多个,换行展示,逗号隔开)、mac地址,②硬件信息包含:处理器、核数、RAM、硬盘,③软件信息包含:系统架构(例如64位x64)、操作系统(例如win10) 限流:根据租户实现用户级别的限流,限制为100次每秒


推荐使用API Explorer调试

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

URL

POST https://ecloud.10086.cn/api/clouddesktopnew/cem_openapi/ccacem/api/v1/device/ccemp/getDeviceDetail

请求参数

Query

参数名称
类型
必填
描述
deviceUid
string
是

设备UID

请求示例

POST https://ecloud.10086.cn/api/clouddesktopnew/cem_openapi/ccacem/api/v1/device/ccemp/getDeviceDetail

返回参数

返回码:200
OK
参数名称
类型
描述
body
DeviceInfoRespDto

请求成功时返回的数据

clientType
string

客户端类型

clientVersion
string

客户端版本

connectStatus
string

连接状态 0 未连接;1 已连接

cores
string

'核数

deviceCompany
string

设备厂商

deviceModel
string

设备型号

deviceName
string

设备名称

deviceOrderId
string

关联订单号

deviceOwner
string

绑定用户

deviceSource
string

设备来源 1.定制终端-云能,2.定制终端-终端公司,3.通用终端

deviceTenant
string

所属租户

deviceType
string

设备类型

deviceUid
string

设备ID(如macId,androidId,uuid等,不可重复)

disk
string

硬盘大小

firstLoginTime
string

终端首次登录时间

id
string

设备表主键ID(唯一)

ipAddress
string

IP地址

lockState
string

锁定状态 0 未锁定;1 已锁定

macAddress
string

MAC地址

operatingSystem
string

操作系统

operatingVersion
string

操作系统版本号

processor
string

'处理器'

ram
string

内存大小

recentLoginMachine
string

最近连接桌面名称

recentLoginTenant
string

登录租户

recentLoginTime
string

终端最近一次登录时间

recentLoginUser
string

登录用户

remark
string

备注

systemArchitecture
string

系统架构

errorCode
string

统一错误码

errorMessage
string

错误码提示信息

requestId
string

每个请求的序列号

state
enum(OK,ERROR,EXCEPTION,FORBIDDEN,REMAINING,TIMEOUT)

返回状态码;返回正常:OK,返回错误:ERROR,返回异常:EXCEPTION,需要告警实现的:ALARM,禁止访问:FORBIDDEN

返回示例

返回码:200
OK
{
	"state":"OK",
	"body":{
		"id":null,
		"deviceUid":"QSVBB20922801047",
		"deviceName":"LAPTOP-E0L9KS0E",
		"deviceSource":null,
		"deviceType":null,
		"deviceModel":"HNL-WXX9-PCB",
		"deviceOrderId":null,
		"lockState":null,
		"deviceOwner":null,
		"deviceTenant":null,
		"connectStatus":null,
		"clientType":null,
		"clientVersion":null,
		"recentLoginUser":null,
		"recentLoginTenant":null,
		"recentLoginMachine":null,
		"firstLoginTime":null,
		"recentLoginTime":null,
		"ipAddress":"10.14.105.64",
		"macAddress":"80:30:49:4B:B2:49",
		"deviceCompany":null,
		"processor":"",
		"cores":"0",
		"ram":"",
		"disk":null,
		"systemArchitecture":"x86",
		"operatingSystem":"windows10",
		"operatingVersion":null,
		"remark":null,
		"mopUserId":null
	},
	"errorCode":"200",
	"errorMessage":"",
	"requestId":"997050ca9a8f430fada900d9f566448c"
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。