volume show

Description​

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 ] (privilege: advanced)

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 (privilege: advanced)

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 about the volume or volumes that have the specified state. The mixed state only applies to FlexGroups. If the state of a FlexGroup is mixed, that indicates that not all of the constituents are in the same state. If this is the case use the "volume show -is-constituent true" command to find out which constituents are not in the proper state.

[-volume-style <flex>] - Volume Style

If this parameter is specified, the command displays information only about the volumes that have the specified style. Possible values are flex for FlexVol volumes.

[-volume-style-extended {flexvol|flexgroup|flexgroup-constituent}] - Extended Volume Style

If this parameter is specified, the command displays information only about the volumes that are configured with the specified extended style. Possible values are flexvol for FlexVol volumes, flexgroup for FlexGroups and flexgroup-constituent for FlexGroup constituents.

[-flexcache-endpoint-type {none|cache|origin}] - FlexCache Endpoint Type

If this parameter is specified, the command displays information only about the volumes that are of the specified flexcache-endpoint-type. Possible values are none for volumes that are not part of a FlexCache relationship, cache for FlexCache volumes and origin for origin of FlexCache volumes.

[-is-cluster-volume {true|false}] - Is Cluster-Mode Volume

If this parameter is specified, the command displays information only about cluster volumes (true) or node root volumes and other node scoped volumes (false).

[-is-constituent {true|false}] - Is Constituent Volume

If this parameter is specified, the command displays information only about volumes that either are or are not constituents of a FlexGroup, depending on the value provided.

[-policy <text>] - Export Policy

If this parameter is specified, the command displays information only about the volume or volumes that use the specified export policy.

[-user <user name>] - User ID

If this parameter is specified, the command displays information only about the volume or volumes whose root is owned by the specified user.

[-group <group name>] - Group ID

If this parameter is specified, the command displays information only about the volume or volumes whose root is owned by the specified group.

[-security-style <security style>] - Security Style

If this parameter is specified, the command displays information only about the volume or volumes that have the specified security style (unix for UNIX mode bits, ntfs for CIFS ACLs, mixed for both styles or unified for Unified UNIX, NFS and CIFS permissions).

[-unix-permissions <unix perm>] - UNIX Permissions

If this parameter is specified, the command displays information only about the volume or volumes whose default UNIX permissions match the specified permissions. Specify UNIX permissions either as a four-digit octal value (for example, 0700) or in the style of the UNIX ls command (for example, -rwxr-x---). For information on UNIX permissions, see the UNIX or Linux documentation.

[-junction-path <junction path>] - Junction Path

If this parameter is specified, the command displays information only about the volume or volumes that have the specified junction path.

[-junction-path-source {RW_volume|LS_mirror}] - Junction Path Source

If this parameter is specified, the command displays information only about the volume or volumes that have the specified junction path source.

[-junction-active {true|false}] - Junction Active

If this parameter is specified, the command displays information only about the volume or volumes whose junction paths have the specified status.

[-junction-parent <volume name>] - Junction Parent Volume

If this parameter is specified, the command displays information only about the volume or volumes that have the specified parent volume.

[-vsroot {true|false}] - Vserver Root Volume (privilege: advanced)

If this parameter is specified, the command displays information only about the volume or volumes that match the specified setting; that is, whether they are the root volumes for their Vservers.

[-comment <text>] - Comment

If this parameter is specified, the command displays information only about the volume or volumes that match the specified comment text.

[-available {<integer>[KB|MB|GB|TB|PB]}] - Available Size

If this parameter is specified, the command displays information only about the volume or volumes that have the specified available size. Available is the amount of free space currently available to be used by this volume. For a volume with a -space-guarantee of type volume, available is always -total minus -used. For volumes that do not have a -space-guarantee of type volume, available could be reduced if the volume’s associated aggregate or aggregates are space constrained.

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

If this parameter is specified, the command displays information only about the volume or volumes that have the specified filesystem size. Filesystem size is the same as the volume’s -size unless the volume is or was a physical replica destination. In this case, the file system size corresponds to the -size of the source volume, until -filesys-size-fixed is set to false.

[-total {<integer>[KB|MB|GB|TB|PB]}] - Total User-Visible Size

If this parameter is specified, the command displays information only about the volume or volumes that have the specified total size. Total is the total space available for user data and file system metadata. It does not include the Snapshot reserve.

