lsvolumebackup

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

Read syntax diagramSkip visual syntax diagram lsvolumebackup

Parameters

-delim delimiter
(Optional) Specify a delimiter to separate data in the output.
-nohdr
(Optional) Suppress the headings in the output.
-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.
-filtervalue?
(Optional) Displays a list of valid filter attributes.

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