lbcli List Volumes

Returns the list of volumes in the Lightbits cluster and their state. You can add --output-format=json or --output-format=yaml to get a different format of the information. Note that json/yaml format will give more detailed information on each volume.

When running with system_jwt you will get all the volumes in the cluster. If you run with a tenant JWT, you will get only the volumes of the specific tenant.

Sample Command

The cluster admin API will get all the volumes in the cluster (across all of the projects).

$ lbcli list volumes

This is a similar command, but with the JWT not stored in the lbcli configuration file. This will list the volumes of project1:

lbcli --jwt $P1ADMIN list volumes --project-name project1

Sample Output (Default)

Name    UUID         State   Protection State   NSID Size     Replicas Compression ACL

vol_0   bea851365040 Created FullyProtected     1    100 GiB  2        false         

vol_1   92023adb23ae Created FullyProtected     2    100 GiB  2        false         

vol_3   65c3bd571c87 Created FullyProtected     4    100 GiB  2        false         

vol_2   8cc8bb076932 Created FullyProtected     3    100 GiB  2        false

Sample Output - JSON format (of One Volume for the Example)

ETag: "4"   

IPAcl:

  values:

  - ALLOW_ANY 

UUID: 105624dd-c96f-4668-a2a2-da0b754ac462

acl:

  values:

  - acl1

compression: true

connectedHosts: [] 

name: vol2

nodeList:

- 2d6f9739-afd7-5225-b4a0-b7c46dc54ffd

- 01ab0ff8-6417-5b89-ba1a-b3011936745f

- 291e00d3-73d0-546f-ae45-e26a1cfa534b

nsid: 2

protectionState: FullyProtected

rebuildProgress: None

replicaCount: 3

size: "1099511627776"

state: Available

statistics:

  compressionRatio: 0

  logicalUsedStorage: "0"

  physicalUsedStorage: "0"

This output details all of the parameters used to create the volume - such as the ACL, replication factor (replica count), and compression state. In addition, the UUID of each Lightbits node used to create the volume on the Lightbits cluster is provided under the output’s nodeList area.