Docs

Elastic Compute Service

Snapshot group

RollbackSnapshotGroup - Roll back snapshot consistency group

Call the RollbackSnapshotGroup API to roll back one or more volumes in a snapshot consistency group.

precautions

Before rolling back a snapshot consistency group using the RollbackSnapshotGroup API, ensure the following steps are complete:

The snapshot consistency group has been created; the system disk has not had its operating system replaced since the group was created.

The instance status is “Stopped.” For instructions on stopping an instance, see Stop Instance.

None of the source volumes corresponding to all snapshots in the snapshot consistency group have been deleted, and the source volumes remain “Attached.”

All snapshots in the snapshot consistency group have the status “Available.”

Debugging

API Explorer

You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.

Go to debug

request parameters

Only interface-specific request parameters and some common parameters are listed below. For more information, see Common Parameters.

Action string required Example value: RollbackSnapshotGroup

The operation to perform is: RollbackSnapshotGroup.

Version string required Example value: 2020-04-01

The version of the API is: 2020-04-01.

ClientToken string Optional Example: 123e4567-e89b-12d3-a456-42665544****

Ensure request idempotence. This string is generated by your client to ensure uniqueness between different requests. Description as follows:

Case sensitive.

Not more than 64 ASCII characters.

SnapshotGroupId string required Example value: sg-bp1s5fnvk4gn2tws0****

Snapshot Consistency Group ID.

VolumeIds.N string[] required Example: testVolumeId

Snapshot consistency group's list of volumes to be rolled back.

tip

N represents the serial number of the snapshot consistency group volume. Use "&" to separate multiple snapshot consistency group volumes

SnapshotIds.N string[] required Example value: testSnapshotId

Snapshot consistency group's list of snapshots to be rolled back.

tip

N indicates the snapshot number; use & to separate multiple snapshots.

InstanceId string Optional Example: i-yc8hs88qt6jn7i5l\*\*\*\*

Snapshot consistency group's ECS instance ID.

Response Parameters

This interface does not have dedicated response parameters. For more details, refer to Response Structure.

Request example

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​

Back to example

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

error code

The table below lists error codes related to this interface and business logic. Refer to the Public Error Codes documentation for more information.

Status code	error code	error message	Create Volume
400	SnapshotGroupInvalidVolumeCount	The number of volumes in the snapshot consistency group is invalid.	Invalid number of volumes in the snapshot consistency group.

Last updated: 2026.01.09 18:19:56