6.2.6.2 lsvault

List vaults.

Purpose

The lsvault command displays information about Exascale vaults.

Syntax

lsvault [ [@]name [ [@]name ]... ] [ -l ] [ --detail ] 
   [ --attributes attribute[,attribute]... ] 
   [ --filter filter[,filter]... ] 
   [ --sort [-]attribute[,[-]attribute]... ] 
   [ --sum attribute ] [ --count value ] [ -t ]
lsvault [@]vault --provision

Command Options

The options for the lsvault command are:

  • name: A vault name that you want to display information for.

    In this context, the asterisk (*) can be used for wildcard searches.

    If no vault name is specified, then information is displayed about all vaults in the current level of the ESCLI hierarchy.

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

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

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

    You can use this option to focus on a subset of attributes as an alternative to the --detail option.

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

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

  • --sum: Calculates the sum of the specified numeric attribute.

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

  • -t: Sorts vaults by ascending creation time.

  • --provision: Displays information about storage pool resources provisioned to the specified vault.

    This option is available starting with Oracle Exadata System Software release 26.1.0, and may not be used in conjunction with any other options.

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 otherAttribute in ascending order to further sort entries with the same name: 

    --sort -name,otherAttribute

  • You can use the --sum option only by itself or together with the --filter option.

    The --sum option is available starting with Oracle Exadata System Software release 26.1.0.

Examples

Example 6-67 Display All Vaults

You can use the lsvault command at the root level to get a listing of all vaults. 

@> lsvault
my-data
vault2

Example 6-68 Display Vault Information in a Long Format

When you use the -l option, the output includes additional information about each vault. 

@> lsvault -l
createTime                spaceUsedEF spaceUsedHC name
2024-11-24T01:41:41+00:00     0.0000     10.0000G my-data
2024-11-25T05:47:11+00:00     0.0000    100.0000M vault2

Example 6-69 Display Vault Provisioning Information

Use the --provision option to show vault provisioning information for multiple storage pools. 

@> lsvault @my-data --provision

id          spaceProv  spaceUsed  iopsProv   flashCacheProv  xrmemCacheProv  mediaType  flashLogProv  xrmemLogProv 
my-pool1    1.0000T    10.0000G   32000      unlimited       10.0000G        HC         enabled       disabled
my-pool2    unlimited  0.0000     unlimited  unlimited       unlimited       HC         enabled       disabled

Parent topic: Vault Management