lsvolumebackupgeneration

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

Syntax

Read syntax diagramSkip visual syntax diagram lsvolumebackupgeneration -volumevolume_namevolume_id-uidvolume_UID

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.
-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 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).
auto_backup Indicates whether the cloud backup is triggered manually or automatically through a policy schedule.
backup_expiry_time Indicates expiry time of the backup generation. The value must be in YYMMDDHHMMSS format.
volume_group_name Indicates 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.