6.2.12.14 lsvolumesnapshot

List volume snapshots.

Purpose

The lsvolumesnapshot command displays information about Exascale volume snapshots.

Syntax

lsvolumesnapshot [ volume-snap-ID [ volume-snap-ID ]... ] [ -l ] [ --detail ] 
                 [ --attributes attribute[,attribute]... ] 
                 [ --filter filter[,filter]... ] 
                 [ --sort [-]attribute[,[-]attribute]... ] 
                 [ --count value ]

Command Options

The options for the lsvolumesnapshot command are:

  • volume-snap-ID: Identifies an Exascale volume snapshot that you want to list information about. If not specified, the command displays information about all volume snapshots.

  • -l: Displays output in a long, tabular format.

  • --detail: Displays detailed output with additional attributes.

  • --attributes: Identifies specific attributes to display in the output.

    To see a list of all available attributes and their descriptions, use the describe volumesnapshots command. See also Describing Resources and Attributes.

  • --filter: Specifies conditions for including items in the output.

  • --sort: Sorts the output using the specified attributes.

  • --count: Specifies the maximum number of items to display in the output.

Usage Notes

Note the following information when using this command:

  • Filter conditions are specified as: <attribute><operator><value>.

    The allowed operators are =, !=, >=, <=, >, and <.

    Multiple comma-separated filter conditions are combined using AND logic.

    Dates can be specified using the following formats:

    • yyyy-MM-dd''T''HH:mm:ss
    • yyyy-MM-dd (Time is assumed to be 00:00 AM)
    • HH:mm:ss (Date is assumed to be today)

    A date can also be followed by a timezone specification.

    Sizes can be specified using suffixes K, KB, M, MB, G, GB, T, TB. The suffix is not case-sensitive.

    For example, the following filter only includes objects created after 9 AM today:

    --filter createTime>9:00:00
  • Sorting attributes are specified as: [-]attribute. Multiple sort attributes are comma-delimited. The default sort order is ascending. For descending sort order, prefix the attribute name with -.

    For example, use the following to primarily sort by name in descending order, and use creation time in ascending order to further sort entries with the same name:

    --sort -name,createTime

Examples

Example 6-169 List Information for Volume Snapshots

The following example shows how to list detailed information about all of the volume snapshots.

@> lsvolumesnapshot --detail

Example 6-170 List Information for a Specific Volume Snapshot

The following example shows how to list detailed information for volume snapshot ID: vol0002_snap0001_50e52177583f4be4bad68ac20b65001e.

@> lsvolumesnapshot vol0002_snap0001_50e52177583f4be4bad68ac20b65001e

Example 6-171 List Specific Attributes for Volume Snapshots

The following example shows how to list specific attributes of all the volume snapshots.

@> lsvolumesnapshot --attributes id,volume,size