6.2.12.8 lsvolume
List volumes.
Purpose
The lsvolume
command displays information about Exascale volumes.
Syntax
lsvolume [ volume-id [ volume-id ] ... ] [ -l ] [ --detail ] [ --attributes attribute[,attribute] ... ]
[ --filter filter[,filter] ... ] [ --sort [-]attribute[,[-]attribute] ... ]
[ --count value ]
Command Options
The options for the lsvolume
command are:
-
volume-id: Identifies an Exascale volume that you want to list information about. If not specified, the command displays information about all volumes.
-
-l
: Returns output in a long, tabular form. -
--detail
: Lists all attributes in a detailed form. -
--attributes
: Lists the specific attributes to display. -
--filter
: Used to specify conditions for filtering the list output. -
--sort
: Used to sort the output using the specified attributes. -
--count
: Specifies the maximum number of results to report.
Usage Notes
Note the following information when using this command:
-
Filter conditions are specified as:
<attribute><operator><value>
.The allowed operators are =, !=, >=, <=, >, and <.
Multiple comma-separated filter conditions are combined using AND logic.
Dates can be specified using the following formats:
yyyy-MM-dd''T''HH:mm:ss
yyyy-MM-dd
(Time is assumed to be 00:00 AM)HH:mm:ss
(Date is assumed to be today)
A date can also be followed by a timezone specification.
Sizes can be specified using suffixes
K
,KB
,M
,MB
,G
,GB
,T
,TB
. The suffix is not case-sensitive. -
Sorting attributes are specified as:
[-]attribute
. Multiple sort attributes are comma-delimited. The default sort order is ascending. For descending sort order, prefix the attribute name with-
.For example, use the following to primarily sort by name in descending order, and use creation time in ascending order to further sort entries with the same name:
--sort -name,createTime
Examples
Example 6-156 List Information for a Specific Volume
The following example shows how to list detailed information for volume ID:
2:50e52177583f4be4bad68ac20b65001e
.
@> lsvolume 2:50e52177583f4be4bad68ac20b65001e --detail
Example 6-157 List Specific Volume Attributes
The following example shows how to list specific volume attributes for volume
ID: 2:50e52177583f4be4bad68ac20b65001e
.
@> lsvolume 2:50e52177583f4be4bad68ac20b65001e --attributes id,size,iopsProvisioned
Example 6-158 List Volumes Matching a Filter
The following example shows how to list detailed volume information for volumes that are sized greater than 100 MB. The output is also sorted by volume size.
@> lsvolume --detail --filter size>100M --sort size
Parent topic: Block Store Management