镜像创建

更新时间:2023-06-29 15:13:41

适用产品

边缘云主机

接口描述

客户可以自定义虚拟机镜像。有两种方法可以制作自定义镜像: 1)将某个虚拟机系统盘制作成镜像,之后便可将其用于创建新的虚拟机。建议在制作镜像期间关闭虚拟机或者停止虚拟机上的应用或服务,以免影响镜像数据的完整性,待镜像制作完成,再启动虚拟机及其应用。此类操作创建的镜像在镜像查询接口中返回的镜像属主是SNAPSHOT,表示用虚拟机快照做的镜像。 2)客户按照提供的镜像制作文档自行制作镜像,制作完成后通过API提供url地址及md5值,边缘计算平台自动从url地址下载镜像。这种镜像在镜像查询接口中返回的镜像属主是CUSTOM。自行制作的镜像只支持QCOW2格式,并且镜像大小不能超过50G。 3)该接口是异步调用,客户在调用成功后得到镜像id,然后通过镜像查询接口定时查询获取镜像的状态,只有镜像状态为ACTIVE时方可使用。

推荐使用 Open API在线调试

Open API在线调试功能提供可视化界面在线调试API、支持生成代码示例、快速检索查看API文档等能力。前往调试

请求参数

Body 参数

参数名称描述
*name
镜像名称
instanceUuid
虚拟机实例标识,可选参数,该参数与imageSrcUrl必须二选一
imageSrcUrl
虚拟机镜像Url地址,可选参数,该参数与instanceUuid必须二选一
md5
虚拟机镜像的md5值,与imageSrcUrl配合使用
ostype
操作系统类型,如果携带的是url地址时,该参数必填;如果是指定虚拟机创建,则以虚拟机的ostype为准。 有2种取值:windows、linux
minDisk
系统盘最小要求,单位是GB。选择的模板的系统盘大小必须大于等于该值,否则虚拟机创建失败
qgaEnabled
镜像是否开启了qemu guest agent,有开启的镜像支持密码重置 有2种取值:TRUE、FALSE

返回参数

Body 参数

参数名称描述
id
镜像唯一标识,全局唯一

示例

JSON
JSON
请求示例
复制代码 复制成功
POST /images
{
    "name": "Ubuntu",
    "instanceUuid": "b2173dd3-7ad6-4362-baa6-a68bce3565cb"
}
返回示例
复制代码 复制成功
{
"id": "b2173dd3-7ad6-4362-baa6-a68bce3565cb"
}
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!