lsvolumegroup

Use the lsvolumegroup command to display information about configured volume groups.

Syntax

Parameters

-filtervalue attribute=value

(Optional) Specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are displayed.

Note: Some filters allow the use of a wildcard when you enter the command. The following rules apply to the use of wildcards:

The wildcard character is the asterisk (*).
The command can contain a maximum of one wildcard.
When you use a wildcard, enclose the filter entry within double quotation marks (""): lsvolumegroup -filtervalue id="1*"

-delim delimiter

(Optional) By default in a concise view, all columns of data are space-separated. The width of each column is set to the maximum width of each item of data. In a detailed view, each item of data has its own row, and if the headers are displayed, the data is separated from the header by a space. The -delim parameter overrides this behavior. Valid input for the -delim parameter is a 1-byte character. If you enter -delim : on the command line, the colon character (:) separates all items of data in a concise view; for example, the spacing of columns does not occur. In a detailed view, the data is separated from its header by the specified delimiter.

-nohdr

(Optional) By default, headings are displayed for each column of data in a concise style view, and for each item of data in a detailed style view. The -nohdr parameter suppresses the display of these headings.

Note: If there is no data to be displayed, headings are not displayed.

-filtervalue?

(Optional) Displays a list of valid filter attributes. The following filters for the lsvolumegroup command are valid:

id
name
volume_count
backup_status
last_backup_time

volumegroup_id | volumegroup_name

(Optional) Specifies a volume group ID or volume group name. The value must be a number for the ID and an alphanumeric string for the name.

Description

This command displays information about configured volume groups.

This table provides the attribute values that can be displayed as output view data.

Table 1. lsvolumegroup output
Attribute	Description
id	Indicates the volume group ID. The value must be a number.
name	Indicates the volume group name. The value must be an alphanumeric string.
volume_count	Indicates the number of volume members in a group. The value must be a number.
backup_status	Indicates whether a new (volume) group snapshot can be started. The values are: `empty` `off` `not_ready` `ready` `copying` `copying_error` If a group snapshot is in progress, the value represents the snapshot operation status.
last_backup_time	Indicates the most recent volume group snapshot time. The value must be in the `YYMMDDHHMMSS` format (or blank).
owner_id	Indicates the ID of the ownership group.
owner_name	Indicates the name of the ownership group.

A concise invocation example

lsvolumegroup

The resulting output:

id                   name       volume_count         backup_status     last_backup_time owner_id owner_name
0                    VG1        5                    copying           160308115216     0        tenantA
1                    VG2        0                    not_ready         150408115216     0        tenantA

A detailed invocation example

lsvolumegroup 1

The resulting output:

id 1
name VG2
volume_count 0
backup_status not_ready
last_backup_time
owner_id 0
owner_name tenantA