lsvolumebackup

Edit online

Use the lsvolumebackup command to list the volumes that have cloud snapshot that enabled and volumes that have cloud snapshots in the cloud account.

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 (""): lsvolumebackup -filtervalue volume_id="1*"

-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 lsvolumebackup command are valid:

volume_UID
volume_id
volume_name
volume_group_id
volume_group_name
cloud_account_id
cloud_account_name

Description

This command lists the volumes that use cloud snapshot and also lists volumes that have cloud snapshots in the cloud account.

This view spans all cloud accounts. To refresh the view by reloading what is on the cloud, specify chcloudaccountawss3 -refresh 0 or chcloudaccountswift -refresh 0.

A snapshot that is being copied to the cloud (which means the snapshot status value is copying or copying_error) does not count towards the generation count total for the volume. Not counting towards the generation means that it is not available for a restore, and if there is a local system failure, the generation no longer exists in the cloud.

The specified volume appears in the displayed output when the volume has cloud snapshot that is enabled. The generation count is initially 0 and remains 0 while the volume copy is in progress. The generation count changes to 1 after the copy completes.

The last snapshot time is blank while the first snapshot is in progress. A snapshot that is being deleted from the cloud counts toward the generation count for the volume even if it is not available for a restore.

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

Table 1. lsvolumebackup output
Attribute	Description
volume_UID	Indicates the volume UID.
volume_id	Indicates the volume ID if a volume with the specified UID exists on the local system. The value must be a number (or blank).
volume_name	Indicates the volume name. The value must be an alphanumeric string.
volume_group_id	Indicates the volume group ID that the volume is a member of (if applicable), if a volume with the specified UID exists on the local system. The value must be a number (or blank).
volume_group_name	Indicates the volume group name that the volume is a member of (if applicable), if a volume with the specified UID exists on the local system. The value must be an alphanumeric string (or blank).
cloud_account_id	Indicates the ID for the cloud account that contains the volume snapshots.
cloud_account_name	Indicates the cloud account name for the cloud account that contains the volume snapshot. The value must be an alphanumeric string.
last_backup_time	Indicates the timestamp of the most recent snapshot for this volume. The value must be in `YYMMDDHHMMSS` format or blank.
generation_count	Indicates the number of snapshot generations that exist for the specified volume. The value must be a number. Note: Any generations that are being copied to the cloud do not count towards this number. Any generations that are being deleted count towards this number until the delete process completes.
backup_size	Indicates the approximate amount of storage (the capacity) that is in use by snapshot generations for the specified volume

An invocation example

lsvolumebackup

The resulting output:

volume_UID                       volume_id volume_name volume_group_id volume_group_name cloud_account_id cloud_account_name last_backup_time generation_count backup_size
600507680CA880DF1800000000000002 2         vdisk2      2               logArchive        0                myAmazon           160218021355     20               100.23TB
600507680CA880DF1800000000000003 3         vdisk3                                        0                myAmazon           160218173210     5                22.01GB
600507680CA880DF1800000000000004 4         vdisk4                                        0                myAmazon                            0                0.00MB
600507680CA880DF1800000000000017                                                         0                myAmazon           160105083218     1                5.50GB