- 地域
- 询价
- 实例
- 镜像
- 块存储
- 快照
- 创建快照CreateSnapshot
- 查询云盘快照列表DescribeSnapshots
- 查询快照数量和容量DescribeSnapshotsUsage
- 修改快照属性ModifySnapshotAttribute
- 修改快照类型ModifySnapshotCategory
- 复制快照CopySnapshot
- 删除指定快照DeleteSnapshot
- 查询云盘快照链DescribeSnapshotLinks
- 创建快照一致性组CreateSnapshotGroup
- 查询快照一致性组DescribeSnapshotGroups
- 修改快照一致性组ModifySnapshotGroup
- 删除快照一致性组DeleteSnapshotGroup
- 创建自动快照策略CreateAutoSnapshotPolicy
- 查询已创建的自动快照策略DescribeAutoSnapshotPolicyEx
- 修改一条自动快照策略ModifyAutoSnapshotPolicyEx
- 为云盘应用自动快照策略ApplyAutoSnapshotPolicy
- 取消一块或者多块云盘的自动快照策略CancelAutoSnapshotPolicy
- 删除一条自动快照策略DeleteAutoSnapshotPolicy
- 查询某地域下已购买对象存储OSS存储包DescribeSnapshotPackage
- 网络
- 弹性网卡
- 前缀列表
- 安全组
- 密钥对
- 启动模板
- 弹性供应组
- 部署集
- 资源保障
- 预留实例券
- 存储容量单位包
- 云助手
- 系统事件
- 资源诊断
- 运维与监控
- 标签与资源组
- 专有宿主机
- 高性能集群
- 任务
- Deprecated
接口说明
原本地快照更替为快照极速可用能力。参数说明如下:
- 如果您在 2020 年 12 月 14 日之前使用过本地快照,您可以正常使用参数
Category
。 - 如果您在 2020 年 12 月 14 日之前未使用过本地快照,无需额外进行配置,ESSD 系列云盘(ESSD、ESSD AutoPL、ESSD Entry 和 ESSD 同城冗余)新建的快照将默认为创建后极速可用,且同时支持手动快照和自动快照。API 接口中的“InstantAccess”、“InstantAccessRetentionDays”、“DisableInstantAccess”三个极速可用功能相关参数不再生效,“DescribeSnapshots”、“DescribeSnapshotGroups”这两个 API 接口将新增出参 Available 来描述快照可用的状态。
前提条件:
-
已开通快照。具体操作,请参见开通快照。
-
云盘必须处于使用中或待挂载状态。不同状态下的注意事项如下:
创建快照时,您需要注意:
-
创建快照应避开业务高峰期。创建快照时,云盘 I/O 性能降低 10%以内,读写性能出现短暂瞬间变慢。
-
如果创建快照还未完成,这份快照无法用于创建自定义镜像( CreateImage )。
-
创建快照期间,操作云盘产生的增量数据不会备份到快照中。
-
如果云盘已挂载到 ECS 实例上,创建快照期间请勿变更实例状态,如停止或重启 ECS 实例,否则会导致快照创建失败。
-
正在创建快照的云盘不支持扩容。请您等待快照创建完成后,再开始执行扩容操作。
-
支持对处于已过期(
Expired
)状态的云盘创建快照。若创建快照时云盘正好达到过期释放时间,云盘被释放的同时也会删除创建中(Creating
)的快照。 -
创建快照后,系统根据快照容量大小,按每个地域单独结算费用。更多信息,请参见快照计费
-
以下场景中,您无法为指定的云盘创建快照:
-
云盘保留的手动快照数达到了 256 份。
-
上份快照还未完成创建。
-
查询 ECS 实例信息时,如果返回数据中包含
{"OperationLocks": {"LockReason" : "security"}}
,则禁止一切操作。
-
请求参数
字段名称 | 字段详情 |
---|---|
DiskIdstring | 云盘 ID。 示例值:d-bp1s5fnvk4gn2tws0****参考取值来源: CreateDisk DescribeDisks |
SnapshotNamestring | 快照的名称。长度为 2~128 个字符,必须以大小写字母或中文开头,支持 Unicode 中 letter 分类下的字符(其中包括英文、中文等),ASCII 数字(0-9)。可以包含半角冒号(:)、下划线(_)、半角句号(.)或者短划线(-)。展开详情 示例值:testSnapshotName参考取值来源: CopySnapshot DescribeSnapshots |
Descriptionstring | 快照的描述。长度为 2~256 个英文或中文字符,不能以 示例值:testDescription |
RetentionDaysinteger<int32> | 设置快照的保留时间,单位为天。取值范围:1~65536。保留时间到期后快照会被自动释放。展开详情 示例值:30 |
Categorystring | 快照类型。取值范围:展开详情 示例值:Standard |
ClientTokenstring | 保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符,且不能超过 64 个字符。更多详情,请参见如何保证幂等性。 示例值:123e4567-e89b-12d3-a456-426655440000 |
ResourceGroupIdstring | 快照所在的企业资源组 ID。 示例值:rg-bp67acfmxazb4p****参考取值来源: DescribeSecurityGroups |
InstantAccessboolean | 是否开启快照极速可用功能。取值范围:展开详情 示例值:false |
InstantAccessRetentionDaysinteger<int32> | 设置快照极速可用功能的保留时间,保留时间到期后快照将自动释放。该参数在 示例值:1 |
Tagarray<object> | 标签列表。 子级条数 <= 20 |
StorageLocationArnstring | 说明
该参数暂未开放使用。
示例值:null |
返回参数
字段名称 | 字段详情 |
---|---|
SnapshotIdstring | 快照 ID。 示例值:s-bp17441ohwka0yuh**** |
RequestIdstring | 请求 ID。 示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |