Restoring a volume from a snapshot

Creating a volume from the list of snapshots in the UI

From the list of Block Storage for VPC snapshots, you can create an Block Storage for VPC volume and specify whether it's to be attached to a virtual server instance or unattached (stand-alone). If you choose to attach a data volume, you can select an existing virtual server instance or choose to create an instance. The new volumes are added to the list of Block Storage for VPC volumes.

1. Go to the list of Block Storage for VPC snapshots. In the IBM Cloud console, click the Navigation menu icon > VPC Infrastructure > Storage > Block Storage snapshots.

2. Select a snapshot from the list. It must be in a stable state.

3. From the Actions icon , select Create volume.

4. In the side panel, choose whether you want to create an unattached data volume, create and attach a volume to an existing instance, or create a volume and provision a new instance.

   • For a stand-alone data volume, leave Attach volume to virtual server clear.

   Use this option when you're not sure which virtual server instance you want to attach the volume to.

   • To attach the volume to an existing instance, select Attach volume to virtual server. Click Attach new volume to an existing virtual server. Then, select the virtual server instance that you want to attach the volume to. You can filter the list of available servers by zone.
   • To restore a volume and use it to provision a virtual server instance, select Attach volume to virtual server, and click Attach new volume to a new virtual server. Then, click Configure virtual server. This action takes you to the virtual server provisioning page.

   The new volume is shown in the Boot volume or Data volume section of the instance provisioning page. The placement depends on whether the volume that you created was from a bootable snapshot or a nonbootable snapshot.

5. Provide the required volume details.

   Table 1. Create volume options.

   Field	Description
   Volume details	Define the new volume.
   Name	Enter a name for the new volume.
   Resource group	Use the defaults or select from the list.
   Zone	Inherited from the snapshot. Change it to another zone in your region if you want to.
   Size	Enter a volume size allowed by the profile. The default is the minimum provisioning size based on the snapshot.
   Profile	Defaults to the snapshot's IOPS tier or custom profile. You can change the profile.
   IOPS	For IOPS tiers, specify an IOPS tier profile. For custom IOPS, select a range.
   Size	Enter a volume size that is allowed by the profile.
   Encryption	Inherited from the snapshot.

6. When finished, click Save. The new volume is created.

Creating a volume from the snapshot details page in the UI

Follow these steps to create a volume from the snapshot details page in the UI.

1. Go to the list of Block Storage for VPC volumes and select a volume. In the IBM Cloud console, click the Navigation menu icon > VPC Infrastructure > Storage > Block Storage volumes.
2. On the Block Storage for VPC volume details page, select the Snapshots and Backups tab. A list of snapshots that were created manually or by backup policies is shown.
3. From the list, click the snapshot name to go to its details page.
4. From the Actions menu, click Create volume.
5. Define the new volume in the side panel. The information that you need to provide is the same as when you create a volume from the list of snapshots. See Table 1 for the details.
6. When you're finished, click Save. The new volume is created.

Creating volumes for a virtual server instance from a consistency group

Follow these steps to create volumes for virtual server instance from the consistency groups page in the UI.

1. Go to the list of Block Storage for VPC snapshot consistency groups. In the IBM Cloud console, click the Navigation menu icon > VPC Infrastructure > Storage > Block Storage snapshots.

2. Select a snapshot consistency group from the list. It must be in a stable state.

3. From the Actions icon , select Create virtual server.

   • If the group has more than one bootable snapshot, you can choose the one that you want to use for the boot volume of the new virtual server instance. Then, click Configure virtual server.
   • If only one bootable snapshot is in the consistency group, you're taken directly to the VPC provisioning page.

4. The information about your region, profile, boot volume, and data volumes is populated in the New virtual server for VPC provisioning page.

   If you change the profile selection to Image or Existing volume, the boot volume snapshot is removed. The data volumes section is also populated with the nonbootable snapshots from the consistency group. You can remove a snapshot or create another data volume. However, if you removed a data volume and want to add it back, you must return to the step of selecting the consistency group again.

5. Configure other aspects of the virtual server instance such as networking and advanced features.

Creating a boot volume from a snapshot when you provision a virtual server instance in the UI

Follow these steps to create a boot and a data volume from snapshots when you provision a new virtual server instance.

1. In the IBM Cloud console, click the Navigation menu icon > VPC Infrastructure > Compute> Virtual server instances.
2. Click Create and provision your new instance. For more information about the required fields, see the table in Creating virtual server instances in the UI.
3. For the operating system, click Change image, then click the tab for Snapshots. The most recent bootable snapshot is listed.
   • If you want to use a different snapshot, click Edit. From the list of snapshots, select a bootable snapshot for your instance's operating system. Click Save. This action populates the snapshot data in the boot volume field on the provisioning page.
   • If you want to change the properties of the boot volume, such as the name, auto-delete feature, encryption, or tags, click the pencil icon. Change the property that you want and click Save. The boot volume information is updated on the provisioning page.
