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
Parent topic: Block Store Management