全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
云服务器 ECS

CreateSnapshot

更新时间:2018-05-16 10:16:05

描述

为指定的 ECS 磁盘创建快照。调用该接口时,您需要注意:

  • 一块磁盘最多能创建 64 份快照。

  • 磁盘挂载的实例必须处于 已停止Stopped)或者 运行中Running)状态,否则无法创建快照。

  • 磁盘必须已经挂载到实例上,否则无法创建快照。

  • 磁盘挂载的实例从未启动过时,无法创建快照。

  • 安全控制 的 ECS 实例的 OperationLocks 中标记了 "LockReason" : "security" 时,实例挂载的磁盘无法创建快照。

  • 新建一台云服务器 ECS、更换系统盘 或者 根据快照新增数据盘,由于尚未完成数据加载,无法创建快照。新建一台云服务器 ECS 或者更换系统盘大约 1 小时后可以创建快照,新增一块数据盘可创建快照的时间取决于磁盘数据的大小。

  • 如果创建快照还未完成,您无法为该磁盘再次创建快照。

  • 如果创建快照还未完成,这份快照无法用于创建自定义镜像 (CreateImage)。

请求参数

名称 类型 是否必需 描述
Action String 系统规定参数。取值:CreateSnapshot
DiskId String 磁盘 ID。
SnapshotName String 快照的显示名称。
  • 长度为 [2, 128] 个英文或中文字符。
  • 必须以大小字母或中文开头,可包含数字、半角冒号(:)、下划线(_)或者短横线(-)。
  • 为防止和 自动快照 的名称冲突,不能以 auto 开头。
  • 不能以 http:// 和 https:// 开头。
Description String 快照的描述。
  • 长度为 [2, 256] 个英文或中文字符。
  • 不能以 http:// 和 https:// 开头。
默认值:空
ClientToken String 用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最长不能超过 64 个 ASCII 字符。
更多详情,请参阅 如何保证幂等性

返回参数

名称 类型 描述
SnapshotId String 快照 ID

示例

请求示例

  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. }

错误码

错误代码 错误信息 HTTP 状态码 说明
DiskCategory.OperationNotSupported The operation is not supported to the specified disk due to its disk category 400 指定磁盘的磁盘类型不支持该操作。
IncorrectInstanceStatus The current status of the resource does not support this operation. 400 磁盘挂载的实例必须处于 已停止Stopped)或者 运行中Running)状态。
InvalidSnapshotName.Malformed The specified SnapshotName is wrongly formed. 400 指定的参数 SnapshotName 不合法。
CreateSnapshot.Failed The process of creating snapshot is failed. 403 创建快照失败。
DiskId.ValueNotSupported The specified parameter diskid is not supported. 403 指定的参数 DiskId 不能创建快照。
DiskInArrears The specified operation is denied as your disk has expired. 403 指定的磁盘已经欠费。请重新续费后重试。
IncorrectDiskStatus The current disk status does not support this operation. 403 磁盘必须处于 使用中In_use)的状态。
IncorrectDiskStatus.CreatingSnapshot A previous snapshot creation is in process. 403 指定的磁盘正在创建快照。请稍后再试。
IncorrectDiskStatus.NeverAttached The specified disk has never been attached to any instance. 403 磁盘必须已经挂载到实例上。
IncorrectDiskStatus.NeverUsed The specified disk has never been used after creating. 403 该磁盘未被使用,不能创建快照。
InstanceLockedForSecurity The disk attached instance is locked due to security. 403 指定的实例被安全锁定。
InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance. 403 您的账户余额不足。充值 后重试。
InvalidAccountStatus.SnapshotServiceUnavailable Snapshot service has not been opened yet. 403 您还未开通快照服务。提交工单 申请开通。
QuotaExceed.Snapshot The maximum number of snapshots is exceeded. 403 您已超出能创建的最大快照数量。一块磁盘最多能创建 64 份快照。
InvalidDescription.Malformed The specified description is wrongly formed. 404 指定的参数 Description 不合法。
InvalidDiskId.NotFound The specified DiskId does not exist. 404 指定的磁盘不存在。
本文导读目录