Clone consistency groups or create consistency group from group snapshot

Snapshots and groups can be used to help prepare your environment for recovery. You can create a consistency group from a source, that is cloning a consistency group or creating a consistency group from a group snapshot. The IBM Cloud Infrastructure Center consistency groups feature uses OpenStack generic volume group APIs.

When you create a consistency group from a source, you can specify the target storage template, then the volumes in target consistency group are created by the storage template you specified. If you do not specify it, the volumes in the target consistency group are created by the same storage templates as the volumes in the source.

Clone consistency group

Request Method

POST

Request URL

/v3/{project_id}/groups/action

Request parameters

Table 1. Parameters in the request of cloning a group

Name Style Type Required Description
project_id path string Required The project UUID in a multi-tenancy cloud.
create-from-src body object Required The action object of creation from source group.
name body string Required The group name.
description body string Optional The group description.
source_group_id body string Required The source group ID.
target_volume_type_id body string Optional The storage template for volumes in target group.

Request example:

{
    "create-from-src": {
        "name": "cloned-group-1",
        "description": "cloned from group-1",
        "source_group_id": "4bac81dd-011f-4cc4-8a7f-32b74c56af97",
        "target_volume_type_id": "a2207520-491e-40c1-b00f-5b21f61f4253"
    }
}

Table 2. Parameters in the response of cloning a group

Name Style Type Description
group body object A group object.
id body string The UUID of the group.
name body string The group name.

Response sample:

{"group": {
   "id": "5a777765-d2ba-438e-9875-dd57df77481f",
   "name": "cloned-group-1"
}}

Create group from snapshot

Request Method

POST

Request URL

/v3/{project_id}/groups/action

Request parameters

Table 3. Parameters in the request of cloning a group

Name Style Type Required Description
project_id path string Required The project UUID in a multi-tenancy cloud.
create-from-src body object Required The action object of creation from source group.
name body string Required The group name.
description body string Optional The group description.
group_snapshot_id body string Required The source group snapshot ID.
target_volume_type_id body string Optional The storage template for volumes in target group.

Request example:

{
    "create-from-src": {
        "name": "created-from-snapshot-1",
        "description": "created from group snapshot",
        "group_snapshot_id": "e3c253d3-d8cf-4e2d-bdce-2579e8bdccc0",
        "target_volume_type_id": "a2207520-491e-40c1-b00f-5b21f61f4253"
    }
}

Table 4. Parameters in the response of creating a group

Name Style Type Description
group body object A group object.
id body string The UUID of the group.
name body string The group name.

Response sample:

{"group": {
   "id": "2c454cf6-25e2-4367-b40d-88abf52f4441",
   "name": "created-from-snapshot-1"
}}