[-used {<integer>[KB|MB|GB|TB|PB]}] - Used Size

If this parameter is specified, the command displays information only about the volume or volumes that have the specified used size. Used is the amount of space occupied by user data and file system metadata. It includes Snapshot spill (the amount of space by which Snapshot copies exceed Snapshot reserve). It does not include the Snapshot reserve.

[-percent-used <percent>] - Used Percentage

If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of used space. This row is based on a value of used space that includes the space used by Snapshot copies or the Snapshot reserve (whichever is greater) in relation to the current volume size.

[-space-nearly-full-threshold-percent <percent>] - Volume Nearly Full Threshold Percent

If this parameter is specified, the command displays information only about the volume or volumes that have the specified nearly full threshold percent.

[-space-full-threshold-percent <percent>] - Volume Full Threshold Percent

If this parameter is specified, the command displays information only about the volume or volumes that have the specified full threshold percent.

[-max-autosize {<integer>[KB|MB|GB|TB|PB]}] - Maximum Autosize

If this parameter is specified, the command displays information only about the volume or volumes that have the specified maximum automatic size.

[-min-autosize {<integer>[KB|MB|GB|TB|PB]}] - Minimum Autosize

If this parameter is specified, the command displays information only about the volume or volumes that have the specified minimum automatic size. This field is displayed as "-" for FlexGroups.

[-autosize-grow-threshold-percent <percent>] - Autosize Grow Threshold Percentage

If this parameter is specified, the command displays information only about the volume or volumes that have the specified automatic grow used space threshold percentage. This field is displayed as "-" for FlexGroups.

[-autosize-shrink-threshold-percent <percent>] - Autosize Shrink Threshold Percentage

If this parameter is specified, the command displays information only about the volume or volumes that have the specified automatic shrink used space threshold percentage. This field is displayed as "-" for FlexGroups.

[-autosize-mode {off|grow|grow_shrink}] - Autosize Mode

If this parameter is specified, the command displays information only about the volume or volumes that have the specified automatic sizing mode setting. This field is displayed as "-" for FlexGroups.

[-files <integer>] - Total Files (for user-visible data)

If this parameter is specified, the command displays information only about the volume or volumes that have the specified number of files.

[-files-used <integer>] - Files Used (for user-visible data)

If this parameter is specified, the command displays information only about the volume or volumes that have the specifies number of files used.

[-maxdir-size {<integer>[KB|MB|GB|TB|PB]}] - Maximum Directory Size (privilege: advanced)

If this parameter is specified, the command displays information only about the volume or volumes that have the specified maximum directory size.

[-space-guarantee-enabled {true|false}] - Space Guarantee in Effect

If this parameter is specified, the command displays information only about the volume or volumes that have the specified space-guarantee setting. If the value of -space-guarantee is none, the value of -space-guarantee-enabled is always true. In other words, because there is no guarantee, the guarantee is always in effect. If the value of -space-guarantee is volume, the value of -space-guarantee-enabled can be true or false, depending on whether the guaranteed amount of space was available when the volume was mounted.

[-is-space-slo-enabled {true|false}] - Space SLO in Effect

If this parameter is specified, the command displays information only about the volume or volumes that have their space-slo setting in effect or not, depending on the value specified for this parameter. If the value of space-slo is none, the space SLO is always considered to be in effect. If the value of space-slo is semi-thick or thick, the space SLO may be in effect depending on whether the required amount of space was available when the volume was mounted.

[-space-slo {none|thick|semi-thick}] - Space SLO

If this parameter is specified, the command displays information only about the volume or volumes that have the specified space-slo setting. The space SLO setting is the Service Level Objective for space management for the volume.

[-space-guarantee | -s {none|volume}] - Space Guarantee Style

If this parameter is specified, the command displays information only about the volume or volumes that have the specified space guarantee style. If the value of -space-guarantee is none, the value of -space-guarantee-enabled is always true. In other words, because there is no guarantee, the guarantee is always in effect. If the value of -space-guarantee is volume, the value of -space-guarantee-enabled can be true or false, depending on whether the guaranteed amount of space was available when the volume was mounted.

[-fractional-reserve <percent>] - Fractional Reserve

If this parameter is specified, the command displays information only about the volume or volumes that have the specified fractional-reserve setting.

[-type {RW|DP}] - Volume Type

