# Volume State

Volume state is a property of <code class="expression">space.vars.product\_name</code> block storage service volumes that describes the current state that the volume is in. The status value is displayed in <code class="expression">space.vars.product\_name</code> UI in the volumes grid view, and can be queried using `pcdctl` CLI.

The list below describes possible values for volume state and their meaning.

* **creating** - The volume is being created
* **reserved** - The volume is currently being held for attachment to a VM and is temporarily unavailable for other operations. A volume enters this state temporarily when being prepared for attachment to a VM.
* **attaching** - The volume is being attached to an VM.
* **detaching** - The volume is being detached from a VM.
* **in-use** - The volume is attached to a VM.
* **maintenance** - The volume is locked and being migrated.
* **deleting** - The volume is being deleted.
* **awaiting-transfer** - The volume is awaiting transfer to another tenant. A volume enters this state when it's being transferred from one tenant to another.
* **error** - A volume creation error occurred.
* **error\_deleting** - A volume deletion error occurred.
* **retyping** - The volume is changing type to another volume type. Read more about [volume retying here](https://docs.platform9.com/private-cloud-director/2025.10/storage/volume/..#volume-retype---changing-volume-type--migration-across-backends)
* **extending** - The volume is being extended.
* **error\_extending** - An error occurred while attempting to extend the volume.
* **downloading** - The volume is downloading an image.
* **uploading** - The volume is being uploaded to an image.
* **backing-up** - The volume is being backed up.
* **restoring-backup -** A backup is being restored to the volume.
* **error\_backing-up** - A backup error occurred.
* **error\_restoring** - A backup restoration error occurred.
