Skip to main content
A newer release of this product is available.

storage aggregate show

Contributors
Suggest changes
PDFs

Display a list of aggregates

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

Description

The storage aggregate show command displays information about aggregates. 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 aggregates:

  • Aggregate name

  • Size

  • Available size

  • Percentage used

  • State

  • Number of volumes

  • Node on which the aggregate is located

  • RAID status

To display detailed information about a single aggregate, use the -aggregate parameter.

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-checksum ]

If this parameter is specified, the command displays information about the checksum for all aggregates in the cluster:

  • Aggregate name

  • Checksum status (active, off, reverting, none, unknown, initializing, reinitializing, reinitialized, upgrading_phase1, upgrading_phase2)

  • Checksum style (none, advanced_zoned, block, mixed, WAFL, or unknown)

| [-disk ]

If this parameter is specified, the command displays disk names for all aggregates in the cluster:

  • Aggregate name

  • Number and names of disks in the aggregate

| [-raid-info ]

If this parameter is specified, the command displays information about RAID groups, RAID type, maximum RAID size, checksum state, checksum style and whether the RAID status is inconsistent.

| [-instance ] }

If this parameter is specified, the command displays detailed information about all aggregates in the cluster.

[-aggregate <aggregate name>] - Aggregate

If this parameter is specified, the command displays detailed information about the specified aggregate.

[-storage-type {hdd | hybrid | lun | ssd | vmdisk}] - Storage Type

If this parameter is specified, the command displays information only about the aggregates with the specified storage type. The possible values are hdd, hybrid, lun, ssd and vmdisk.

[-chksumstyle <aggrChecksumStyle>] - Checksum Style

If this parameter is specified, the command displays information only about the aggregates that use the specified checksum style.

[-diskcount <integer>] - Number Of Disks

If this parameter is specified, the command displays information only about the aggregates that have the specified number of disks.

[-m, -mirror <true>] - Is Mirrored

If this parameter is specified, the command displays information only about the aggregates that have the specified mirrored value.

[-d, -disklist <disk path name>,…​] - Disks for First Plex

If this parameter is specified, the command displays information only about the aggregates that have the specified disk or disks.

[-mirror-disklist <disk path name>,…​] - Disks for Mirrored Plex

If this parameter is specified, the command displays information only about the aggregates that have the specified disk or disks present in the mirrored plex.

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

If this parameter is specified, the command displays information only about the aggregates that are located on the specified node.

[-free-space-realloc {on|off}] - Free Space Reallocation

If this parameter is specified, the command displays whether free space reallocation is enabled on the specified aggregate.

[-ha-policy {sfo|cfo}] - HA Policy

This optionally specifies the high-availability policy to be used in the context of a root recovery procedure. Do not modify this setting unless directed to do so by a customer support representative.

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

If this parameter is specified, the command displays information only about the aggregates that have the specified space reserved for Snapshot copies.

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

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

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

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

[-hybrid-enabled {true|false}] - Hybrid Enabled

If this parameter is specified, the command displays information only about the aggregates that are eligible to contain both SSD and non-SSD RAID groups.

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

If this parameter is specified, the command displays information only about the aggregates that have the specified available size.

[-chksumenabled {true|false}] - Checksum Enabled

If this parameter is specified, the command displays information only about the aggregates that have the specified checksum setting.

[-chksumstatus <text>] - Checksum Status

If this parameter is specified, the command displays information only about the aggregates that have the specified checksum status. The possible values for checksum status include the following: active, off, reverting, none, unknown, initializing, reinitializing, reinitialized, upgrading_phase1, and upgrading_phase2.

[-cluster <text>] - Cluster

If this parameter is specified, the command displays information only about the aggregates that are owned by nodes in the specified cluster. By default, only local cluster aggregates are displayed.

[-cluster-id <UUID>] - Home Cluster ID

If this parameter is specified, the command displays information only about the aggregates that are owned by nodes in the cluster specified by the cluster UUID. By default, only local cluster aggregates are displayed.

[-dr-home-id <integer>] - DR Home ID

If this parameter is specified, the command displays information only about the aggregates whose Disaster Recovery home node has the specified system ID.

[-dr-home-name <text>] - DR Home Name