If this parameter is specified, the command displays information only about the volume or volumes of the specified volume type (RW for read-write or DP for data-protection).

[-min-readahead {true|false}] - Minimum Read Ahead (privilege: advanced)

If this parameter is specified, the command displays information only about the volume or volumes that have the specified minimum-readahead setting.

[-atime-update {true|false}] - Access Time Update Enabled (privilege: advanced)

If this parameter is specified, the command displays information only about the volume or volumes that have the specified access-time update setting.

[-snapdir-access {true|false}] - Snapshot Directory Access Enabled

If this parameter is specified, the command displays information only about the volume or volumes that have the specified Snapshot-copy access setting.

[-percent-snapshot-space <percent>] - Space Reserved for Snapshot Copies

If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space reserved for Snapshot copies.

[-snapshot-space-used <percent_no_limit>] - Snapshot Reserve Used

If this parameter is specified, the command displays information only about the volume or volumes that have the specified used percentage of the reserve for Snapshot copies.

[-snapshot-policy <snapshot policy>] - Snapshot Policy

If this parameter is specified, the command displays information only about the volume or volumes that use the specified Snapshot policy.

[-create-time <Date>] - Creation Time

If this parameter is specified, the command displays information only about the volume or volumes that have the specified creation time.

[-language <Language code>] - Language

If this parameter is specified, the command displays information only about the volume or volumes that store data in the specified language. To determine the available languages, enter volume show-language?at the clustershell command prompt.

[-clone-volume {true|false}] - Clone Volume

If this parameter is specified, the command displays information only about volumes that are clones (true) or not clones (false).

[-node {<nodename>|local}] - Node name

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

[-clone-parent-vserver <vserver name>] - Clone Parent Vserver Name

If this parameter is specified, the command displays information only about the volumes with a matching FlexClone parent Vserver name.

[-clone-parent-name <volume name>] - FlexClone Parent Volume

If this parameter is specified, the command displays information only about the volumes with a matching FlexClone parent volume name.

[-uuid <UUID>] - UUID of the Volume (privilege: advanced)

If this parameter is specified, the command displays information only about the volume or volumes that match the specified UUID.

[-nvfail {on|off}] - NVFAIL Option

If this parameter is specified, the command displays information only about volumes for which failover is enabled (on) or disabled (off).

[-in-nvfailed-state {true|false}] - Volume's NVFAIL State

If this parameter is specified, the command displays information only about volumes which are in the failed over state (true) or not (false).

[-dr-force-nvfail {on|off}] - Force NVFAIL on MetroCluster Switchover

If this parameter is specified, the command displays information only about volumes for which dr-force-nvfail is enabled (on) or disabled (off).

[-filesys-size-fixed {true|false}] - Is File System Size Fixed

If this parameter is specified, the command displays information only about the volume or volumes that have the specified filesys-size-fixed setting.

[-extent-enabled {off|on|space-optimized}] - (DEPRECATED)-Extent Option

Note

This parameter has been deprecated and may be removed in a future release of Data ONTAP.

If this parameter is specified, the command displays information only about volumes that have extents enabled (on), not enabled (off) or space optimized (space-optimized).

[-overwrite-reserve {<integer>[KB|MB|GB|TB|PB]}] - Reserved Space for Overwrites

If this parameter is specified, the command displays information only about the volume or volumes that have the specified overwrite-reserve setting.

[-space-mgmt-try-first {volume_grow|snap_delete}] - Primary Space Management Strategy

If this parameter is specified, the command displays information only about the volume or volumes that have the specified space-mgmt-try-first setting. Possible values are volume_grow and snap_delete. This field is displayed as "-" for FlexGroups.

[-read-realloc {off|on|space-optimized}] - Read Reallocation Option

If this parameter is specified, the command displays information only about volumes that have read reallocation enabled (on), not enabled (off) or space optimized (space-optimized).

[-sched-snap-name {create-time|ordinal}] - Naming Scheme for Automatic Snapshot Copies

If this parameter is specified, the command displays information only about the volume or volumes that have the specified automatic Snapshot-copy naming convention.

[-is-inconsistent {true|false}] - Inconsistency in the File System

If this parameter is specified, the command displays information only about volumes that are inconsistent (true) or consistent (false) in the file system.

[-is-quiesced-on-disk {true|false}] - Is Volume Quiesced (On-Disk)

If this parameter is specified, the command displays information only about volumes that are quiesced (true) or not quiesced (false) on disk.

