CreateSnapshot

为一块ECS磁盘创建一份快照。

描述

调用该接口时,您需要注意:

  • 一块磁盘最多能创建 64 份快照。
  • 磁盘挂载的实例必须处于 已停止Stopped)或者 运行中Running)状态,否则无法创建快照。
  • 磁盘必须已经挂载到实例上,否则无法创建快照。
  • 磁盘挂载的实例从未启动过时,无法创建快照。
  • 被 安全控制 的 ECS 实例的 OperationLocks 中标记了 "LockReason" : "security" 时,实例挂载的磁盘无法创建快照。
  • 新建一台云服务器 ECS(RunInstances)、更换系统盘(ReplaceSystemDisk)或者根据快照新增数据盘(CreateDisk),由于尚未完成数据加载,无法创建快照。新建一台云服务器 ECS 或者更换系统盘大约 1 小时后可以创建快照,新增一块数据盘可创建快照的时间取决于磁盘数据的大小。
  • 如果创建快照还未完成,您无法为该磁盘再次创建快照。
  • 如果创建快照还未完成,这份快照无法用于创建自定义镜像 (CreateImage)。

调试

前往【API Explorer】在线调试,API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力,能显著降低使用云 API 的难度,强烈推荐使用。

请求参数

名称 类型 是否必选 示例值 描述
DiskId String d-diskid1

磁盘ID。

Action String CreateSnapshot

系统规定参数。取值:CreateSnapshot

ClientToken String 123e4567-e89b-12d3-a456-426655440000

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符,且不能超过 64 个字符。更多详情,请参阅 如何保证幂等性。

Description String FinanceDepet

快照的描述。长度为 2~256 个英文或中文字符,不能以 http:// 和 https:// 开头。

默认值:空

OwnerAccount String ECSforCloud@Alibaba.com

RAM用户的账号登录名称。

SnapshotName String FinanceJoshua

快照的显示名称。长度为 2~128 个英文或中文字符。必须以大小字母或中文开头,不能以 http:// 和 https:// 开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。

为防止和 自动快照 的名称冲突,不能以auto开头。

Tag.N.Key String FinanceDept

快照的标签键。n 的取值范围:1~20。一旦传入该值,则不允许为空字符串。最多支持 64 个字符,不能以 aliyun、acs:、http:// 或者 https:// 开头。

Tag.N.Value String FinanceDept.Joshua

快照的标签值。n的取值范围:1~20。一旦传入该值,可以为空字符串。最多支持 128 个字符,不能以 aliyun、acs:、http:// 或者 https:// 开头。

Tag.N.key String FinanceDept

快照的标签键。

说明 该参数即将被弃用,为提高兼容性,建议您尽量使用Tag.N.Key参数。

Tag.N.value String FinanceDept.Joshua

快照的标签值。

说明 该参数即将被弃用,为提高兼容性,建议您尽量使用Tag.N.Value参数。

返回参数

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求 ID。

SnapshotId String s-snapshotid1

快照 ID。

示例

请求示例


https://ecs.aliyuncs.com/?Action=CreateSnapshot
&DiskId=d-diskid1
&SnapshotName=FinanceJoshua
&Description=FinanceDepet
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Tag.1.value=FinanceDept.Joshua
&Tag.1.key=FinanceDept
&Tag.1.Key=FinanceDept
&Tag.1.Value=FinanceDept.Joshua
&<公共请求参数>

正常返回示例

XML 格式

<CreateSnapshotResponse>
  <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
  <SnapshotId>s-923FE2BF0</SnapshotId>
</CreateSnapshotResponse>

JSON 格式

{
	"RequestId":"C8B26B44-0189-443E-9816-D951F59623A9",
	"SnapshotId":"s-923FE2BF0"
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidDescription.Malformed The specified description is wrongly formed. 指定的资源描述格式不合法。长度为2-256个字符,不能以 http:// 和 https:// 开头。
403 QuotaExceed.Snapshot The snapshot quota exceeds. 快照额度超过限制,若要存储新快照,在不影响业务的情况下,请您删除已有的老快照。
403 DiskInArrears The specified operation is denied as your disk has expired. 磁盘欠费过期。
403 DiskId.ValueNotSupported The specified parameter diskid is not supported. 当前磁盘类型不支持此操作
403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance. 账号余额不足,请您先充值再进行该操作。
404 InvalidVolumeId.NotFound The specified volume does not exist. 指定的共享块存储不存在,请您检查共享块存储是否正确。
403 IdempotentParameterMismatch The specified clientToken is used. 指定的token已被使用。
403 IncorrectDiskStatus.Invalid The specified device status invalid, restart instance and try again. 指定磁盘的状态无效,请重启实例后重试。
403 IncorrectDiskType.NotSupport The specified device type is not supported. 指定磁盘存储类型不支持此操作。
403 IncorrectDiskStatus.Transferring The specified device is transferring, you can retry after the process is finished. 指定磁盘正在迁移中,请在迁移完毕后重试。

查看本产品错误码

发布者:佚, 佚名,转转请注明出处:https://www.cms2.cn/aliyun/1929.html

发表评论

邮箱地址不会被公开。 必填项已用*标注