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

描述

调试

请求参数

返回参数

示例

错误码

相关推荐

管理配额

CopyImage

查看实例健康状况

分配多个辅助私网IP地址

DescribeInstancesFullStatus

AddTags

发表评论