4. To create a data volume, under Data Volumes, click Create. A side panel is displayed.
   1. Select Import from snapshot. Expand the list to select a data snapshot. The most recent data snapshot is selected by default. However, you can select any snapshot from the list.
   2. The snapshot contains the properties of the original source volume, including the auto-delete status, tags, size, profile, and encryption. You can change all these properties. Keep in mind that you can change the volume name, profile, size, and IOPS later, but you cannot change the encryption type or CRK after the volume is created.
   3. Select a unique name, specify the size, and click Create. The data volume information is added in the Data volume list.
5. Review your selections for volumes, instance profile, SSH keys, networking, and so on.
6. If you are satisfied with your choices, click Create virtual server instance. The new instance is created with the volumes that you specified. The new instance appears in the list of virtual server instances.
7. To see the instance details, click the instance name. The volume or the volumes that you restored from snapshots are listed under Storage volumes. The camera icon indicates that the volume was created from a snapshot.

Creating a data volume from a snapshot for an existing virtual server instance with the UI

You can also create a data volume from a snapshot for an existing instance. Choose from the list of virtual server instances.

1. In the IBM Cloud console, click the Navigation menu icon > VPC Infrastructure > Compute> Virtual server instances.
2. From the list, click the name of an instance. The instance must be in a running state.
3. On the Instance details page, scroll to the list of Storage volumes and click Attach volumes. A side panel opens for you to define the volume attachment.
4. From the Attach storage volume panel, expand the list of Block Volumes, and select Create a data volume.
5. Select Import from snapshot. Expand the Snapshot list and select a snapshot.
6. The snapshot contains the properties of the original source volume, including the auto-delete status, tags, profile, and encryption. You can change all these properties. Keep in mind that you can change the volume name, profile, size, and IOPS later, but you cannot change the encryption type or CRK after the volume is created.
7. Select a unique name, specify the size, and click Save. The data volume information is added in the Data volume list.
8. Click Save. The side panel closes and messages indicate that the restored volume is being attached to the instance. The new volume appears in the list of Storage volumes. Hover over the camera icon to see the name of the snapshot from which it was created.

Before you begin

Before you can use the CLI, you must install the IBM Cloud CLI and the VPC CLI plug-in. For more information, see the CLI prerequisites.

1. Log in to IBM Cloud®.

   ibmcloud login --sso -a cloud.ibm.com
   

   This command returns a URL and prompts for a passcode. Go to that URL in your browser and log in. If successful, you get a one-time passcode. Copy this passcode and paste it as a response on the prompt. After successful authentication, you are prompted to choose your account. If you have access to multiple accounts, select the account that you want to log in as. Respond to any remaining prompts to finish logging in.

2. Select the current generation of VPC.

   ibmcloud is target --gen 2
   

3. Gather information about the snapshot or snapshots that you want to use to restore a volume.

   • If you want to restore a volume from a single snapshot, locate the snapshot first and view its details. You can use the CLI to view all the snapshots of an account in a region and select from the list. Alternatively, you can also list all the snapshots of a specific volume and choose one from the output. Then, use the ibmcloud is snapshots SNAPSHOT_ID command to list the details of the chosen snapshot.
   • If you want to restore an instance by restoring multiple volumes from a consistency group, you need to gather information about the snapshots in the consistency group. List all the consistency groups in the region. Then, take the ID of the consistency group and use it the ibmcloud is snapshots command to filter the output to the snapshots in the specified consistency group. See the following example.

   ibmcloud is snapshots --snapshot-consistency-group CONSISTENCY_GROUP_ID
   

Creating a boot volume from a snapshot for a new instance from the CLI

Run the ibmcloud is instance-create command with the source_snapshot property in the boot volume JSON. Specify the ID or name of a bootable snapshot. The restored boot volume is used to initialize the instance.

See the following example.

bmcloud is instance-create my-instance-restore1 ea002578-ff10-41fe-9652-e63f7e0e3cba us-south-1 bx2-2x8 ba11a6f2-6c17-4fee-a4b5-5c016fe64376 --boot-volume
'{
   "name":"boot-from-snapshot1",
   "volume":{
      "name":"boot-from-snapshot1",
      "profile":{
         "name":"general-purpose"
      },
      "source_snapshot":{
         "id":"d857c69f-d795-46ac-85e4-f26ca3001033"
      }
   }
}'

