查看电脑详情

接口说明

面向政企版租户开放获取云电脑详情信息接口,一次最多查询10个。 限流:根据租户实现用户级别的限流,限制为10次每秒。


推荐使用API Explorer调试

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

URL

POST https://ecloud.10086.cn/api/Computer_api/cem_openapi/ccacem/api/v1/machine/machineInfoDetail

请求参数

Body

参数名称
类型
必填
描述
reqDto
CcempMachineInfoDetailReqDto
是

请求入参

machineIdList
<string> array
是

云电脑ID列表

请求示例

POST https://ecloud.10086.cn/api/Computer_api/cem_openapi/ccacem/api/v1/machine/machineInfoDetail
{
	"machineIdList":[
		"H3C729e5786daf542f1a9f9a740f46bd6e5"
	]
}

返回参数

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

请求成功时返回的数据

records
<DetailInfo> array

成功集合

adStatus
string

ad用户与桌面操作的状态,0:已绑定、1:绑定中、2:绑定失败、3:换绑中、4:换绑失败、5:解绑中、6:解绑失败

azCode
string

可用区编码

bandwidthMax
integer(int32)

最大带宽

companyCode
string

厂商

companyName
string

企业名称

computerProtocol
string

电脑协议(V2:自研CMSSZTE,V1.1:新华三,V1.2:中兴,V 1.4:中兴大云融合)

createdTime
string

创建时间

dc
string

数据中心

distributeStatus
string

分配状态(free空闲、occupied已分配、releasing待释放、freeze冻结、released已释放)

effectiveTime
string

生效时间

expireTime
string

失效时间

extDataDiskSize
integer(int64)

数据盘大小

instanceId
string

资源实例ID

intranetIP
string

内网ip地址

isActive
string

是否分配,分配0,未分配1

machineId
string

电脑ID

machineName
string

主机名

machineStatus
string

可用状态(available开机、exception异常、shutdown关机、onShutdown关机中、onAvailable开机中、onReload重装系统中、onRestart重启中、transferring 迁移中/漫游中)

mopUserId
string

mop用户ID

mopUserName
string

mop用户名

netService
boolean

是否订购网络服务包(0:未订购,1:已订购)

operateSystem
string

操作系统

orderSource
string

渠道名称

orderSourceCode
string

渠道

orgId
string

企业门户组织ID

orgName
string

企业门户组织名称

osVersion
string

操作系统

policyId
string

电脑策略id

policyName
string

电脑策略名称

poolCode
string

资源池编码

poolName
string

资源池名称

qosName
string

Qos名称

region
string

可用区编码

regionName
string

可用区名称

resourceManageState
string

资源管理状态(0:正常,1:锁定,2:禁用,3:锁定且禁用)

resourceTypeName
string

定制规格参数

securityGroupName
string

安全组名称

snapshotId
string

快照ID

sysDiskSize
string

系统盘大小

tenantId
string

租户ID

userId
string

登录用户编号

userName
string

登录用户名

vpcName
string

vpc名称

errorCode
string

统一错误码

errorMessage
string

错误码提示信息

requestId
string

每个请求的序列号

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

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

返回示例

返回码:200
OK
{
	"state":"OK",
	"body":{
		"records":[
			{
				"machineId":"H3C729e5786daf542f1a9f9a740f46bd6e5",
				"instanceId":"CCA-b2f0ff33eb474b07b67688c0d3a47b5c",
				"tenantId":"1711581610503094273",
				"mopUserName":"xxxxx",
				"mopUserId":"CIDC-U-e385034cf68b44a587e489be25ca01f8",
				"machineName":"我的电脑",
				"orderSource":"官网一体化订购",
				"orderSourceCode":"10003",
				"distributeStatus":"occupied",
				"machineStatus":"shutdown",
				"companyCode":"ZTE",
				"resourceTypeName":"办公型-政企版4C8G",
				"effectiveTime":"2024-11-27 17:37:48",
				"expireTime":"2027-11-27 17:37:48",
				"createdTime":"2024-11-27 17:20:18",
				"extDataDiskSize":200,
				"azCode":"CIDC-RP-30-AZ1",
				"dc":"region-ZTE-0004",
				"poolCode":"CIDC-RP-30",
				"poolName":"华中-长沙2",
				"region":"CIDC-RP-30-AZ1",
				"regionName":"可用区一",
				"companyName":null,
				"userId":"1838027667113295873",
				"userName":"pzx015.ee04271",
				"isActive":"0",
				"orgId":"476749718064849978",
				"orgName":"csy_csb_saas_chenlai_035",
				"operateSystem":"win10",
				"intranetIP":"127.0.0.1",
				"snapshotId":null,
				"adStatus":null,
				"osVersion":"windows 10",
				"sysDiskSize":"80",
				"policyId":null,
				"policyName":null,
				"vpcName":null,
				"bandwidthMax":null,
				"netService":false,
				"resourceManageState":"0",
				"computerProtocol":"V1.2",
				"securityGroupName":null,
				"qosName":null
			}
		]
	},
	"errorCode":"200",
	"errorMessage":"",
	"requestId":"4a263f007e6f472c83b88d0b58f8cbc1"
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。