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

CreateSnapshot

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

描述

对指定的磁盘存储设备创建快照。

  • 云服务器仅在 Stopped 或 Running 状态下才能创建快照。(但刚创建完成从未启动过的实例不能创建快照)
  • 刚创建完成的云服务器系统盘,或刚增加从快照创建的数据盘,由于尚未完成数据的加载,此时创建快照会返回错误。一般来说,系统盘创建完成 1 个小时后即可创建快照,数据盘的可创建快照的时间取决于磁盘数据的大小。
  • 新增加一块磁盘后,如果实例尚未启动过,新增的这块磁盘不能用于创建快照。
  • 如果快照创建没有完成(即进度没有达到 100%),那么这个快照无法用于创建自定义镜像。
  • 如果快照创建没有完成(即进度没有达到 100%),那么不能对同一磁盘再次创建快照。
  • 快照数量的配额取决于该帐号下拥有的磁盘总数量。最多可创建的快照数量为磁盘数量乘以64。
  • 如果磁盘在 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状态码 语义
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 A previous snapshot creation is in process. 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 maximum number of snapshots is exceeded. 403 快照额度超过限制
IncorrectDiskStatus.NeverUsed The specified disk has never been used after creating. 403 磁盘创建后未被使用,内容没有变化
CreateSnapshot.Failed The process of creating snapshot is failed. 403 创建快照失败
DiskInArrears The specified operation is denied as your disk has expired. 403 指定磁盘已经欠费
DiskId.ValueNotSupported The specified parameter diskid is not supported. 403 指定的参数diskid不支持
DiskCategory.OperationNotSupported The operation is not supported to the specified disk due to its disk category 400 指定磁盘的磁盘类型不支持该操作
IncorrectDiskStatus The current disk status does not support this operation. 403 磁盘状态不正确
InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance. 403 账户余额不足
InvalidAccountStatus.SnapshotServiceUnavailable Snapshot service has not been opened yet. 403 快照服务未开通

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=CreateSnapshot
  2. &DiskId=1033-60053321
  3. &<公共请求参数>

返回示例

XML格式

  1. <CreateSnapshotResponse>
  2. <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
  3. <SnapshotId>s-923FE2BF0</SnapshotId>
  4. </CreateSnapshotResponse>

JSON格式

  1. {
  2. "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
  3. "SnapshotId": "s-923FE2BF0"
  4. }
本文导读目录