--- name: cephaas-host_unmap title: Unmap volume from a host description: Unmap one or more volumes from host by using the UI, CLI, API or Terraform. last-updated: 2026-04-23 --- > ## Documentation Index > The table of contents for this documentation set is at https://cloud.ibm.com/docs/cephaas?format=markdown > The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt > Use these files to discover more information as needed. # Unmap volume from a host {: #unmap-hosts} Unmap one or more volumes from host by using the UI, CLI, API or Terraform. {: shortdesc} ## Unmap volume from a host from the UI {: #unmap-volume-from-host-ui} {: ui} To remove all mapping of a volume that is mapped to a host, complete the following steps. 1. Log in to the [IBM Cloud console ![External link icon](../icons/launch-glyph.svg "External link icon")](https://cloud.ibm.com/software-defined-storage) and Click **Deployments > deployment Name** link and then go to **Block storage > Hosts**. 2. Click the Host **Name** from which you want to unmap the volume. 3. On the Host details page, in the Mapped volumes list, locate the volume **Name** and click the kebab menu at the end of the row. 4. Click **Unmap**. A confirmation popup is displayed. 5. Click **Unmap** to confirm the unmapping of the selected volume from the host. You can also unmap the host from a volume from **Volume details** page. {: tip} ## Unmap a single volume for a host from the CLI {: #unmap-single-volume-for-hosts-cli} {: cli} Use the `host-mapping-delete` command and specify the `HOST-ID`, the `Volume-Mapping-ID`, and the endpoint url and the volume ID that is associated with the host to unmap it. The `Volume-Mapping-ID` can be found in the output of a get host or a get volume command Run the following command to delete a single volume mapping from a host. ```sh ibmcloud software-defined-storage host-mapping-delete --host-id HOST-ID --volume-mapping-id VOLUME-MAPPING-ID --url string ``` {: pre} See the following example. ```sh ibmcloud software-defined-storage host-mapping-delete \ --host-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \ --volume-mapping-id r134-f24710c4-d5f4-4881-ab78-7bfXX6281f39 \ --url $sds_endpoint ``` {: screen} 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..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](https://cloud.ibm.com/docs/cephaas?topic=cephaas-ic-sds-cli-reference&interface=cli&format=markdown#ic-config-commands). You can also use the alias `sds` as an alternative to `software-defined-storage` and `hstmd` as an alternative to `host-mapping-delete` for the CLI actions. {: tip} ## Unmap all volumes for a host from the CLI {: #unmap-all-volume-for-hosts-cli} {: cli} Use the `host-mapping-delete-all` command and specify the `HOST-ID` along with the endpoint url to unmap all volumes that are associated with the host. Run the following command to delete all volume mappings from a host. ```sh ibmcloud software-defined-storage host-mapping-delete-all --host-id HOST-ID --url string ``` {: pre} See the following example. ```sh ibmcloud software-defined-storage host-mapping-delete-all \ --host-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \ --url $sds_endpoint ``` {: screen} 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..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](https://cloud.ibm.com/docs/cephaas?topic=cephaas-ic-sds-cli-reference&interface=cli&format=markdown#ic-config-commands). You can also use the alias `sds` as an alternative to `software-defined-storage` and `hstmda` as an alternative to `host-mapping-delete-all` for the CLI actions. {: tip} ## Unmap a volume for a host with the API {: #unmap-single-volume-for-host-api} {: api} Make a `DELETE /hosts/{id}/volumes/{vol_id}` request to delete a specific volume that is mapped to a host. ```sh curl -X DELETE $sds_endpoint/hosts/r134-0dcd5d2d-07db-4457-ab0b-1fc3eef28c66/volume_mappings/r134-152a73a9-dee8-4475-ad7c-fe73494140dd \ -H "Authorization: $IAM_TOKEN" \ -H 'IBM-API-Version: 2025-02-01' ``` {: pre} 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..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](https://cloud.ibm.com/docs/cephaas?topic=cephaas-ic-sds-cli-reference&interface=cli&format=markdown#ic-config-commands). The command unmaps a volume from a host. There is no response that is returned if the request is successful. To verify that the volume mapping for a host is deleted, list the host details by making a `GET /hosts/{id}` request. ## Unmap all volumes for a host with the API {: #unmap-all-volume-for-host-api} {: api} Make a `DELETE /hosts/{id}/volumes` request to delete all volumes that are mapped for a host. ```sh curl -X DELETE '$sds_endpoint/hosts/r134-0dcd5d2d-07db-4457-ab0b-1fc3eef28c66/volume_mappings' \ -H "Authorization: $IAM_TOKEN" \ -H 'IBM-API-Version: 2025-02-01' ``` {: pre} 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..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](https://cloud.ibm.com/docs/cephaas?topic=cephaas-ic-sds-cli-reference&interface=cli&format=markdown#ic-config-commands). The command unmaps all volumes from a host. There is no response that is returned if the request is successful. To verify that all volumes mappings for a host are deleted, list the hosts by making a `GET /hosts/{id}` request. ## Unmapping a volume for a host using Terraform {: #unmap-volume-host-tf} {: terraform} To unmap a volume from a host, do the following steps: 1. Open your `main.tf` file and comment out/remove the `ibm_sds_volume_mapping` resource. 2. After editing and saving the file, run commands `terraform plan` and `terraform apply` to apply your changes.