lsvolumebackupgeneration

Use the lsvolumebackupgeneration command to list any volume snapshots available on the specified volume.

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 ("").

-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.

-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.

-filtervalue?

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

state

-volume volume_name | volume_id

(Required) Specifies the volume to list cloud snapshots for by volume ID or name.

Note: The volume must exist on the local system.

The value for volume ID must be a number and the value for volume name must be an alphanumeric string. This parameter is mutually exclusive with -uid.

-uid volume_UID

(Optional) Specifies the volume to list cloud snapshots for by volume UID. This parameter is mutually exclusive with -volume.

Description

This command lists any available volume snapshots for the specified volume.

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

Table 1. lsvolumebackupgeneration output
Attribute	Description
generation_id	Indicates the snapshot generation volume ID. The value must be a number.
backup_time	Indicates the timestamp of the most recent snapshot. The value must be in `YYMMDDHHMMSS` format (or blank).
volume_group_name	Indicate the volume group name. The value must be an alphanumeric string (or blank).
volume_size	Indicates the provisioned capacity of the volume during snapshot generation. This value can differ from the current volume size (the capacity in MB or GB) if a volume with the specified UID exists on the local system.
type	Indicates the type of volume snapshot generation. The values are `full` and `incremental`.
state	Indicates the state of the volume backup generation (in the cloud system). The values are: `copying` `complete` `deleting`
cloud_upload_size	Indicates the amount of data (the capacity in MB or GB) that is uploaded from the snapshot generation volume to the cloud system.

Generations that are being copied to the cloud account are included in the copying state value. Generations that are being deleted from the cloud account are also included in the deleting state value.

An invocation example

lsvolumebackupgeneration -volume 2

The resulting output:

generation_id backup_time   volume_group_name volume_size type        state    cloud_upload_size
1             160217021250                    50.00GB     full        complete 2.83GB
2             160217021355                    50.00GB     incremental complete 177.50MB
3             160218021402                    50.00GB     incremental complete 132.02MB
4             160219021400                    50.00GB     incremental copying  12.43MB

An invocation example

lsvolumebackupgeneration -uid 600507680CA880AB1200000000000015

The resulting output:

generation_id backup_time   volume_group_name volume_size type state     cloud_upload_size
1             160215021355                    10.00GB     full complete 53.88MB