If this parameter is specified, the command displays information only about the aggregates whose Disaster Recovery home is the specified node.

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

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

[-has-mroot {true|false}] - Has Mroot Volume

If this parameter is specified, the command displays information about only the aggregates that contain their owning node's management root directory.

[-has-partner-mroot {true|false}] - Has Partner Node Mroot Volume

If this parameter is specified, the command displays information about only the aggregates that contain the management root directory of their owning node's failover partner.

[-home-id <integer>] - Home ID

If this parameter is specified, the command displays information only about the aggregates whose home node has the specified system ID.

[-home-name <text>] - Home Name

If this parameter is specified, the command displays information only about the aggregates whose home node is the specified node.

[-hybrid-cache-size-total {<integer>[KB|MB|GB|TB|PB]}] - Total Hybrid Cache Size

If this parameter is specified, the command displays information only about the aggregates that have the specified total cache size in a Flash Pool.

[-hybrid {true|false}] - Hybrid

If this parameter is specified, the command displays information only about the aggregates that currently contain both SSD and non-SSD RAID groups.

[-inconsistent {true|false}] - Inconsistent

If this parameter is specified, the command displays information only about the aggregates that have the specified consistency.

[-is-home {true|false}] - Is Aggregate Home

If this parameter is specified, the command displays information only about the aggregates whose home node and owner node have the same system ID.

[-s, -maxraidsize <integer>] - Max RAID Size

If this parameter is specified, the command displays information only about the aggregates that have the specified maximum number of disks for RAID groups.

Note For Flash Pools, this option controls the maximum size of the HDD RAID groups.
[-cache-raid-group-size <integer>] - Flash Pool SSD Tier Maximum RAID Group Size

If this parameter is specified, the command displays information about the maximum RAID group size for the SSD tier for Flash Pools.

Note This parameter is applicable only for Flash Pools.
[-owner-id <integer>] - Owner ID

If this parameter is specified, the command displays information only about the aggregates that are owned by the node with the specified system ID.

[-owner-name <text>] - Owner Name

If this parameter is specified, the command displays information only about the aggregates that are owned by the specified node.

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

If this parameter is specified, the command displays information only about the aggregates that have the specified used size, as a percentage.

[-plexes <text>,…​] - Plexes

If this parameter is specified, the command displays information only about the aggregates that have the specified plex or plexes.

[-raidgroups <text>,…​] - RAID Groups

If this parameter is specified, the command displays information only about the aggregates that have the specified RAID group or groups.

[-raidstatus <text>] - RAID Status

If this parameter is specified, the command displays information only about the aggregates that have the specified RAID status. The possible values for RAID status are normal, copying, ironing, degraded, mirror degraded, growing, initializing, invalid, needs check, partial, reconstruct, raid4, raid_ep, raid0, raid_dp, raid_tec, redirect, and wafl inconsistent. You can specify multiple values (for example, reconstruct and growing).

[-t, -raidtype {raid_tec|raid_dp|raid4|raid_ep}] - RAID Type

If this parameter is specified, the command displays information only about the aggregates that use the specified RAID type. The possible values are raid0 for RAID 0, raid4 for RAID4 of disks other than SSD-ZNS , raid_ep for RAID4 of SSD-ZNS disks with additional RAID4 protection inside each disk, raid_dp for RAID-DP, raid_tec for RAID-TEC, and mixed_raid_type for aggregates that include a mix of RAID types.

[-resyncsnaptime <integer>] - SyncMirror Resync Snapshot Frequency in Minutes

If this parameter is specified, the command displays information only about the aggregates whose SyncMirror Resynchronization Snapshot Frequency is the specified value.

[-root {true|false}] - Is Root

If this parameter is specified, the command displays information about only the root aggregates in the cluster.

[-sis-metadata-space-used {<integer>[KB|MB|GB|TB|PB]}] - Space Used by Metadata for Volume Efficiency

If this parameter is specified, the command displays information about only the aggregates with the specified space used by A-SIS metafiles for volume efficiency. This parameter is deprecated in Data ONTAP 8.2 and later. Use the volume-footprint-list-info API for details related to space usage by deduplication metadata

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

