6.2.12.11 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: Returns output in a long, tabular form.

• --detail: Lists all attributes in a detailed form.

• --attributes: Lists the specific attributes to display.

• --filter: Used to specify conditions for filtering the list output.

• --sort: Used to sort the output using the specified attributes.

• --count: Specifies the maximum number of results to report.

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.

• 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-164 List Information for Volume Backups

The following example shows how to list detailed information about all volume backups.

@> lsvolumebackup --detail

Example 6-165 List Information for Specific Volume Backups

The following example shows how to list detailed information about two volume backups with specific IDs.

@> lsvolumebackup 2b1:fedd311081ee490481b7e19bdb691999 2b2:fedd311081ee490481b8f2acab692334 --detail

Example 6-166 List Information for Specific Volume Backups

The following example shows how to list information about volume backups with names starting with MYDATA_BACKUP.

@> lsvolumebackup --filter name=MYDATA_BACKUP*