6.2.12.13 lsvolumegroup
List volume groups.
Purpose
The lsvolumegroup
command displays information about Exascale volume groups.
Syntax
lsvolumegroup [ volume-group-ID [ volume-group-ID ]... ] [ -l ] [ --detail ]
[ --attributes attribute[,attribute]... ]
[ --filter filter[,filter]... ]
[ --sort [-]attribute[,[-]attribute]... ]
[ --count value ]
Command Options
The options for the lsvolumegroup
command
are:
-
volume-group-ID: Identifies an Exascale volume group that you want to list information about. If not specified, the command displays information about all volume groups.
-
-l
: Displays output in a long, tabular format. -
--detail
: Displays detailed output with additional attributes. -
--attributes
: Identifies specific attributes to display in the output.To see a list of all available attributes and their descriptions, use the
describe volumegroups
command. See also Describing Resources and Attributes. -
--filter
: Specifies conditions for including items in the output. -
--sort
: Sorts the output using the specified attributes. -
--count
: Specifies the maximum number of items to display in the output.
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.
For example, the following filter only includes objects created after 9 AM today:
--filter createTime>9:00:00
-
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-166 List Information for Volume Groups
The following example shows how to list detailed information about all volume groups.
@> lsvolumegroup --detail
Example 6-167 List Information for Specific Volume Groups
The following example shows how to list detailed information about two volume groups with specific IDs.
@> lsvolumegroup volgrp0001_08a99eb7e8ff41499dee41de75af3e62 volgrp0002_67e399099f3845eeb2310485a13d1aee --detail
Example 6-168 List Information for Specific Volume Groups
The following examples shows how to list information about volume groups matching the specified filter conditions.
@> lsvolumegroup --filter name=my-group*
@> lsvolumegroup --filter iopsProvisioned>1000
Parent topic: Block Store Management