lsvolumesnapshot

Use the lsvolumesnapshot command to display a list of all volume snapshots.

Syntax

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.

snapshot_id: (Optional) Specifies the ID of the snapshot.

-showhidden: (Optional) Specifies that snapshots that are in the process of deleting are displayed. This parameter also displays additional attributes of the volume that contains snapshots such as pool_1_id, pool_2_id, pool_1_name, pool_2_name, snapshot_mapping_id, snapshot_mapping_name, snapshot_vdisk_id, and snapshot_vdisk_name. You must include the -showhidden parameter to display these attributes.

Description

The snapshot ID can be specified to show the specific volume snapshot objects for the specific ID.

Filter value can be used to restrict the objects that are returned to a specific volume group. To view these object, use the -filtervalue parameter.

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

Table 1. lsvolumesnapshot output
Attribute	Description
snapshot_id	Indicates the ID of the volume snapshot.
snapshot_name	Indicates the name of the volume snapshot.
volume_id	Indicates the ID of the parent volume.
volume_name	Indicates the name of the parent volume.
volume_group_id	Indicates the ID of the volume group that is associated with the snapshot. Blank if the group no longer exists.
volume_group_name	Indicates the name of the volume group that is associated with the snapshot. Blank if the group no longer exists.
time	Indicates the snapshot trigger time. The valid timestamp format is YYMMDDHHMMSS.
parent_uid	Indicates the unique ID of the parent volumes.
state	Indicates the state of the snapshot. Values can be: Ready: If the snapshot is not triggered. Active: Maintain the snapshot image. Deleting: Process of deleting. Failed.
expiration_time	Indicates the expiration time of the snapshot. The valid timestamp format is YYMMDDHHMMSS.
safeguarded	Indicates if snapshot is Safeguarded. Values can be `yes` or `no`.
mirrored	Indicates whether the snapshot is mirrored. Values can be `yes` or `no`.
pool_1_id	Indicates the ID of the pool for copy 1.
pool_1_name	Indicates the name of the pool for copy 1.
pool_2_id	Indicates the ID of the pool for copy 2.
pool_2_name	Indicates the name of the pool for copy 2.
snapshot_mapping_id	Indicates the ID of the FlashCopy mapping that is used to maintain the snapshot.
snapshot_mapping_name	Indicates the name of the FlashCopy mapping that is used to maintain the snapshot.
snapshot_vdisk_id	Indicates the ID of the volume that is used to maintain the snapshot.
snapshot_vdisk_name	Indicates the name of the volume that is used to maintain the snapshot.
volume_size_mismatch	Indicates whether the provisioned capacity of the parent volume and the volume snapshot are different. Values are yes or no. Note: A size mismatch will prevent the volume snapshot being used in a restore operation.
written_capacity	Indicates the amount of data to be written.

Note: The expiration_time field value is assigned at the time that a volume snapshot is created based on the source volume being part of a volume group with a snapshot policy. This expiration_time remains unchanged until the volume snapshot is removed manually or automatically unless the system clock changes including during a power-off situation. In that case, the expiration times of volume snapshots are adjusted to accommodate the difference. In the scenario of a power-off, the expiration times can be extended up to the length of the power-off.