volume list

Sergei Tikhomirov

Definition

Lists information about all volumes.

Usage

$ ozone sh volume list [-hV] [-p=<prefix>]
                             [-s=<startItem>]
                             [-u=<userName>]
                             [[-l=<limit>] | [-a]]
                             <value>
NOTE
In this command, list can be shortened to just ls.
Arguments
Parameter Description

prefix

A name prefix to filter the items

startItem

The item to start listing from. The chosen item will not appear in the results

userName

A user, whose volumes should be displayed

limit

Maximum number of the results to list. The default value is 100

-a, --all

If specified, the command will display all the results. By default, it is specified. To counter it, use the -l parameter

value

A URI. It can be a full URI (starts with o3://, e.g. o3://hostname:9862/) or a short URI (empty in this case). Any missing information is obtained from the configuration files

Examples

Consider there’s a volume vol1. To display information about it, call the command:

$ ozone sh volume list

The output depends on the volume configuration, but overall should be similar to the following:

[ {
  "metadata" : { },
  "name" : "vol1",
  "admin" : "s_tikhomirov_krb1",
  "owner" : "s_tikhomirov_krb1",
  "quotaInBytes" : -1,
  "quotaInNamespace" : -1,
  "usedNamespace" : 5,
  "creationTime" : "2025-01-22T21:23:28.796Z",
  "modificationTime" : "2025-02-12T23:08:16.179Z",
  "acls" : [ {
    "type" : "USER",
    "name" : "s_tikhomirov_krb1",
    "aclScope" : "ACCESS",
    "aclList" : [ "ALL" ]
  }, {
    "type" : "USER",
    "name" : "sergei",
    "aclScope" : "ACCESS",
    "aclList" : [ "READ", "WRITE", "CREATE", "LIST", "DELETE", "READ_ACL", "WRITE_ACL", "ALL" ]
  } ],
  "refCount" : 0
} ]
Found a mistake? Seleсt text and press Ctrl+Enter to report it