创建自定义镜像
描述
通过快照创建自定义镜像,创建后的镜像可以用于新建 ECS 实例。
只有系统盘的快照可以用于创建自定义镜像。
只有达到完成状态(进度为 100%)的快照可以用于创建自定义镜像。
被安全控制在实例的 OperationLocks 中标记了 "LockReason" : "security" 的锁定状态时,不能创建自定义镜像。
2013 年 7 月 15 日(含)之前创建的快照,不能创建自定义镜像。当 Request 因此原因被拒绝时,Response 中的 code 为 InvalidSnapshot.TooOld。
请求参数
名称 |
类型 |
是否必须 |
描述 |
Action
String
是
系统规定参数,取值:CreateImage
RegionId
String
是
镜像所在的 Region ID
SnapshotId
String
是
快照 ID。从指定的快照创建自定义镜像。
ImageName
String
否
镜像名称,[2, 128] 英文或中文字符,必须以大小字母或中文开头,可包含数字,”_”或”-”。不能以 // 和 https:// 开头。
ImageVersion
String
否
镜像版本号,长度限制在 1 ~ 40 个英文字符
Description
String
否
镜像的描述信息,长度限制在 0 ~ 256 个字符,不填则为空,默认为空。不能以 // 和 https:// 开头。
ClientToken
String
否
用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不值过 64 个 ASCII 字符。
具体参见附录:如何保证幂等性。
返回参数
名称 |
类型 |
描述 |
ImageId
String
镜像 ID
错误码
错误代码 |
描述 |
Http 状态码 |
语义 |
MissingParameter
The input parameter "RegionId" that is mandatory for processing this request is not supplied.
400
缺少 RegionId 字段
MissingParameter
The input parameter "SnapshotId" that is mandatory for processing this request is not supplied.
400
缺少 SnapshotId 字段
InvalidRegionId.NotFound
The specified region does not exist.
404
指定的 regionId 不存在
InvalidSnapshotId.NotFound
The specified snapshot does not exist.
404
无效的 SnapshotId 取值(实际情况也可能是该用户无权使用此 Zone)
InvalidImageName.Malformed
The specified Image name is wrongly formed.
400
无效的 ImageName 取值(字符不支持或者超出长度)
InvalidDescription.Malformed
The specified description is wrongly formed.
400
无效的 Description 取值
InvalidImageVersion.Malformed
The specified ImageVersion is wrongly formed.
400
无效的 ImageVersion 取值(实际情况也可能是该用户无权使用此 Snapshot)
InvalidSnapshotId.NotReady
The specified snapshot creation is not completed yet.
403
快照没有完成
InvalidSnapshot.TooOld
This operation is denied because the specified snapshot is created before 2013-07-15.
403
2013 年 7 月 15 日前的快照不能创建镜像
OperationDenied
The specified snapshot is not allowed to create image.
403
特定磁盘的快照不能创建镜像
QuotaExceed.Image
The Image Quota exceeds.
403
自定义镜像额度已用完
OperationDenied
The specified snapshot is not from system disk.
403
只有系统盘快照才能创建镜像
InvalidParamter.Conflict
The specified same token is trying to make requests with different parameters.
403
token 和参数不一致
示例
请求示例
https://ecs.aliyuncs.com/?Action=CreateImage
&RegionId=cn-hangzhou
&SnapshotId=s-snapshot1
&ImageName=demo_image
&<公共请求参数>
返回示例
【点击图片进入下一页或下一篇】
JSON格式
{
"RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
"ImageId": "m-63DFD5FB2"
}
所属专题: