420      阿里云

创建自定义镜像__镜像相关接口_API 参考_云服务器 ECS-阿里云

描述

创建的自定义镜像，只有等待状态变为可用才能使用，可以使用镜像进行创建新的ECS实例或者对已有实例进行更换系统盘。创建自定义镜像，可以通过三种方式来创建，来满足您不同业务场景。

1.如果您只需要对实例的系统盘创建自定义镜像，那么只需要指定一个快照Id进行创建自定义镜像。

• 只有系统盘的快照可以用于创建自定义镜像。
• 只有达到完成状态（进度为100%）的快照可以用于创建自定义镜像。
• 被安全控制在实例的OperationLocks中标记了”LockReason”: “security”的锁定状态时，不能创建自定义镜像。
• 2013年7月15日（含）之前创建的快照，不能创建自定义镜像。当Request因此原因被拒绝时，Response中的code为InvalidSnapshot.TooOld。

2.如果您需要对整个ECS实例做个模板，那么可以指定实例Id进行创建自定义镜像。

• 指定的实例的状态只能使运行中或者已停止
• 会给该实例的每块磁盘新增一个快照
• 需要等待快照创建完成后，镜像的状态才能变成可用状态，需要您等待一段时间。

3.如果您需要对多个快照进行组合成一个镜像模板，那么可以指定DiskDeviceMappings进行创建自定义镜像。

• 只能指定一个系统盘快照，指定系统盘快照的device必须为：/dev/xvda
• 可以不指定快照的Id，那么会创建一个指定大小的没有任何数据的空盘。
• 只有达到完成状态（进度为100%）的快照可以用于创建自定义镜像。
• 被安全控制在实例的OperationLocks中标记了”LockReason”: “security”的锁定状态时，不能创建自定义镜像。
• 2013年7月15日（含）之前创建的快照，不能创建自定义镜像。当Request因此原因被拒绝时，Response中的code为InvalidSnapshot.TooOld。

请求参数

返回参数

错误码

示例

请求示例

https://ecs.aliyuncs.com/?Action=CreateImage
&RegionId=cn-hangzhou
&SnapshotId=s-snapshot1
&ImageName=demo_image
&<公共请求参数>

返回示例

XML格式

<CreateImageResponse>
    <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
    <ImageId>m-63DFD5FB2</ImageId>
</CreateImageResponse>

JSON格式

{
    "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
    "ImageId": "m-63DFD5FB2"
}

最后更新：2016-11-23 16:03:50

  上一篇： 查询可用镜像__镜像相关接口_API 参考_云服务器 ECS-阿里云

  下一篇： 修改镜像属性__镜像相关接口_API 参考_云服务器 ECS-阿里云