[-is-quiesced-in-memory {true|false}] - Is Volume Quiesced (In-Memory)

If this parameter is specified, the command displays information only about volumes that are quiesced (true) or not quiesced (false) in memory.

[-transition-state <state>] - Transition Operation State (privilege: advanced)

If this parameter is specified, the command displays information only about the volume or volumes that match the specified transition state.

[-transition-behavior {data-move|data-protection|none}] - Transition Behavior (privilege: advanced)

If this parameter is specified, the command displays information only about the volume or volumes that match the specified transition behavior. Possible values are:

• data-move: Volumes that are being moved from a system operating in 7-Mode.
• data-protection: Volumes that are being replicated from a system operating in 7-Mode for disaster recovery.
• none: Volumes that are not part of transition.

[-is-copied-for-transition {true|false}] - Copied for Transition (privilege: advanced)

If this parameter is specified, the command displays information only about the volume or volumes that match the specified value based on whether the volume is copied for transition or not.

[-is-transitioned {true|false}] - Transitioned (privilege: advanced)

If this parameter is specified, the command displays information only about the volume or volumes that match the specified value based on whether the volume is transitioned or not.

[-is-sis-volume {true|false}] - Volume Contains Shared or Compressed Data

If this parameter is specified, the command displays information only about those volumes that match the specified storage efficiency setting.

[-sis-space-saved {<integer>[KB|MB|GB|TB|PB]}] - Space Saved by Storage Efficiency

If this parameter is specified, the command displays information only about those volumes that have the specified amount of space saved by the storage efficiency technology.

[-sis-space-saved-percent <percent>] - Percentage Saved by Storage Efficiency

If this parameter is specified, the command displays information only about those volumes that have the specified percentage of space saved by the storage efficiency technology.

[-dedupe-space-saved {<integer>[KB|MB|GB|TB|PB]}] - Space Saved by Deduplication

If this parameter is specified, the command displays information only about those volumes that have the specified amount of space saved due to deduplication.

[-dedupe-space-saved-percent <percent>] - Percentage Saved by Deduplication

If this parameter is specified, the command displays information only about those volumes that have the specified percentage of space saved due to deduplication.

[-dedupe-space-shared {<integer>[KB|MB|GB|TB|PB]}] - Space Shared by Deduplication

If this parameter is specified, the command displays information only about those volumes that have the specified amount of shared space due to deduplication.

[-compression-space-saved {<integer>[KB|MB|GB|TB|PB]}] - Space Saved by Compression

If this parameter is specified, the command displays information only about those volumes that have the specified amount of space saved due to compression.

[-compression-space-saved-percent <percent>] - Percentage Space Saved by Compression

If this parameter is specified, the command displays information only about those volumes that have the specified percentage of space saved due to compression.

[-size-used-by-snapshots {<integer>[KB|MB|GB|TB|PB]}] - Volume Size Used by Snapshot Copies

If this parameter is specified, the command displays information about those volumes that have the specified volume size used by Snapshot copies.

[-block-type {64-bit|extent|32-bit}] - Block Type

If this parameter is specified, the command displays information about only the volumes with the specified indirect block format. Possible values are 32-bit to display 32-bit volumes and 64-bit to display 64-bit volumes.

[-is-moving {true|false}] - Is Volume Moving

If this parameter is specified, the command displays information only about volumes that are moving (true) or not moving (false).

[-hybrid-cache-eligibility {read|read-write|none}] - Flash Pool Caching Eligibility

If this parameter is specified, the command displays information only about the volume or volumes with the specified Flash Pool caching attributes. Possible caching attributes are:

• 'read' ... Indicates that the volume cannot participate in write caching.
• 'read-write' ... Indicates that the volume can participate in read and write caching.

[-hybrid-cache-write-caching-ineligibility-reason <text>] - Flash Pool Write Caching Ineligibility Reason

If this parameter is specified, the command displays information only about the volume or volumes which are ineligible to participate in write caching due to the specified reason.

[-constituent-role <Constituent Roles>] - Constituent Volume Role

If this parameter is specified, the command displays information only about the constituent volume or volumes that are of the specified role. This parameter applies to FlexGroups only.

[-is-cft-precommit {true|false}] - Is in the precommit phase of Copy-Free Transition (privilege: advanced)

