创建自定义镜像

接口说明

开放政企版给电脑创建镜像接口 业务逻辑:支持使用某台电脑创建自定义镜像 限流:根据租户实现用户级别的限流,限制为10次每秒


推荐使用API Explorer调试

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

URL

POST https://ecloud.10086.cn/api/Computer_api/cem_openapi/ccacem/api/v1/image/createImage

请求参数

Body

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

请求入参

imageName
string
是

镜像名称

imageRemark
string
否

镜像模板描述

imageType
string
是

镜像类型(当前仅支持自定义custom)

machineId
string
是

桌面id

imageTarget
string
是

镜像模板范围(当前仅支持系统盘system)

diskType
string
是

磁盘性质(当前仅支持系统盘system)

请求示例

POST https://ecloud.10086.cn/api/Computer_api/cem_openapi/ccacem/api/v1/image/createImage
{
	"imageName":"自定义镜像",
	"imageRemark":"自定义镜像1",
	"imageType":"custom",
	"machineId":"7562dd1f-1d04-4161-9c3a-b36a269d2a50",
	"imageTarget":"system",
	"diskType":"system"
}

返回参数

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

请求成功时返回的数据

machineId
string

云电脑ID

templateId
string

镜像模板ID,uuid

errorCode
string

统一错误码

errorMessage
string

错误码提示信息

requestId
string

每个请求的序列号

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

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

返回示例

返回码:200
OK
{
	"body":{
		"machineId":"7562dd1f-1d04-4161-9c3a-b36a269d2a50",
		"templateId":"d837f749-cbab-41ba-be2f-d5cb9ff63515"
	},
	"state":"OK",
	"errorCode":"200",
	"errorMessage":"",
	"requestId":"124861b13e39430797585ba5ed6c9494"
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。