接口说明
开放政企版给电脑查询镜像还原记录接口 业务逻辑：支持通过镜像ID、镜像类型标识查询记录，支持分页查询（单页默认10，最大50）。 限流：根据租户实现用户级别的限流，限制为10次每秒
URL
POST https://ecloud.10086.cn/api/Computer_api/cem_openapi/ccacem/api/v1/image/getApplyImageRecord
请求参数
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
reqDto
|
GetApplyImageRecordApiReqDto
|
是
|
请求入参 |
|
templateId
|
string
|
否
|
镜像模板ID |
|
imageTag
|
string
|
是
|
镜像类型标识,自定义:custom,共享:share,公共:public |
|
imageSnapshotRecordIds
|
<string> array
|
否
|
切换镜像记录主键ID列表 |
|
currentPage
|
integer(int32)
|
否
|
当前页 |
|
pageSize
|
integer(int32)
|
否
|
每页显示条数 |
请求示例
POST https://ecloud.10086.cn/api/Computer_api/cem_openapi/ccacem/api/v1/image/getApplyImageRecord{
"templateId":"169657b3-c6f8-4703-bff0-4c818b43dc5c",
"imageSnapshotRecordIds":[
"2034186935786008577",
"2034077577114693634",
"2033727521119412225"
],
"imageTag":"custom",
"currentPage":1,
"pageSize":10
}返回参数
返回码：200
OK
|
参数名称
|
类型
|
描述
|
|
body
|
PageReturnEntity«ImageCem»
|
请求成功时返回的数据 |
|
data
|
<ImageCem> array
|
数据 |
|
createdTime
|
string
|
镜像还原记录创建时间 |
|
errorMessage
|
string
|
还原失败原因 |
|
imageRecordId
|
integer(int64)
|
切换镜像记录主键ID |
|
machineId
|
string
|
桌面id |
|
machineName
|
string
|
桌面名称 |
|
modifiedTime
|
string
|
修改时间 |
|
status
|
string
|
还原状态 |
|
templateId
|
string
|
镜像模板uid |
|
totalCount
|
integer(int32)
|
总行数 |
|
errorCode
|
string
|
统一错误码 |
|
errorMessage
|
string
|
错误码提示信息 |
|
requestId
|
string
|
每个请求的序列号 |
|
state
|
enum(OK,ERROR,EXCEPTION,FORBIDDEN,REMAINING,TIMEOUT)
|
返回状态码;返回正常：OK,返回错误：ERROR,返回异常：EXCEPTION,需要告警实现的：ALARM,禁止访问：FORBIDDEN |
返回示例
返回码：200
OK
{
"state":"OK",
"body":{
"data":[
{
"machineId":"aa315725-52a9-4ca9-bc0a-36cb050082bb",
"machineName":"我的电脑",
"status":"成功",
"errorMessage":"",
"createdTime":"2026-03-18 16:35:33",
"modifiedTime":"2026-03-18 16:37:50",
"imageRecordId":"2034186935786008577",
"templateId":"f5067b25-6940-46dc-9bf7-ebcb59ac3b11"
},
{
"machineId":"aa315725-52a9-4ca9-bc0a-36cb050082bb",
"machineName":"我的电脑",
"status":"成功",
"errorMessage":"",
"createdTime":"2026-03-17 10:10:00",
"modifiedTime":"2026-03-17 10:12:47",
"imageRecordId":"2033727521119412225",
"templateId":"1bfe8817-c9bc-45cf-a138-1cc5a230d87b"
}
],
"totalCount":2
},
"errorCode":"200",
"errorMessage":"",
"requestId":"281de82a61796e61"
}