接口说明

原本地快照更替为快照极速可用功能。参数说明如下：

• 如果您在2020年12月14日之前使用过本地快照。您可以正常使用参数Category和InstantAccess，但需要注意：
  • 参数Category和InstantAccess不能同时传值。
  • 参数Category和InstantAccess均不传值时，默认创建普通快照。

• 如果您在2020年12月14日之前未使用过本地快照。您只能使用参数InstantAccess，不能使用参数Category。

  更多信息，请参见12月14日阿里云快照服务升级与新增计费项通知。

以下场景中，您无法为指定的云盘创建快照：

• 云盘保留的手动快照数达到了256份。
• 上份快照还未完成创建。
• 云盘挂载的实例从未启动过。
• 云盘挂载的实例未处于已停止（Stopped）或者运行中（Running）状态。
• 查询ECS实例信息时，如果返回数据中包含{"OperationLocks": {"LockReason" : "security"}}，则禁止一切操作。

创建快照时，您需要注意：

• 新建一台云服务器ECS或者更换系统盘大约一小时后才可以创建快照，新增一块数据盘可创建快照的时间取决于云盘数据的大小。
• 如果创建快照还未完成，这份快照无法用于创建自定义镜像（CreateImage）。
• 如果云盘已挂载到ECS实例上，创建快照期间请勿变更实例状态。
• 支持对处于已过期（Expired）状态的云盘创建快照。若创建快照时云盘正好达到过期释放时间，云盘被释放的同时也会删除创建中（Creating）的快照。

请求参数

返回数据

示例

请求示例

https://ecs.aliyuncs.com/?Action=CreateSnapshot
&DiskId=d-bp1s5fnvk4gn2tws0****
&SnapshotName=testSnapshotName
&Description=testDescription
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Tag.1.Key=TestKey
&Tag.1.Value=TestValue
&<公共请求参数>

正常返回示例

XML 格式

<CreateSnapshotResponse>
          <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
          <SnapshotId>s-bp17441ohwka0yuh****</SnapshotId>
</CreateSnapshotResponse>

JSON 格式

{
    "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
    "SnapshotId": "s-bp17441ohwka0yuh****"
}

错误码

访问错误中心查看更多错误码。