CDN加速

镜像创建

更新时间:2021-06-08 11:26:13
适用产品:边缘云主机

接口描述

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

请求参数

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

返回参数

参数名称类型描述
idstring镜像唯一标识,全局唯一

示例

示例说明
请求示例
复制
POST /images
{
    "name": "Ubuntu",
    "instanceUuid": "b2173dd3-7ad6-4362-baa6-a68bce3565cb"
}
返回示例
复制
{
"id": "b2173dd3-7ad6-4362-baa6-a68bce3565cb"
}