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