6.2.12.10 lsvolume

List volumes.

Purpose

The lsvolume command displays information about Exascale volumes.

Syntax

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

Command Options

The options for the lsvolume command are:

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

• -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 volumes 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 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-162 List Information for a Specific Volume

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

@> lsvolume vol0002_50e52177583f4be4bad68ac20b65001e --detail

Example 6-163 List Specific Volume Attributes

The following example shows how to list specific volume attributes for volume ID: vol0002_50e52177583f4be4bad68ac20b65001e.

@> lsvolume vol0002_50e52177583f4be4bad68ac20b65001e --attributes id,size,iopsProvisioned

Example 6-164 List Volumes Matching a Filter

The following example shows how to list detailed volume information for volumes that are sized greater than 100 MB. The output is also sorted by volume size.

@> lsvolume --detail --filter size>100M --sort size