lsvolumegroupsnapshot

Use the lsvolumegroupsnapshot command to list a view snapshot objects in the system.

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 the snapshots that are in the deleting state.
-volumegroup volume_group_id_or_name: (Optional) Specifies the ID or name of the volume group.
-parentuid id: (Optional) Specifies the UID identifying the parent volume group.
-snapshot snapshot_name | snapshot_policy_uuid: (Optional) Specifies the snapshot name .

Description

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

Table 1. lsvolumegroupsnapshot output
Attribute	Description
id	Indicates the ID of the volume group snapshot.
name	Indicates the name of the volume group snapshot
volume_group_id	Indicates the ID of the parent volume group. Blank if the group no longer exists.
volume_group_name	Indicates the name of the parent volume group. Blank if the group no longer exists.
time	Indicates the time at which the snapshot was triggered. Blank if the group no longer exists. The valid time stamp format is YYMMDDHHMMSS.
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 dependent_deleting: It is used to populate a thin-clone or clone then it will go into the dependent_deleting state
matches_group	Indicates whether the snapshot is associated with all the volume in the group. It will show no if the snapshot was created from a list of volumes rather than a group. Valid values can be `yes` or `no`.
parent_uid	Indicates the UID identifying the parent volume group.
protection_provisioned_capacity	Indicates the amount of capacity provisioned to store all the volume snapshots in the volume group snapshot.
protection_written_capacity	Indicates the amount of capacity written to store all the volume snapshots in the volume group snapshot before any data reduction.
operation_start_time	Indicates the time when the last delete was started. It will be blank if the state is Active or blank. The valid time stamp format is YYMMDDHHMMSS.
operation_completion_estimate	Indicates the estimated time to complete the operation. The valid time stamp format is YYMMDDHHMMSS.
owner_id	Indicates the ID of the ownership group.
owner_name	Indicates the name of the ownership group.
expiration_time	Indicates the expiration time. The valid time stamp format is YYMMDDHHMMSS or blank.
auto_snapshot	Indicates the snapshot triggered by the snapshot scheduler. Value can be `yes` or `no`.
safeguarded	Indicates if snapshot is Safeguarded. Values can be `yes` or `no`.
last_restored_from	Indicates the time that the volume group snapshot was last used to restore a volume group. The timestamp is in the format YYMMDDHHMMSS. It will be blank if the volume group snapshot has never been used for a restore.
ha_state	Indicates whether the snapshot exists only on this system, or is replicated for high availability.
partition_id	Indicates the ID of the partition associated with the snapshot.
partition_name	Indicates the name of the partition associated with the snapshot
anomaly_sequence_number	Indicates the error sequence number associated with an anomaly in the volume group at the time the snapshot was triggered.
anomaly_status	Indicates if a ransomware threat detection event is present and the snapshot is potentially contaminated.

Note: The expiration_time field value is assigned at the time 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. If an anomaly is detected, the last snapshot that expires within 7 days gets by default extended to expire in 7 days from that discovery.

When using the partition IP address to run this command, consider the following:

The user must identify objects using the name or UUID. Short IDs cannot be specified when using the partition IP address.
Views will be filtered to display only objects related to the partition associated with the IP address. An error will be displayed if the user requests a detailed view for an object that is not related to the partition.