接口说明
面向政企版租户开放获取云电脑详情信息接口,一次最多查询10个。 限流:根据租户实现用户级别的限流,限制为10次每秒。
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"
]
}
返回参数
|
参数名称
|
类型
|
描述
|
|
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 |
返回示例
{
"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"
}