阿里云如何使用镜像相关接口(2)

时间:2016-09-15 07:00:42 

创建自定义镜像

描述

通过快照创建自定义镜像,创建后的镜像可以用于新建 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"

}

看不过瘾?点击下面链接!
本站微信公众号:gsjx365,天天有好故事感动你!

上一页123456..8下一页

相关电脑知识

美图欣赏

电脑知识排行榜