If this parameter is specified, the command displays information only about the aggregates that have the specified size. The size of the aggregate is reported as the size available for use by WAFL, excluding WAFL reserve and aggregate Snapshot reserve capacity. Use the storage aggregate show-space command to see the details of space utilization within an aggregate.

[-state <aggregate state>] - State

If this parameter is specified, the command displays information only about the aggregates that have the specified state.

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

If this parameter is specified, the command displays information only about the aggregates that have the specified used size.

[-uses-shared-disks {true|false}] - Uses Shared Disks

Selects the aggregates that match this parameter value. This parameter is used to list all the aggregates that use shared HDDs or shared SSDs.

[-uuid <text>] - UUID String (privilege: advanced)

If this parameter is specified, the command displays information only about the aggregate that has the specified UUID. This parameter is available only at the advanced privilege level and higher.

[-volcount <integer>] - Number Of Volumes

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

[-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 aggregates that are considered by the Auto Balance Aggregate feature.

[-autobalance-state <Auto Balance Aggregate state>] - State of the aggregate being balanced (privilege: advanced)

If this parameter is specified, the command displays information only about the aggregates that have the specified state.

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

If this parameter is specified, the command displays information only about the aggregates that have the specified physical used size. This differs from total-used space by the space that is guaranteed 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 aggregates that have the specified physical used percent.

[-autobalance-state-change-counter <integer>] - State Change Counter for Auto Balancer (privilege: advanced)

If this parameter is specified, the command displays information only about the aggregates that have the specified number of state change caused by the Auto Balance Aggregate feature.

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

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

[-is-nve-capable {true|false}] - Is NVE Capable

This parameter indicates whether or not the aggregate is capable of supporting NVE (NetApp volume encryption).

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

Selects the aggregates that are set with this parameter value. This parameter lists all the aggregates that are in the precommit phase of a Copy-Free Transition workflow.

[-is-transition-out-of-space {true|false}] - Is a 7-Mode transitioning aggregate that is not yet committed in clustered Data ONTAP and is currently out of space (privilege: advanced)

Selects the aggregates that match this parameter value. This parameter is used to list all the 7-mode transitioning aggregates that are not yet committed in clustered Data ONTAP, and are currently out of space.

[-autobalance-unbalanced-threshold-percent <integer>] - Threshold When Aggregate Is Considered Unbalanced (%) (privilege: advanced)

If this parameter is specified, the command displays information only about the aggregates that have the specified unbalanced threshold percentage.

[-autobalance-available-threshold-percent <integer>] - Threshold When Aggregate Is Considered Balanced (%) (privilege: advanced)

If this parameter is specified, the command displays information only about the aggregates that have the specified available threshold percentage.

[-resync-priority {high(fixed)|high|medium|low}] - Resynchronization Priority

This parameter indicates the relative priority that is used to decide whether a mirrored aggregate can start a resynchronization operation or not. This field is not set for unmirrored aggregates.

Use the storage aggregate resynchronization modify command to modify this field for mirrored aggregates.

The valid values for this field are:

  • high(fixed): This value is reserved for Data ONTAP system aggregates, which cannot have any other value for this field. It cannot be explicitly set on a data aggregate. These aggregates always start their resynchronization operation at the first available opportunity.

  • high: Mirrored data aggregates with this priority value start resynchronization first.

  • medium: Mirrored data aggregates with this priority value start resynchronization after all the system aggregates and data aggregates with 'high' priority value have started resynchronization.

  • low: Mirrored data aggregates with this priority value start resynchronization only after all the other aggregates have started resynchronization.

[-data-compaction-space-saved {<integer>[KB|MB|GB|TB|PB]}] - Space Saved by Data Compaction

This parameter indicates the amount of the space saved by Data Compaction in bytes.

[-data-compaction-space-saved-percent <percent>] - Percentage Saved by Data Compaction

This parameter indicates the percentage of space saved in the aggregate by Data Compaction.

[-data-compacted-count {<integer>[KB|MB|GB|TB|PB]}] - Amount of compacted data

This parameter indicates the number of bytes occupied by compacted data inside this aggregate.

[-creation-timestamp <MM/DD/YYYY HH:MM:SS>] - Timestamp of Aggregate Creation

This parameter indicates the date and time the aggregate was created.

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

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

[-composite {true|false}] - Composite

If this parameter is specified, the command displays information only about aggregates whose classification as a FabricPool matches the specified value. A FabricPool has an external capacity tier attached to it.

[-is-fabricpool-mirrored {true|false}] - Is FabricPool Mirrored

If this parameter is specified, the command displays information only about FabricPools whose classification as mirrored matches the specified value. A mirrored FabricPool has a second external capacity tier attached to it.

[-composite-capacity-tier-used {<integer>[KB|MB|GB|TB|PB]}] - Capacity Tier Used Size

If this parameter is specified, the command displays the amount of space in use in the attached external capacity tier.

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

This parameter indicates the total amount of space saved by storage efficiency in bytes.

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

This parameter indicates the percentage of space saved by storage efficiency.

[-sis-shared-count {<integer>[KB|MB|GB|TB|PB]}] - Amount of Shared bytes count by Storage Efficiency

This parameter indicates the number of bytes shared by storage efficiency.

[-is-inactive-data-reporting-enabled {true|false}] - Inactive Data Reporting Enabled

If this parameter is specified, the command displays whether reporting of inactive user data is enabled. This parameter is not allowed on FabricPools

[-inactive-data-reporting-start-timestamp <MM/DD/YYYY HH:MM:SS>] - Timestamp when Inactive Data Reporting was Enabled

If this parameter is specified, the command displays the timestamp at which inactive data reporting was enabled on the aggregate. This parameter is not allowed on FabricPools.

[-encrypt-with-aggr-key {true|false}] - Enable Aggregate level Encryption

Selects the aggregates that are encrypted with aggregate keys.

[-drive-protection-enabled {true|false}] - Aggregate uses data protected SEDs

If this parameter is specified, the command displays whether this aggregate is entirely composed of self-encrypting drives that have data protection enabled.

[-azcs-read-optimization {on|off}] - azcs read optimization

If this parameter is specified, the command displays whether azcs-with-compression feature is enabled.

[-space-required-for-revert {<integer>[KB|MB|GB|TB|PB]}] - Metadata Reserve Space Required For Revert (privilege: advanced)

If this parameter is specified, the command displays the additional amount of free space needed for metadata reserve in the aggregate if the system is required to revert to an ONTAP release earlier than 9.11.1x.

Examples

The following example displays information about all aggregates that are owned by nodes in the local cluster:

cluster1::> storage aggregate show
Aggregate     Size Available Used% State    #Vols Nodes            RAID Status
--------- -------- --------- ----- ------- ------ ---------------  ------------
aggr0       6.21TB    1.78TB   71% online      49 cluster1-01      raid_dp,
                                                                   normal
aggr1      56.04MB   55.89MB    0% online       0 cluster1-02      raid_dp,
                                                                   mirrored,
                                                                   normal
aggr2       1.77TB    1.63TB    8% online       1 cluster1-01      raid_dp,
                                                                   normal
aggr3       1.77TB    1.73TB    2% online       2 cluster1-02      raid_dp,
                                                                   normal
4 entries were displayed.

The following example displays information about an aggregate name aggr1:

cluster1::> storage aggregate show -aggregate aggr1
                                            Aggregate: aggr1
                                       Checksum Style: block
                                      Number Of Disks: 6
                                               Mirror: true
                                                Nodes: cluster1-02
                                 Disks for First Plex: 1.1.2,
                                                       1.1.10,
                                                       1.1.11
                              Disks for Mirrored Plex: 1.1.6,
                                                       1.1.8,
                                                       1.1.9
                              Free Space Reallocation: off
                                            HA Policy: sfo
                   Space Reserved for Snapshot Copies: 5%
                                       Hybrid Enabled: false
                                       Available Size: 53.10MB
                                           Block Type: 64-bit
                                     Checksum Enabled: true
                                      Checksum Status: active
                                              Cluster: cluster1
                                      Home Cluster ID: 686964a0-2172-11e3-837d-123478563412
                                           DR Home ID: -
                                         DR Home Name: -
                                     Has Mroot Volume: false
                        Has Partner Node Mroot Volume: false
                                              Home ID: 4050409551
                                            Home Name: cluster1-02
                              Total Hybrid Cache Size: 0B
                                               Hybrid: false
                                         Inconsistent: false
                                    Is Aggregate Home: true
                                        Max RAID Size: 16
    Hybrid Aggregate SSD Tier Maximum RAID Group Size: -
                                             Owner ID: 4050409551
                                           Owner Name: cluster1-02
                                      Used Percentage: 0%
                                               Plexes: /aggr1/plex0, /aggr1/plex1
                                          RAID Groups: /aggr1/plex0/rg0 (block)
                                                       /aggr1/plex1/rg0 (block)
                                          RAID Status: raid_dp, mirrored, normal
                                            RAID Type: raid_dp
      SyncMirror Resync Snapshot Frequency in Minutes: 60
                                              Is Root: false
         Space Used By metadata for Volume Efficiency: 0B
                                                 Size: 53.24MB
                       SnapLock Type of the Aggregate: -
                                                State: online
                                            Used Size: 144KB
                                    Number Of Volumes: 0
                                Is Flash Pool Caching: -
               Is Eligible for Auto Balance Aggregate: false
                State of the aggregate being balanced: ineligible
               State Change Counter for Auto Balancer: 0
                                         Is Encrypted: true
                                    Encryption Key ID: 40004FE3000000000303000000000000436F5DB53445FD603FB5A8A64937AA7B
      Is in the precommit phase of Copy-Free Transition: false
Is a 7-Mode transitioning aggregate that is not yet committed in clustered Data ONTAP and is currently out of space: false
Threshold When Aggregate Is Considered Unbalanced (%): 70
  Threshold When Aggregate Is Considered Balanced (%): 40
         Resynchronization Priority: -
      Space Saved by Data Compaction: 99.24MB
            Percentage Saved by Data Compaction: 7%
           Amount of compacted data: 99.24MB
          Timestamp of Aggregate Creation: 1/3/2017 23:38:06
            Enable SIDL: off
              Composite: false
            Capacity Tier Used Size: 0B
        Space Saved by Storage Efficiency: 99.24MB
      Percentage of Space Saved by Storage Efficiency: 7%
   Amount of Shared bytes count by Storage Efficiency: 99.24MB

The following example displays information about aggregates that are owned by nodes in cluster1:

cluster1::> storage aggregate show -cluster cluster1

cluster1:
Aggregate     Size Available Used% State   #Vols  Nodes            RAID Status
--------- -------- --------- ----- ------- ------ ---------------- ------------
aggr0       6.04GB    3.13GB   48% online       2 cluster1-01      raid_dp,
                                                                   mirrored,
                                                                   normal
aggr1      53.24MB   12.59MB   76% online       2 cluster1-02      raid_dp,
                                                                   mirrored,
                                                                   normal
2 entries were displayed.

The following example displays information about aggregates that are owned by nodes in the remote cluster named cluster2:

cluster1::> storage aggregate show -cluster cluster2

cluster2:
Aggregate     Size Available Used% State   #Vols  Nodes            RAID Status
--------- -------- --------- ----- ------- ------ ---------------- ------------
aggr2            -         -     - remote_cluster
                                                - -                -
aggr3            -         -     - remote_cluster
                                                - -                -
2 entries were displayed.

The following example displays information about aggregates that are owned by nodes in all the clusters:

cluster1::> storage aggregate show -cluster *

cluster2:
Aggregate     Size Available Used% State   #Vols  Nodes            RAID Status
--------- -------- --------- ----- ------- ------ ---------------- ------------
aggr2            -         -     - remote_cluster
                                                - -                -
aggr3            -         -     - remote_cluster
                                                - -                -

cluster1:
Aggregate     Size Available Used% State   #Vols  Nodes            RAID Status
--------- -------- --------- ----- ------- ------ ---------------- ------------
aggr0       6.04GB    3.14GB   48% online       2 cluster1-01      raid_dp,
                                                                   mirrored,
                                                                   normal
aggr1      53.24MB   12.59MB   76% online       2 cluster1-02      raid_dp,
                                                                   mirrored,
                                                                   normal
4 entries were displayed.