A volume is a detachable block storage device. You can think of it as a USB hard drive. You can attach a volume to one instance at a time.
When you create, list, or delete volumes, these status values are possible:
| Status | Description |
|---|---|
creating |
The volume is being created. |
available |
The volume is ready to be attached to an instance. |
attaching |
The volume is attaching to an instance. |
in-use |
The volume is attached to an instance. |
deleting |
The volume is being deleted. |
error |
An error occurred during volume creation. |
error_deleting |
An error occurred during volume deletion. |
backing-up |
The volume is being backed up. |
restoring-backup |
A backup is being restored to the volume. |
error_restoring |
An error occurred during backup restoration to a volume. |
| Method | URI | Description |
|---|---|---|
| POST | /v2/{tenant_id}/volumes | Creates a volume. |
| GET | /v2/{tenant_id}/volumes | Lists summary information for all Block Storage volumes that the tenant who submits the request can access. |
| GET | /v2/{tenant_id}/volumes/detail | Lists detailed information for all Block Storage volumes that the tenant who submits the request can access. |
| GET | /v2/{tenant_id}/volumes/{volume_id} | Shows information about a specified volume. |
| PUT | /v2/{tenant_id}/volumes/{volume_id}{?display_description,display_name} | Updates a volume. |
| DELETE | /v2/{tenant_id}/volumes/{volume_id} | Deletes a specified volume. |
