文档中心

云服务器

请输入

快照一致性组

RollbackSnapshotGroup - 回滚快照一致性组

调用RollbackSnapshotGroup接口回滚快照一致性组的一块或多块云盘。

注意事项

使用RollbackSnapshotGroup接口回滚快照一致性组前，请确保已完成以下操作：

已创建快照一致性组；且创建快照一致性组后系统盘未更换过操作系统。

实例的状态为“已停止”。关于停止实例的操作步骤，请参见停止实例。

快照一致性组内所有快照对应的源云盘未被删除且源云盘处于“已挂载”状态。

快照一致性组中的快照状态均为“可用”。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：RollbackSnapshotGroup

要执行的操作，取值：RollbackSnapshotGroup。

Version string 必选示例值：2020-04-01

API的版本，取值：2020-04-01。

ClientToken string 可选示例值：123e4567-e89b-12d3-a456-42665544****

保证请求幂等性。该字符串由您的客户端生成，用以保证不同请求之间的唯一性。说明如下：

大小写敏感。

不超过64个ASCII字符。

SnapshotGroupId string 必选示例值：sg-bp1s5fnvk4gn2tws0****

快照一致性组 ID。

VolumeIds.N string[] 必选示例值：testVolumeId

待回滚的快照一致性组云盘列表。

说明

N表示快照一致性组云盘的序号，多个快照一致性组云盘用&分隔。

SnapshotIds.N string[] 必选示例值：testSnapshotId

待回滚的快照一致性组快照列表。

说明

N表示快照序号，多个快照用&分隔。

InstanceId string 可选示例值：i-yc8hs88qt6jn7i5l\*\*\*\*

快照一致性组所属的ECS实例ID。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

GET /?Action=RollbackSnapshotGroup&Version=2020-04-01&SnapshotGroupId=sg-7e2gbxchg89jwlcg****&VolumeIds.1=vol-3tiz8tg97u3vj0x0****&VolumeIds.2=vol-3tj20xxpd63vj0wy****&SnapshotIds.1=snap-2sj1ak6w1rlsphxr****&SnapshotIds.2=snap-2sj22l3aqdlspich****&InstanceId=i-yc8hs88qt6jn7i5l**** HTTP/1.1​
Host: open.volcengineapi.com​
Region: cn-beijing​
ServiceName: storage_ebs​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "2022050520060001021207006918C1****",​
        "Action": "RollbackSnapshotGroup",​
        "Version": "2020-04-01",​
        "Service": "storage_ebs",​
        "Region": "cn-beijing"​
    },​
    "Result": {}​
}​

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	SnapshotGroupInvalidVolumeCount	The number of volumes in the snapshot consistency group is invalid.	快照一致性组中的卷数无效。

最近更新时间：2026.01.08 11:19:59

这个页面对您有帮助吗？

有用

无用