全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
云服务器 ECS

CreateImage

更新时间:2017-09-13 12:56:26

描述

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

  1. 如果您只需要对实例的系统盘创建自定义镜像,那么只需要指定一个快照 ID 创建自定义镜像。
    • 只有系统盘的快照可以用于创建自定义镜像。
    • 只有达到完成状态(进度为 100%)的快照可以用于创建自定义镜像。
    • 被安全控制在实例的 OperationLocks 中标记了 ”LockReason”: “security” 的锁定状态时,不能创建自定义镜像。
    • 2013 年 7 月 15 日(含)之前创建的快照,不能创建自定义镜像。当Request因此原因被拒绝时,Response 中的 code 为 InvalidSnapshot.TooOld
  2. 如果您需要对整个 ECS 实例做个模板,那么可以指定实例 ID 创建自定义镜像。
    • 指定的实例的状态只能是运行中或者已停止
    • 会给该实例的每块磁盘新增一个快照
    • 需要等待快照创建完成后,镜像的状态才能变成可用状态,需要您等待一段时间。
  3. 如果您需要将多个快照组合成一个镜像模板,那么可以指定 DiskDeviceMapping 创建自定义镜像。
    • 只能指定一个系统盘快照,指定系统盘快照的 device 必须为:/dev/xvda
    • 数据盘快照设备名由系统默认顺序分配,/dev/xvdb 开始到 /dev/xvdz,不能重复。
    • 可以不指定 SnapshotId,不指定时会创建一个指定大小的没有任何数据的空盘。
    • 只有达到完成状态(进度为 100%)的快照可以用于创建自定义镜像。
    • 被安全控制在实例的 OperationLocks 中标记了 ”LockReason”: “security” 的锁定状态时,不能创建自定义镜像。
    • 2013 年 7 月 15 日(含)之前创建的快照,不能创建自定义镜像。当Request因此原因被拒绝时,Response 中的 code 为 InvalidSnapshot.TooOld

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数。取值:CreateImage
RegionId String 镜像所在的 Region ID。RegionId 的列表详见 地域列表
SnapshotId String 快照 ID。从指定的快照创建自定义镜像。
InstanceId String 实例 ID。
DiskDeviceMapping.N.Size String 磁盘的大小。取值范围:[5, 2000] GB
  • 如果不指定,默认为快照的大小。
  • 如果没有指定 SnapshotId,默认磁盘为 5GB。
  • 如果指定了磁盘大小,不能小于快照的大小。
DiskDeviceMapping.n 中 n 的取值范围:[1, 17]
  • n=1 表示系统盘。
  • n=2、3、……17 表示数据盘。
DiskDeviceMapping.N.SnapshotId String 磁盘上的快照 ID。
ImageName String 镜像名称。
  • 长度为 [2,128] 个英文或中文字符,必须以大小字母或中文开头,可包含数字,“_” 或 “-”。
  • 不能以 http:// 和 https:// 开头。
ImageVersion String 镜像版本号。长度为 [1, 40] 个英文字符。
Description String 镜像的描述信息。
  • 长度为 [0, 256] 个英文或中文字符。
  • 不填则为空,默认为空。
  • 不能以 http:// 和 https:// 开头。
ClientToken String 用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不值过 64 个 ASCII 字符。
具体参见附录:如何保证幂等性

返回参数

名称 类型 描述
ImageId String 镜像 ID

错误码

错误代码 描述 Http状态码 语义
IncorrectInstanceStatus The current status of the instance does not support this operation. 400 指定的实例状态不正确。
InstanceLockedForSecurity The specified operation is denied as your instance is locked for security reasons. 400 指定的实例被安全锁定。
InvalidDescription.Malformed The specified description is wrongly formed. 400 无效的 Description 取值。
InvalidImageName.Duplicated The specified Image name has already been used. 400 指定的 ImageName 已经被使用。
InvalidImageName.Malformed The specified Image name is wrongly formed. 400 无效的 ImageName 取值(字符不支持或者超出长度)。
InvalidImageVersion.Malformed The specified ImageVersion is wrongly formed. 400 无效的 ImageVersion 取值(可能是用户无权使用此 Snapshot)。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 400 指定实例不存在。
InvalidInstanceId.ValueNotSupported The specified InstanceId is not allowed to create image. 400 指定的实例不能创建快照。
InvalidSize.ValueNotSupported The specified parameter DiskDeviceMapping.n.Size beyond the permitted range. 400 指定的 DiskDeviceMapping.n.Size 超出范围。
MissingParameter The input parameter SnapshotId or InstanceId or DiskDeviceMapping that is mandatory for processing this request is not supplied. 400 缺少必填参数 SnapshotId、InstanceId 或 DiskDeviceMapping。
OperationDenied The specified parameter DiskDeviceMapping.n.SnapshotId does not contain system disk snapshot. 400 参数 DiskDeviceMapping.n.SnapshotId 中不包含系统盘快照。
OperationDenied The specified parameter DiskDeviceMapping.n.SnapshotId contains two or more system disk snapshots. 400 参数 DiskDeviceMapping.n.SnapshotId 中包含多个系统盘快照。
InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance. 403 账户余额不足。
InvalidAccountStatus.SnapshotServiceUnavailable Snapshot service has not been opened yet. 403 快照服务未开通。
InvalidParamter.Conflict The specified same token is trying to make requests with different parameters. 403 token 和参数不一致。
InvalidSnapshot.TooOld This operation is denied because the specified snapshot by DiskDeviceMapping.n.SnapshotId or SnapshotId is created before 2013-07-15. 403 指定快照创建于 2013 年 7 月 15 日(含)之前,不能创建镜像。
InvalidSnapshotId.NotReady The current status of the DiskDeviceMapping.n.SnapshotId or SnapshotId does not support this operation. 403 指定快照的状态不对。
OperationDenied The specified snapshot is not allowed to create image. 403 特定磁盘的快照不能创建镜像。
OperationDenied The specified snapshot is not from system disk. 403 只有系统盘快照才能创建镜像。
QuotaExceed.Image The Image Quota exceeds. 403 自定义镜像额度已用完。
InvalidRegionId.NotFound The specified RegionId does not exist. 404 指定的 RegionId 不存在。RegionId 的列表详见 地域列表
InvalidSnapshotId.NotFound The specified SnapshotId does not exist. 404 找不到指定的快照。
InvalidSnapshotId.NotFound The specified SnapshotId does not exist. 404 指定快照不存在。

示例

请求示例

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

返回示例

XML格式

  1. <CreateImageResponse>
  2. <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
  3. <ImageId>m-63DFD5FB2</ImageId>
  4. </CreateImageResponse>

JSON格式

  1. {
  2. "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
  3. "ImageId": "m-63DFD5FB2"
  4. }
本文导读目录