If this parameter is specified with the true value, it displays information only about the volumes that are in the precommit phase of a Copy-Free Transition workflow.

[-qos-policy-group <text>] - QoS Policy Group Name

If this parameter is specified, the command displays information only about volumes that match the specified QoS policy group.

[-qos-adaptive-policy-group <text>] - QoS Adaptive Policy Group Name

If this parameter is specified, the command displays information only about volumes that match the specified QoS adaptive policy group.

[-caching-policy <text>] - Caching Policy Name

If this parameter is specified, the command displays the volumes that match the specified caching policy.

A caching policy defines how the system caches a volume's data in a Flash Pool aggregate. Both metada and user data are eligible for caching. The available caching policies are:

• none - Does not cache any user data or metadata blocks.
• auto - Read caches all metadata and randomly read user data blocks, and write caches all randomly overwritten user data blocks.
• meta - Read caches only metadata blocks.
• random_read - Read caches all metadata and randomly read user data blocks.
• random_read_write - Read caches all metadata, randomly read and randomly written user data blocks.
• all_read - Read caches all metadata, randomly read and sequentially read user data blocks.
• all_read_random_write - Read caches all metadata, randomly read, sequentially read, and randomly written user data.
• all - Read caches all data blocks read and written. It does not do any write caching.
• noread-random_write - Write caches all randomly overwritten user data blocks. It does not do any read caching.
• meta-random_write - Read caches all metadata and write caches randomly overwritten user data blocks.
• random_read_write-random_write - Read caches all metadata, randomly read and randomly written user data blocks. It also write caches randomly overwritten user data blocks.
• all_read-random_write - Read caches all metadata, randomly read and sequentially read user data blocks. It also write caches randomly overwritten user data blocks.
• all_read_random_write-random_write - Read caches all metadata, randomly read, sequentially read, and randomly written user data. It also write caches randomly overwritten user data blocks.
• all-random_write - Read caches all data blocks read and written. It also write caches randomly overwritten user data blocks.

Note that in a caching-policy name, a hyphen (-) separates read and write policies. Default caching-policy is auto.

[-cache-retention-priority {normal|low|high}] - Cache Retention Priority (privilege: advanced)

If this parameter is specified, the command displays the volumes that match the specified cache retention priority policy.

A cache retention priority defines how long the blocks of a volume will be cached in flash pool once they become cold.The available cache retention priority are:

• low - Cache the cold blocks for the lowest time.
• normal - Cache the cold blocks for the default time.
• high - Cache the cold blocks for the highest time.

[-is-volume-in-cutover {true|false}] - Is Volume Move in Cutover Phase

If this parameter is specified, the command displays information only about volumes that are in the cutover phase (true) or not in the cutover phase (false) of a volume move. This field is displayed as "-" for FlexGroups.

[-snapshot-count <integer>] - Number of Snapshot Copies in the Volume

If this parameter is specified, the command displays information only about the volumes that have the specified number of Snapshot copies.

[-vbn-bad-present {true|false}] - VBN_BAD may be present in the active filesystem

If this parameter is specified, the command displays information only about volumes that may have VBN_BAD present in its active filesystem (true) or do not have VBN_BAD present in its active filesystem (false).

[-is-autobalance-eligible {true|false}] - Is Eligible for Auto Balance Aggregate (privilege: advanced)

If this parameter is specified, the command displays information only about the volume or volumes that are eligible for consideration by the Auto Balance Aggregate feature.

[-is-vol-on-hybrid-aggr {true|false}] - Is Volume on a hybrid aggregate

If this parameter is specified, the command displays information only about volumes associated with a Flash Pool aggregate (true) or not (false). This field is displayed as "-" for FlexGroups.

[-physical-used {<integer>[KB|MB|GB|TB|PB]}] - Total Physical Used Size

If this parameter is specified, the command displays information only about the volume or volumes that have the specified physical used size. This differs from total-used space by the space that is reserved for future writes. The value includes blocks in use by Snapshot copies.

[-physical-used-percent <percent_no_limit>] - Physical Used Percentage

If this parameter is specified, the command displays information only about the volume or volumes that have the specified physical used percent based on volume size including the space reserved for Snapshot copies.

[-flexgroup-msid <integer>] - FlexGroup Master Data Set ID (privilege: advanced)

If this parameter is specified, the command displays information only about the FlexGroup or FlexGroup constituents that have the specified FlexGroup master data-set ID. This parameter applies to FlexGroups and FlexGroup constituents only.

[-flexgroup-index <integer>] - FlexGroup Index (privilege: advanced)

If this parameter is specified, the command displays information only about the FlexGroup constituents that have the specified FlexGroup index. This parameter applies to FlexGroup constituents only.

[-flexgroup-uuid <UUID>] - UUID of the FlexGroup (privilege: advanced)

If this parameter is specified, the command displays information only about the FlexGroup or FlexGroup constituents that have the specified FlexGroup UUID. This parameter applies to FlexGroups and FlexGroup constituents only.

[-max-constituent-size {<integer>[KB|MB|GB|TB|PB]}] - Maximum size of a FlexGroup Constituent (privilege: advanced)

If this parameter is specified, the command displays information only about the FlexGroup or FlexGroups that have the specified maximum constituent size. This parameter applies to FlexGroups only.

[-inofile-version <integer>] - Inofile Version (privilege: advanced)

If this parameter is specified, the command displays information only about the volumes whose inode files are at the specified version.

[-is-flexgroup {true|false}] - Is Volume a FlexGroup

If this parameter is specified, the command displays information only about the volume or volumes that are either FlexGroups or not, depending on the value provided.

[-is-qtree-caching-enabled {true|false}] - Is Qtree Caching Support Enabled (privilege: advanced)

If this parameter is specified, the command displays information only about the FlexGroups and origins of FlexCache volumes with Qtree caching enabled or disabled, depending on the value provided.

[-is-move-destination-in-cutover {true|false}] - Is the Volume a Target of a Move Which Is Currently in Cutover (privilege: advanced)

If this parameter is specified, the command displays wheter or not the volume is a move destination that is currently in cutover.

[-snaplock-type {non-snaplock|compliance|enterprise}] - SnapLock Type

If this parameter is specified, the command displays information only about volumes that match the specified snaplock-type.

[-vserver-dr-protection {protected|unprotected}] - Vserver DR Protection

If this parameter is specified, the command displays information only about the volumes having the specified Vserver Snapmirror protection.

[-has-optimized-sparse-directories {true|false}] - Volume Has Sparse Directories in an Optimized Format (privilege: advanced)

If this parameter is specified, the command displays information only about volumes that have sparse directories in an optimized format.

[-encrypt [true]] - Enable Encryption

If this parameter is specified, the command displays information only about the volumes that are encrypted.

[-is-encrypted {true|false}] - Is Volume Encrypted

If this parameter is specified, the command displays information only about the volumes that are encrypted (true) or not encrypted (false).

[-encryption-state {none|full|partial|converting_to_encrypted|converting_to_plaintext|rekeying}] - Volume Encryption State

If this parameter is specified, the command displays information only about the volumes that have the specified encryption state. The possible values are none, full, and partial. The value partial is used for FlexGroups, which indicates that some constituents are encrypted and some are not.If this parameter is specified, the command displays the encryption state of the volume.

[-key-id <text>] - Encryption Key ID

If this parameter is specified, the command displays information only about the volume whose encryption key-id matches the specified key-id.

[-application <text>] - Application

Selects the volumes that are part of an application that matches the parameter value.

[-is-protocol-access-fenced {true|false}] - Is Fenced for Protocol Access

If this parameter is specified, the command displays information only about the volumes that are fenced for protocol access. Only FlexGroup constituents and volumes in SnapMirror Synchronous relationships can be fenced for protocol access.

[-protocol-access-fenced-by {none|coordinated_snaprestore|coordinated_redirection|snapmirror_synchronous_strict_sync}] - Protocol Access Fence Owner

This field indicates the owner of the protocol access fence when the volume's protocol access is fenced. Only FlexGroup constituents and volumes in SnapMirror Synchronous relationships can be fenced for protocol access.

[-single-instance-data-logging {off|on}] - Is SIDL enabled

If this parameter is specified, the command displays whether Single Instance Data Logging feature is enabled on the specified volume.

[-over-provisioned {<integer>[KB|MB|GB|TB|PB]}] - Over Provisioned Size

If this parameter is specified, the command displays information only about the volume or volumes that have the specified size not available in the aggregate. This applies only for a 'none' guaranteed volume when it's unused size exceeds available space in the aggregate. This value is always zero for 'volume' guaranteed volumes.

