# 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](/private-cloud-director/2026.1/storage/volume.md#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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.platform9.com/private-cloud-director/2026.1/storage/volume/volume-state.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.