volume show

Contributors
Suggest changes
PDFs

Display a list of volumes

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The volume show command displays information about volumes. The command output depends on the parameter or parameters specified with the command. If no parameters are specified, the command displays the following information about all volumes:

  • Vserver name

  • Volume name

  • Aggregate name

  • State (online, offline, restricted, or mixed)

  • Type (RW for read-write or DP for data-protection)

  • Size

  • Available size

  • Percentage of space used

To display detailed information about a single volume, run the command with the -vserver and -volume parameters. The detailed view provides all of the information in the previous list and the following additional information:

  • Name ordinal

  • Volume data set ID

  • Volume master data set ID

  • Volume style (trad or flex)

  • FlexCache Endpoint Type (none or cache or origin)

  • Whether the volume is a Cluster volume or Node volume

  • Export policy name

  • User ID

  • Group ID

  • Security style (unix, ntfs, mixed or unified)

  • UNIX permissions

  • Junction path

  • Junction path source

  • Whether the junction path is active

  • Parent volume name

  • Vserver root volume

  • Comment

  • Filesystem size

  • Total user-visible size

  • Used size

  • Used percentage

  • Volume nearly full threshold percent

  • Volume full threshold percent

  • Autosize enabled

  • Maximum autosize

  • Minimum autosize

  • Autosize grow threshold percent

  • Autosize shrink threshold percent

  • Autosize mode

  • Total files

  • Files used

  • Expected available size

  • Over provisioned size

  • Snapshot reserve available size

  • Logical used size

  • Logical used percent

  • Logical available size

  • Active filesystem logical used size

  • Snapshot copy logical used size

  • Use logical space reporting

  • Use logical space enforcement

  • Maximum directory size

  • Space guarantee style

  • Whether a space guarantee is in effect

  • Space SLO type (none, thick or semi-thick)

  • Whether space SLO is in effect

  • Whether minimum readahead is enabled

  • Whether access time update is enabled

  • Whether Snapshot directory access is enabled

  • Percentage of space reserved for Snapshot Copies

  • Percentage of Snapshot copy space used

  • Snapshot policy name

  • Creation time

  • If the filesystem size is fixed

  • Overwrite reserve

  • Fractional reserve

  • Which space management strategy to try first

  • Language

  • Whether there’s one data volume per member aggregate

  • Concurrency level

  • Optimization policy

  • Whether the volume is a clone

  • Volume UUID

  • Whether failover is enabled

  • Failover state

  • (DEPRECATED)-Extent option

  • Read reallocation option

  • Consistency state

  • Whether volume is quiesced on disk

  • Whether volume is quiesced in memory

  • Whether volume contains shared or compressed data

  • Space saved by storage efficiency

  • Percentage of space saved by storage efficiency

  • Space saved by deduplication

  • Percentage of space saved by deduplication

  • Space shared by deduplication

  • Space saved by compression

  • Percentage of space saved by compression

  • Volume Size Used by Snapshot Copies

  • Caching policy

  • FlexGroup master data set ID

  • FlexGroup index

  • FlexGroup UUID

  • Maximum size of the FlexGroup constituent

  • Whether the volume has FlexGroup enabled

  • Whether a FlexGroup is Qtree enabled

  • Whether the volume is the destination of a move that is currently in cutover

  • List of the aggregates used by the FlexGroup

  • List of the nodes used by the FlexGroup

  • SnapLock Type

  • Is in pre-commit phase of Copy-Free Transition

  • Application that the volume belongs to

  • Application UUID

To display detailed information about all volumes, run the command with the -instance parameter.

You can specify additional parameters to display information that matches only those parameters. For example, to display information only about data-protection volumes, run the command with the -type DP parameter.

Parameters

{ [-fields <fieldname>,…​]

This specifies the fields that need to be displayed. The fields Vserver and policy are the default fields (see example).

| [-encryption ]

If this parameter is specified, the command displays the following information:

  • Vserver name

  • Volume name

  • Aggregate name

  • Volume state

  • Encryption state

| [-junction ]

If this parameter is specified, the command displays the following information:

  • Vserver name

  • Volume name

  • Whether the volume’s junction is active

  • Junction path

  • Junction path source (if the volume is a mirror)

| [-settings ]

If this parameter is specified, the command displays the following information:

  • Vserver name

  • Volume name

  • Whether minimum readahead is enabled on the volume

  • Whether the access time is updated on inodes when a file on the volume is read

  • Whether clients have access to .snapshot directories

  • Whether automatic Snapshot copies are enabled on the volume

| [-instance ] }

If this parameter is specified, the command displays information about all entries.

[-vserver <vserver name>] - Vserver Name

If this parameter and the -volume parameter are specified, the command displays detailed information about the specified volume. If this parameter is specified by itself, the command displays information about volumes on the specified Vserver.

[-volume <volume name>] - Volume Name

If this parameter and the -vserver parameter are specified, the command displays detailed information about the specified volume. If this parameter is specified by itself, the command displays information about all volumes matching the specified name.

[-aggregate <aggregate name>] - Aggregate Name

If this parameter is specified, the command displays information only about the volume or volumes that are located on the specified storage aggregate. This field is displayed as "-" for FlexGroups.

[-aggr-list <aggregate name>,…​] - List of Aggregates for FlexGroup Constituents

If this parameter is specified, the command displays information only about the FlexGroup or FlexGroups that are located on the specified list of storage aggregates. This parameter applies to FlexGroups only.

[-encryption-type {none|volume|aggregate}] - Encryption Type

If this parameter is specified, the command displays information about the type of encryption key used for encrypting the volume. The possible values are undefined , none , volume , and aggregate . The value none is used for non-encrypted volumes, the value volume is used for volumes encrypted with volume key and aggregate is used for volumes encrypted with aggregate key.

[-nodes {<nodename>|local}] - List of Nodes Hosting the Volume

If this parameter is specified, the command displays information only about the FlexGroup or FlexGroups that are located on the specified list of storage systems. This parameter applies to FlexGroups only.

[-size {<integer>[KB|MB|GB|TB|PB]}] - Volume Size

If this parameter is specified, the command displays information only about the volume or volumes that have the specified size. Size is the maximum amount of space a volume can consume from its associated aggregate(s), including user data, metadata, Snapshot copies, and Snapshot reserve. Note that for volumes without a -space-guarantee of volume , the ability to fill the volume to this maximum size depends on the space available in the associated aggregate or aggregates.

[-name-ordinal <text>] - Name Ordinal

If this parameter is specified, it denotes the ordinal assignment used in relation to this volume’s name. Ordinals are used to disambiguate volumes that have the same base name on the same controller. A value of "0" indicates that the base volume name is unique on the controller. A value greater than zero indicates that the volume’s base name is used by two or more volumes on the same controller, and that appending "(n)" to this volume’s name uniquely identifies it on this controller.

[-dsid <integer>] - Volume Data Set ID

If this parameter is specified, the command displays information only about the volume or volumes that match the specified data set ID. This field is displayed as "-" for FlexGroups.

[-msid <integer>] - Volume Master Data Set ID

If this parameter is specified, the command displays information only about the volume or volumes that match the specified master data set ID.

[-state {online|restricted|offline|force-online|force-offline|mixed}] - Volume State

If this parameter is specified, the command displays information only