A successful response looks like the following example.

Creating instance my-instance-restore1 in resource group under account VP01 as user rtuser1@mycompany.com...

ID               0717-eded6dcd-4f3c-4e79-a0cb-00f7c72f38cd
Name             my-instance-restore1
CRN              crn:v1:bluemix:public:is:us-south-1/a1234567::instance:7101_eded6dcd-4f3c-4e79-a0cb-00f7c72f38cd
Status           pending
Profile          bx2-2x8
Architecture     amd64
vCPUs            2
Memory           8
Network(Gbps)    4
Image            ID                                         Name
                 6f153c4d-6a9a-496d-8063-5c39932f6ded       ibm-centos-7-6-minimal-amd64-2
VPC              ID                                         Name
                 ea002578-ff10-41fe-9652-e63f7e0e3cba       my-vpc
Zone             us-south-1
Resource group   ID                                         Name
                 cdc21b72d4f557b195de988b175e3d81           Default

Created          2022-06-14T17:03:30+08:00
Boot volume      ID                                   Name                  Attachment ID                            Attachment name
                 0651dacb-4589-4147-86b3-a77544598f93 boot-from-snapshot1                  0717-abf9dd2b-9d5d-41f1-849d-55a8ab580ddb                            boot-from-snapshot1

For more information about available command options, see ibmcloud is instance-create.

Creating a data volume from a snapshot for a new instance from the CLI

When you create an instance by using the ibmcloud is instance-create command, specify the source_snapshot parameter and snapshot name or ID in the volume attachment.

See the following example.

ibmcloud is instance-create my-instance-restore1 ea002578-ff10-41fe-9652-e63f7e0e3cba us-south-1 bx2-2x8 ba11a6f2-6c17-4fee-a4b5-5c016fe64376 --volume-attach
'{
   "name":"datavol-from-snapshot",
   "volume":{
      "name":"datavol-from-snapshot",
      "profile":{
         "name":"general-purpose"
      },
      "source_snapshot":{
         "id":"6daaaa39-3d81-4d1d-81f8-e1f6a14f97f3"
      }
   }
}'

For more information about available command options, see ibmcloud is instance-create.

Creating a data volume from a snapshot for an existing instance from the CLI

For an existing instance, specify the ibmcloud is instance-volume-attachment-add command with the source-snapshot parameter, and the name or ID of the snapshot. To find the ID of the snapshot from the CLI, see View snapshots from the CLI.

See the following example.

ibmcloud is instance-volume-attachment-add data-vol-1 a67f49de-fccc-4e5c-824e-dcbd06d009af --profile general-purpose --source-snapshot 52de6e85-7068-4247-90fd-d2fa91fd9864

For more information about available command options, see ibmcloud is instance-volume-attachment-add.

Creating a stand-alone volume from a snapshot from the CLI

You can create a stand-alone Block Storage for VPC data volume from a snapshot from the CLI. The volume is not attached to a virtual server instance. When you run the ibmcloud is volume command, the response shows the attachment type as unattached. You can attach the volume to an instance later.

Use this option when you're not sure which virtual server instance you want to attach the volume to. Or, if you want to restore data from an unattached volume that was detached from an instance.

Run the ibmcloud is volume-create command and specify the snapshot parameter and name or ID of the snapshot. For more information, see Create a stand-alone Block Storage for VPC volume from a snapshot.

For more information about available command options, see ibmcloud is volume-create.

Creating a boot volume when you provision an instance with the API

To restore a boot volume from a bootable snapshot when you create an instance, make a POST /instances request and specify the boot_volume_attachment property and the bootable snapshot ID in the source_snapshot subproperty.

See the following example.

curl -X POST \
"$vpc_api_endpoint/v1/instances?version=2023-03-07&generation=2" \
-H "Authorization: $iam_token" \
-H "Content-Type: application/json" \
-d '{
      "name": "my-server-name",
      "zone": {
         "name": "us-south-1"
      },
      "vpc": {
         "id": "4d27c489-8ad7-3c18-cbf4-2103d9f8da93"
      },
      "profile": {
         "name": "cx2-2x4"
      },
      "primary_network_interface": {
        "name": "region1example-net1",
        "subnet": {
           "id": ""
        }
      },
      "boot_volume_attachment": {
        "delete_volume_on_instance_delete": true,
        "volume": {
            "profile": {
                "name": "general-purpose"
            },
            "source_snapshot": {
                "id": "eb373975-4171-4d91-81d2-c49efb033753"
            }
        }
     },
    "resource_group": {
        "id": "2fab2c7f-c09d-4c64-baf7-1453b7461493"
    }
}'

