Skip to main content

Detaching a Volume

Detach a Shared Storage Volume from a virtual machine to return it to the AVAILABLE state.

Detaching a Shared Storage Volume (SSV) from a virtual machine returns it to the AVAILABLE state so it can be reattached to another VM or deleted. This guide covers how to detach a volume in the Hyperstack UI or API, and when you should detach before changing a VM's state.

Detach a Volume​

To detach a volume from a virtual machine:

  1. Go to the Virtual Machines page and click the VM the volume is attached to.
  2. Open the Volumes tab on the VM details page.
  3. In the volume row, open the Actions menu (⋮) and click Detach.
  4. The volume transitions IN-USE to DETACHING to AVAILABLE. Once AVAILABLE, the volume can be reattached to another VM or deleted.

You can also detach a volume programmatically using the Detach volumes from virtual machine API endpoint.

Detach Before Hibernating or Deleting the VM​

We recommend detaching attached volumes before hibernating or deleting the VM they are attached to. This keeps the volumes immediately reusable and avoids the RESERVED state, which can occur when the VM the volume is attached to is hibernated or deleted. See Reserved Volumes for recovery if a volume is already RESERVED.


Back to top

On this page