Deleting a block volume

Deleting block volumes in the UI

Deleting a block storage volume completely removes its data. The volume cannot be restored.

You cannot delete an active Block Storage volume. To delete a volume, first unmap it from the host.

To delete a single volume, follow these steps:

1. On the IBM Cloud console, go to IBM Storage Ceph as a Service > Block storage > Volumes.

2. Locate the volume that you want to delete and then click the kebab menu at the end of the row to open a list of options.

3. From the options menu, click Delete.

Deleting multiple block volumes in the UI

Deleting a Block Storage volume completely removes its data. The volume cannot be restored.

You cannot delete an active Block Storage volume. To delete a volume, first unmap it from the host.

To delete multiple volumes together, follow these steps:

1. On the IBM Cloud console, go to IBM Storage Ceph as a Service > Block storage > Volumes.

2. Select the volumes that you want to delete.

3. Click Delete.

You can choose a maximum of 10 volumes only for deletion at one time.

Deleting a block volume from the CLI

Use the volume-delete command to delete a single volume. Specify the volume ID with --volume-id VOLUME-ID and API endpoint url.

Run the following command to delete a volume.

ibmcloud software-defined-storage volume-delete --volume-id VOLUME-ID --url string

See the following example.

ibmcloud software-defined-storage volume-delete --volume-id r134-af4273d1-b1a2-4ba8-82aa-2285133e2682

The $sds_endpoint is an environment variable that points to the endpoint provided to you when IBM Storage Ceph as a Service was configured. It is in the URL form. For example, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. You can set the URL once and then not have to add it for every command. For guidance on how to set the URL, see Config commands.

You can also use the alias sds as an alternative to software-defined-storage and vold as an alternative to volume-delete for the CLI actions.

Deleting a block volume with the API

Make a DELETE /volumes/{volume_id} request to delete a volume. This operation cannot be reversed. For this request to succeed, the volume must not be mapped to any hosts.

curl -X DELETE $sds_endpoint/volumes/${id}\
  -H 'accept: application/json'\
  -H "Authorization: Bearer $IAM_TOKEN"\
  -H 'IBM-API-Version: 2025-02-01'

There is no response body for a successful delete operation.

To verify that the volume is deleted, list the volumes by making a GET /volumes request.

Deleting a block volume using Terraform

To delete a resource using Terraform, you can run terraform destroy -target <resource_type>.<resource_name> where <resource_name> is the name of the resource that is no longer needed.

Example of <resource_type>.<resource_name>: ibm_sds_volume.sds_volume_instance.

First, show the list of Terraform resources

terraform state list

Then, target a specific resource to destroy

terraform destroy -target ibm_sds_volume.sds_volume_instance

If a volume is mapped to a host, you must unmap the volume from host before deletion using the CLI.