Creating a data volume when you provision an instance with the API

To restore a data volume from a snapshot and attach it at boot time, make a POST /instances request and specify the data volume attachment and snapshot ID.

curl -X POST \
"$vpc_api_endpoint/v1/instances?version=2022-06-14&generation=2" \
-H "Authorization: $iam_token" \
-H "Content-Type: application/json" \
-d '{
      "name": "my-server-name",
      "zone": {
         "name": "us-south-1"
      },
      "vpc": {
        "id": "4d27c489-8ad7-3c18-cbf4-2103d9f8da93"
      },
      "profile": {
         "name": "cx2-2x4"
      },
      "primary_network_interface": {
        "name": "region1example-net1",
        "subnet": {
           "id": ""
        }
      },
     "volume_attachments": [
        {
            "name": "restore-data-vol1",
            "delete_volume_on_instance_delete": true,
            "volume": {
                "profile": {
                    "name": "general-purpose"
                },
                "source_snapshot": {
                    "id": "bdcdc984-ba4e-4aef-84fb-e8448c3116b1"
                }
            }
        }
     ]
    "resource_group": {
        "id": "2fab2c7f-c09d-4c64-baf7-1453b7461493"
    }
}'

Creating a stand-alone data volume from a snapshot with the API

You can use the API to create a stand-alone volume from a snapshot. Use this option when you're not sure which virtual server instance you want to attach the volume to. Or, if you want to restore data from an unattached volume that was detached from an instance.

To restore a stand-alone data volume from a snapshot, make a POST /volumes request and specify the ID, CRN, or URL of the snapshot in the source_snapshot property. The restored volume capacity (in GBs) must be at least the snapshot's minimum_capacity.

The following example request creates a 100-GB volume that is based on a 5 IOPS/GB profile. It specifies a different root key than the original snapshot. The source snapshot is specified by ID.

curl -X POST \
"$vpc_api_endpoint/v1/volumes/?version=2022-06-14&generation=2" \
-H "Authorization: $iam_token" \
-H "Content-Type: application/json" \
-d '{
     "name": "volume-from-snapshot-1",
     "capacity": 100,
     "profile": {
        "name": "5iops-tier"
     },
     "zone": {
        "name": "us-south-1"
     },
     "encryption_key":{
        "crn":"crn:[...]"
     },
     "source_snapshot:" {
        "id": "bdcdc984-ba4e-4aef-84fb-e8448c3116b1"
     }
   }`

Creating a boot volume when you provision an instance with Terraform

To restore a boot volume from a bootable snapshot when you create an instance, use the ibm_is_instance resource. The following example defines the new instance with the name my-server-name, and a cx2-2x4 profile, and creates the boot volume from the snapshot eb373975-4171-4d91-81d2-c49efb033753.

resource "ibm_is_instance" "example" {
  name    = "my-server-name"
  profile = "cx2-2x4"
  boot_volume {
    name     = "boot-restore"
    snapshot = eb373975-4171-4d91-81d2-c49efb033753
    tags     = ["dev:test"]
  }
  primary_network_interface {
    subnet = ibm_is_subnet.example.id
  }
  vpc  = 4d27c489-8ad7-3c18-cbf4-2103d9f8da93
  zone = "us-south-1"
  keys = [ibm_is_ssh_key.example.id]
}

For more information about the arguments and attributes, see ibm_is_instance.

Creating and attaching a data volume to an instance with Terraform

To restore a data volume from a nonbootable snapshot and attach the volume to an instance, use the ibm_is_instance_volume_attachment resource. See the following example.

resource "ibm_is_instance_volume_attachment" "example" {
  instance = ibm_is_instance.example.id

  name = "test-attachment-1"
  profile = "general-purpose"
  snapshot = "ibm_is_snapshot.example.id"
  delete_volume_on_attachment_delete = true
  delete_volume_on_instance_delete = true
  volume_name = "restore-data-vol1"
  }

For more information about the arguments and attributes, see ibm_is_instance_volume_attachment.

Creating a stand-alone data volume from a snapshot with Terraform

To create a volume from a snapshot, use the ibm_is_volume resource. The following example creates a volume from the snapshot bdcdc984-ba4e-4aef-84fb-e8448c3116b1 with the general-purpose performance profile.

resource "ibm_is_volume" "storage" {
  name            = "restore-data-vol1"
  profile         = "general-purpose"
  zone            = "us-south-1"
  source_snapshot = "ibm_is_snapshot.example.id"
}

For more information about the arguments and attributes, see ibm_is_volume.