6.2.12.12 lsvolumebackup
List volume backups.
Purpose
The lsvolumebackup command displays information about Exascale volume backups.
Syntax
lsvolumebackup [ volume-backup-ID [ volume-backup-ID ]... ]
[ -l ] [ --detail ]
[ --attributes attribute[,attribute]... ]
[ --filter filter[,filter]... ]
[ --sort [-]attribute[,[-]attribute]... ]
[ --count value ]Command Options
The options for the lsvolumebackup command
are:
-
volume-backup-ID: Identifies an Exascale volume backup that you want to list information about. If not specified, the command displays information about all volume backups.
-
-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 volumebackupscommand. 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:ssyyyy-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 not named
TEST:--filter name!=TEST -
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 sort output by name in descending (reverse-alphabetical) order:
--sort -name
Examples
Example 6-167 List Information for Volume Backups
The following example shows how to list detailed information about all volume backups.
@> lsvolumebackup --detail
Example 6-168 List Information for Specific Volume Backups
The following example shows how to list detailed information about two volume backups with specific IDs.
@> lsvolumebackup vol0002_bkp0001_fedd311081ee490481b7e19bdb691999 vol0002_bkp0002_fedd311081ee490481b8f2acab692334 --detail
Example 6-169 List Information for Specific Volume Backups
The following example shows how to list information about volume backups with
names starting with my-volume-backup.
@> lsvolumebackup --filter name=my-volume-backup*
Parent topic: Block Store Management