创建快照
描述
对指定的磁盘存储设备创建快照。
云服务器仅在 Stopped 或 Running 状态下才能创建快照。(但刚创建完成从未启动过的实例不能创建快照)
刚创建完成的云服务器系统盘,或刚增加从快照创建的数据盘,由于尚未完成数据的加载,此时创建快照会返回错误。一般来说,系统盘创建完成 1 个小时后即可创建快照,数据盘的可创建快照的时间取决于磁盘数据的大小。
新增加一块磁盘后,如果实例尚未启动过,新增的这块磁盘不能用于创建快照。
如果快照创建没有完成(即进度没有达到 100%),那么这个快照无法用于创建自定义镜像。
如果快照创建没有完成(即进度没有达到 100%),那么不能对同一磁盘再次创建快照。
快照数量的配额取决于该帐号下拥有的磁盘总数量。最多可创建的快照数量为磁盘数量乘以 6 + 6。
如果磁盘在 In_use 状态下,挂载的实例的 OperationLocks 中标记了 "LockReason" : "security" 的锁定状态时,不能创建快照。
磁盘挂载的实例创建后第一次启动前,不能创建快照
独立普通云盘创建后,如果没有挂载过,创建快照会出现错误提示。
请求参数
名称 |
类型 |
是否必须 |
描述 |
Action
String
是
系统规定参数,取值:CreateSnapshot
DiskId
String
是
指定的磁盘 ID
SnapshotName
String
否
快照的显示名称,[2, 128] 英文或中文字符,必须以大小字母或中文开头,可包含数字,”_”或”-”,且不能以 auto 开头(auto 开头的快照名是预留给自动快照的)。快照的显示名称会显示在控制台中。不能以 // 和 https:// 开头。
Description
String
否
快照的描述,[2, 256] 个字符。快照的描述会显示在控制台中。不填则为空,默认为空。不能以 // 和 https:// 开头。
ClientToken
String
否
用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不值过 64 个 ASCII 字符。
具体参见附录:如何保证幂等性。
返回参数
名称 |
类型 |
描述 |
SnapshotId
String
快照 ID
错误码
错误代码 |
描述 |
Http 状态码 |
语义 |
MissingParameter
The input parameter "DiskId" that is mandatory for processing this request is not supplied.
400
DiskId 参数未指定
InvalidDiskId.NotFound
The specified DiskId does not exist.
404
指定的磁盘不存在
InvalidSnapshotName.Malformed
The specified SnapshotName is wrongly formed.
400
SnapshotName 格式不合法
InvalidDescription.Malformed
The specified description is wrongly formed.
404
Description 格式不合法
IncorrectInstanceStatus
The current status of the resource does not support this operation.
400
指定的实例状态不正确
IncorrectDiskStatus.CreatingSnapshot
The snapshot of the disk is still creating.
403
指定的磁盘正在创建快照
InstanceLockedForSecurity
The disk attached instance is locked due to security.
403
指定的实例被安全锁定
IncorrectDiskStatus.NeverAttached
The specified disk has never been attached to any instance.
403
可卸载的普通云盘创建后未被挂载,内容没有变化
QuotaExceed.Snapshot
The snapshot quota exceeds.
403
快照额度超过限制
IncorrectDiskStatus.NeverUsed
The specified disk has never been used after creating.
403
磁盘创建后未被使用,内容没有变化
CreateSnapshot.Failed
The process of creating snapshot is failed
403
创建快照失败
示例
请求示例
https://ecs.aliyuncs.com/?Action=CreateSnapshot
&DiskId=1033-60053321
&<公共请求参数>
返回示例
XML格式
C8B26B44-0189-443E-9816-D951F59623A9
s-923FE2BF0
JSON格式
{
"RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
"SnapshotId": "s-923FE2BF0"
}
所属专题: