Listing volumes

Use the vol_list command to list all volumes or a specific one.

vol_list [ vol=VolName | pool=PoolName | cg=cgName ] [ show_proxy=<yes|no> ] 
[ managed=<yes|no|all> ] [ domain=DomainName ]

Parameters

Name Type Description Mandatory Default
vol Object name Name of a specific volume to be listed. N All volumes.
pool Object name Name of a specific pool whose volumes are to be listed. N Volumes in all Pools.
cg Object name List all the volumes in this consistency group. N All Consistency Groups.
show_proxy Boolean Returns data on proxy volumes (volumes in proxy state) as well. N No
managed Boolean Filter only volumes that are or are not managed. N no.
domain Object name The domain name. N All Domains
This command lists volumes according to:
  • Volume name
  • Pool
  • Consistency group
If no parameter is indicated, the command lists all available volumes. In addition, the command indicates whether the volume is mirrored.
This command displays the following VAAI fields (available on the XML output format):
  • enable_VAAI
  • user_disabled_VAAI
This command displays the following snapshot format field (available on the XML output format):
  • snapshot_format
ID Name Default Position
name Name 1
size Size (GB) 2
size_MiB Size (MiB) N/A
master_name Master Name 3
cg_name Consistency Group 4
pool_name Pool 5
creator Creator 6
proxy Proxy N/A
capacity Capacity (blocks) N/A
modified Modified N/A
sg_name Snapshot Group Name N/A
delete_
priority
 Deletion Priority N/A
locked Locked N/A
serial Serial Number N/A
snapshot_time Snapshot Creation Time N/A
snapshot_time_
on_master
 Master Copy Creation Time N/A
snapshot_
internal_role
 Snapshot Internal Role N/A
snapshot_of Snapshot of N/A
sg_snapshot_of Snapshot of Snap Group N/A
wwn WWN N/A
mirrored Mirrored N/A
locked_by_pool Locked by Pool N/A
used_capacity Used Capacity (GB) 7
used_capacity_
MiB
 Used Capacity (MiB) N/A
capacity_used_
by_snapshots_
MiB
 Capacity Used by Snapshots (MiB) N/A
short_lived_io Short Live IO N/A
enable_VAAI VAAI enabled N/A
user_disabled_
VAAI
 VAAI disabled by user N/A
snapshot_
format
 Snapshot Format N/A
ssd_caching SSD Caching State N/A
use_ssd_
caching_
default
 Use SSD Caching Default State N/A
unmap_support Unmap Support N/A
managed Managed N/A
enable_unmap unmap enabled N/A
user_disabled_
unmap
 unmap disabled by user N/A
marked Marked N/A

Example: 

vol_list

Output: 


Name                Size (GB) Master Name Pool      Creator  Used Capacity (GB)
DBLog               3006                  MainPool  admin    0
Dev                 2010                  MainPool  admin    0
Marketing           1013                  MainPool  admin    0
Dev.snapshot_00001  2010      Dev         MainPool  admin
Dev.snapshot_00002  2010      Dev         MainPool  admin
Dev.snapshot_00003  2010      Dev         MainPool  admin

Access control

User Category Permission
Storage administrator Allowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Operations administrator Disallowed
Host side accelerator client Disallowed