创建快照
描述
对指定的磁盘存储设备创建快照。
云服务器仅在 Stopped 或 Running 状态下才能创建快照。(但刚创建完成从未启动过的实例不能创建快照)
刚创建完成的云服务器系统盘，或刚增加从快照创建的数据盘，由于尚未完成数据的加载，此时创建快照会返回错误。一般来说，系统盘创建完成 1 个小时后即可创建快照，数据盘的可创建快照的时间取决于磁盘数据的大小。
新增加一块磁盘后，如果实例尚未启动过，新增的这块磁盘不能用于创建快照。
如果快照创建没有完成(即进度没有达到 100%)，那么这个快照无法用于创建自定义镜像。
如果快照创建没有完成(即进度没有达到 100%)，那么不能对同一磁盘再次创建快照。
快照数量的配额取决于该帐号下拥有的磁盘总数量。最多可创建的快照数量为磁盘数量乘以 6 + 6。
如果磁盘在 In_use 状态下，挂载的实例的 OperationLocks 中标记了 "LockReason" : "security" 的锁定状态时，不能创建快照。
磁盘挂载的实例创建后第一次启动前，不能创建快照
独立普通云盘创建后，如果没有挂载过，创建快照会出现错误提示。
请求参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| Action | String | 是 | 系统规定参数，取值：CreateSnapshot |
| DiskId | String | 是 | 指定的磁盘 ID |
| SnapshotName | String | 否 | 快照的显示名称，[2, 128] 英文或中文字符，必须以大小字母或中文开头，可包含数字，”_”或”-”，且不能以 auto 开头（auto 开头的快照名是预留给自动快照的）。快照的显示名称会显示在控制台中。不能以 http:// 和 https:// 开头。 |
| Description | String | 否 | 快照的描述，[2, 256] 个字符。快照的描述会显示在控制台中。不填则为空，默认为空。不能以 http:// 和 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"
}