3.14. Managing volumes¶
3.14.1. vinfra service compute volume create¶
Create a new compute volume:
usage: vinfra service compute volume create [--description <description>]
[--network-install <network_install>]
[--image <image>] [--snapshot <snapshot>]
--storage-policy <storage_policy>
--size <size-gb> <volume-name>
--description <description>
- Volume description
--network-install <network_install>
- Perform network installation (
true
orfalse
). --image <image>
- Source compute image ID or name
--snapshot <snapshot>
- Source compute volume snapshot ID or name
--storage-policy <storage_policy>
- Storage policy ID or name
--size <size-gb>
- Volume size, in gigabytes
<volume-name>
- Volume name
Example:
# vinfra service compute volume create myvolume --storage-policy default --size 8
+--------------------------------+--------------------------------------+
| Field | Value |
+--------------------------------+--------------------------------------+
| attachments | [] |
| availability_zone | nova |
| bootable | False |
| consistencygroup_id | |
| created_at | 2018-09-12T12:30:12.665916 |
| description | |
| encrypted | False |
| id | c9c0e9e7-ce7a-4566-99d5-d7e40f2987ab |
| imageRef | |
| migration_status | |
| multiattach | False |
| name | myvolume |
| network_install | False |
| os-vol-host-attr:host | |
| os-vol-mig-status-attr:migstat | |
| os-vol-mig-status-attr:name_id | |
| project_id | 72a5db3a033c403a86756021e601ef34 |
| replication_status | |
| size | 8 |
| snapshot_id | |
| source_volid | |
| status | creating |
| storage_policy_name | default |
| updated_at | |
| user_id | 98bf389983c24c07af9677b931783143 |
| volume_image_metadata | |
+--------------------------------+--------------------------------------+
This command creates a volume myvolume
sized 8 GB and chooses the default storage policy for it.
3.14.2. vinfra service compute volume list¶
List compute volumes:
usage: vinfra service compute volume list [--long] [--limit <num>]
[--marker <volume>] [--name <name>]
[--id <id>] [--project <project>]
[--status <status>] [--size <size>]
[--storage-policy <host>]
--long
- Enable access and listing of all fields of objects.
--limit <num>
- The maximum number of volumes to list. To list all volumes, set the option to -1.
--marker <volume>
- List volumes after the marker.
--name <name>
- List volumes with the specified name or use a filter. Supported filter operator:
contains
. The filter format is<operator>:<value1>[,<value2>,...]
. --id <id>
- Show a volume with the specified ID or list volumes using a filter. Supported filter operator:
in
. The filter format is<operator>:<value1>[,<value2>,...]
. --project <project>
- List volumes that belong to the specified project ID. Can only be performed by system administrators.
--status <status>
- List volumes with the specified status.
--size <size>
- List volumes with the specified size.
--storage-policy <host>
- List volumes with the specified storage policy name or ID.
Example:
# vinfra service compute volume list -c id -c name -c size -c status
+--------------------------------------+----------+------+-----------+
| id | name | size | status |
+--------------------------------------+----------+------+-----------+
| c9c0e9e7-ce7a-4566-99d5-d7e40f2987ab | myvolume | 8 | available |
+--------------------------------------+----------+------+-----------+
This command lists volumes available to the compute cluster. (The output is abridged to fit on page.)
3.14.3. vinfra service compute volume show¶
Display compute volume details:
usage: vinfra service compute volume show <volume>
<volume>
- Volume ID or name
Example:
# vinfra service compute volume show myvolume
+--------------------------------+------------------------------------------+
| Field | Value |
+--------------------------------+------------------------------------------+
| attachments | [] |
| availability_zone | nova |
| bootable | False |
| consistencygroup_id | |
| created_at | 2018-09-12T12:30:12.665916 |
| description | |
| encrypted | False |
| id | c9c0e9e7-ce7a-4566-99d5-d7e40f2987ab |
| imageRef | |
| migration_status | |
| multiattach | False |
| name | myvolume |
| network_install | False |
| os-vol-host-attr:host | node001.vstoragedomain@vstorage#vstorage |
| os-vol-mig-status-attr:migstat | |
| os-vol-mig-status-attr:name_id | |
| project_id | 72a5db3a033c403a86756021e601ef34 |
| replication_status | |
| size | 8 |
| snapshot_id | |
| source_volid | |
| status | available |
| storage_policy_name | default |
| updated_at | 2018-09-12T12:30:33.167654 |
| user_id | 98bf389983c24c07af9677b931783143 |
| volume_image_metadata | |
+--------------------------------+------------------------------------------+
This command shows the details for the volume myvolume
.
3.14.4. vinfra service compute volume set¶
Modify volume parameters:
usage: vinfra service compute volume set [--description <description>]
[--network-install <network_install>]
[--storage-policy <storage_policy>]
[--bootable <bootable>]
[--name <name>] <volume>
--description <description>
- Volume description
--network-install <network_install>
- Perform network install (
true
orfalse
) --storage-policy <storage_policy>
- Storage policy ID or name
--bootable <bootable>
- Make bootable (
true
orfalse
) --name <name>
- A new name for the volume
<volume>
- Volume ID or name
Example:
# vinfra service compute volume set myvolume --storage-policy mystorpolicy
+--------------------------------+------------------------------------------+
| Field | Value |
+--------------------------------+------------------------------------------+
| attachments | [] |
| availability_zone | nova |
| bootable | False |
| consistencygroup_id | |
| created_at | 2018-09-12T12:30:12.665916 |
| description | |
| encrypted | False |
| id | c9c0e9e7-ce7a-4566-99d5-d7e40f2987ab |
| imageRef | |
| migration_status | |
| multiattach | False |
| name | myvolume |
| network_install | False |
| os-vol-host-attr:host | node001.vstoragedomain@vstorage#vstorage |
| os-vol-mig-status-attr:migstat | |
| os-vol-mig-status-attr:name_id | |
| project_id | 72a5db3a033c403a86756021e601ef34 |
| replication_status | |
| size | 8 |
| snapshot_id | |
| source_volid | |
| status | available |
| storage_policy_name | mystorpolicy |
| updated_at | 2018-09-12T12:55:29.298717 |
| user_id | 98bf389983c24c07af9677b931783143 |
| volume_image_metadata | |
+--------------------------------+------------------------------------------+
This command changes the storage policy of the volume myvolume
to mystorpolicy
.
3.14.5. vinfra service compute volume extend¶
Extend a compute volume:
usage: vinfra service compute volume extend --size <size_gb> <volume>
<volume>
- Volume ID or name
Example:
# vinfra service compute volume extend myvolume --size 16
Operation successful
This command extends the volume myvolume
to 16 GB.
3.14.6. vinfra service compute volume delete¶
Delete a compute volume:
usage: vinfra service compute volume delete <volume>
<volume>
- Volume ID or name
Example:
# vinfra service compute volume delete myvolume2
Operation successful
This command deletes the volume myvolume2
.
Oct 06, 2020