[-snapshot-reserve-available {<integer>[KB|MB|GB|TB|PB]}] - Available Snapshot Reserve Size

If this parameter is specified, the command displays information only about the volume or volumes that have the specified size available for Snapshot copies within the Snapshot reserve. This value is zero if Snapshot spill is present. For 'none' guaranteed volumes, this may get reduced due to less available space in the aggregate.

[-logical-used {<integer>[KB|MB|GB|TB|PB]}] - Logical Used Size

If this parameter is specified, the command displays information only about the volume or volumes that have the specified logical used size. This value includes all the space saved by the storage efficiency features along with the physically used space. This does not include Snapshot reserve but does consider Snapshot spill.

[-logical-used-percent <percent_no_limit>] - Logical Used Percentage

If this parameter is specified, the command displays information only about the volume or volumes that have the specified logical used percentage.

[-logical-available {<integer>[KB|MB|GB|TB|PB]}] - Logical Available Size

If this parameter is specified, the command displays information only about the volume or volumes that have the specified logical available size. This value is the amount of free space currently available considering space saved by the storage efficiency features as being used. This does not include Snapshot reserve.

[-logical-used-by-afs {<integer>[KB|MB|GB|TB|PB]}] - Logical Size Used by Active Filesystem

If this parameter is specified, the command displays information only about the volume or volumes that have the specified logical size used by the active file system. This value differs from logical-used by the amount of Snapshot spill that exceeds Snapshot reserve. This parameter is not supported on FlexGroups.

[-logical-used-by-snapshots {<integer>[KB|MB|GB|TB|PB]}] - Logical Size Used by All Snapshots

If this parameter is specified, the command displays information only about the volume or volumes that have the specified logical size used across all Snapshot copies. This value differs from size-used-by-snapshots by the space saved by the storage efficiency features across the Snapshot copies. This parameter is not supported on FlexGroups.

[-is-space-reporting-logical {true|false}] - Logical Space Reporting

If this parameter is specified, the command displays information only about the volumes that have logical space reporting enabled or disabled as specified. When space is reported logically, ONTAP reports the volume space such that all the physical space saved by the storage efficiency features are also as reported as used. This parameter is not supported on FlexGroups.

[-is-space-enforcement-logical {true|false}] - Logical Space Enforcement

If this parameter is specified, the command displays information only about the volumes that have logical space enforcement enabled or disabled as specified. When space is enforced logically, ONTAP enforces volume settings such that all the physical space saved by the storage efficiency features will be calculated as used. This parameter is not supported on FlexGroups.

[-tiering-policy {snapshot-only|auto|none|all}] - Volume Tiering Policy

If this parameter is specified, the command displays information only about the volumes whose tiering policy matches the specified value. Tiering policies determine whether the user data blocks of a volume in a FabricPool will be tiered to the cloud tier when they become cold. FabricPool combines Flash (performance tier) with an object store (cloud tier) into a single aggregate. The temperature of a volume block increases if it is accessed frequently and decreases when it is not.

The available tiering policies are:

• snapshot-only - Only the volume Snapshot copies not associated with the active file system are tiered to the cloud tier.
• auto - Both Snapshot copy data and active file system user data are tiered to the cloud tier.
• none - No volume blocks are tiered to the cloud tier.
• all - Both Snapshot copy data and active file system user data are tiered to the cloud tier as soon as possible without waiting for a cooling period. On DP volumes all transferred user data blocks start in the cloud tier.

[-tiering-minimum-cooling-days <integer>] - Volume Tiering Minimum Cooling Days (privilege: advanced)

This parameter displays the minimum number of days that user data blocks of the volume must be cooled before they can be considered cold and tiered out to the cloud tier. If a value is not displayed, then the system default is still being used and has not been overridden with this option. The default minimum cooling period for the snapshot-only policy is 2 days and for the auto policy is 31 days.

[-performance-tier-inactive-user-data {<integer>[KB|MB|GB|TB|PB]}] - Performance Tier Inactive User Data

If this parameter is specified, the command displays the amount of inactive user data stored in the performance tier that could be tiered out to a cloud tier if the volume is in a FabricPool and for which the auto tiering policy has been specified. For more information see the tiering-policy parameter.

[-performance-tier-inactive-user-data-percent <percent>] - Performance Tier Inactive User Data Percent

If this parameter is specified, the command displays the percentage of inactive user data in the performance tier.