Skip to main content
Command reference

storage aggregate show-space

Suggest changes
PDFs

Display details of space utilization within an aggregate.

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

Description

The storage aggregate show-space command displays information about space utilization within aggregates and any attached external capacity tier. The command output breaks down space usage in the specified aggregate by feature. If no parameters are specified, the command displays this information about all aggregates. Note that used percentage for an external capacity tier will be non-zero only if a size limit was set for that aggregate's attached tier.

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.

| [-instance ] }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-aggregate-name <aggregate name>] - Aggregate

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

[-bin-num <integer>] - Bin Number

If this parameter is specified, the command displays information only about the aggregates whose bin number for the storage tier matches the specified value. Typically, bin 0 refers to the performance tier or active file system and bin numbers greater than 0 refer to the external capacity tiers attached to the aggregate.

[-tier-name <text>] - Tier Name For Show Command

If this parameter is specified, the command displays information only about the aggregates whose attached storage tier name matches the specified value.

[-aggregate <aggregate name>] - Aggregate Display Name

If this parameter is specified, the command displays information only about space used in the specified aggregate or aggregates.

[-aggregate-uuid <UUID>] - Uuid of the Aggregate

If this parameter is specified, the command displays information only about the aggregates whose UUID matches the specified value.

[-volume-footprints {<integer>[KB|MB|GB|TB|PB]}] - Volume Footprints

If this parameter is specified, the command displays information only about the aggregate or aggregates that have the specified amount of space in use by volume footprints. A volume's footprint is the overall amount of space that a volume occupies in the aggregate, including the volume metadata and data.

[-volume-footprints-percent <percent_no_limit>] - Volume Footprints Percent

If this parameter is specified, the command displays information only about the aggregate or aggregates whose volume footprints occupy the specified percentage of space.

[-snap-size-total {<integer>[KB|MB|GB|TB|PB]}] - Total Space for Snapshot Copies in Bytes

If this parameter is specified, the command displays information only about the aggregate or aggregates that have the specified amount of space in use by aggregate snapshots. This field includes the space that is reserved for snapshots and is not available to volumes or aggregate data and metadata. It is set to 0 by default.

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

If this parameter is specified, the command displays information only about the aggregate or aggregates that have the specified percentage of space in use by aggregate snapshots.

[-aggregate-metadata {<integer>[KB|MB|GB|TB|PB]}] - Aggregate Metadata

If this parameter is specified, the command displays information only about the aggregate or aggregates that have the specified amount of space in use by aggregate metadata.

[-aggregate-metadata-percent <percent_no_limit>] - Aggregate Metadata Percent

If this parameter is specified, the command displays information only about the aggregate or aggregates that have the specified percentage of space in use by aggregate metadata.

[-used-including-snapshot-reserve {<integer>[KB|MB|GB|TB|PB]}] - Total Used

If this parameter is specified, the command displays information only about the aggregate or aggregates that have the specified amount of space in use in the aggregate.

It is important to note that this parameter treats the entire snapshot reserve as used space since it is not available for volumes.

[-used-including-snapshot-reserve-percent <percent_no_limit>] - Total Used Percent

If this parameter is specified, the command displays information only about the aggregate or aggregates that have the specified percentage of space in use in the aggregate and its snapshot reserve.

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

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

[-snapshot-reserve-unusable {<integer>[KB|MB|GB|TB|PB]}] - Snapshot Reserve Unusable

If this parameter is specified, the command displays information only about the aggregate or aggregates that have the specified amount of space reserved but unusable in the volume.

snapshot reserve can be diminished under certain conditions to accommodate volume metadata. Creating space in the aggregate will make this space available.

[-snapshot-reserve-unusable-percent <percent_no_limit>] - Snapshot Reserve Unusable Percent

If this parameter is specified, the command displays information only about the aggregate or aggregates that have the specified percentage of space reserved but unusable.

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

If this parameter is specified, the command displays information only about the aggregate or aggregates that have the specified amount of physical space in use by the aggregate.

This differs from total-used space by the space that is guaranteed for future writes. The value includes blocks in use by snapshots.

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

If this parameter is specified, the command displays information only about the aggregate or aggregates that have the specified percentage of physical space in use in the aggregates.

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

If this parameter is specified, the command displays information only about the aggregates whose amount of inactive user data in the performance tier matches the specified value. The inactive user data can be tiered out to a capacity tier if the aggregate is a FabricPool.

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

If this parameter is specified, the command displays information only about the aggregates whose percentage of inactive user data in the performance tier matches the specified value.

[-cross-volume-dedupe-metadata {<integer>[KB|MB|GB|TB|PB]}] - Aggregate Dedupe Metadata

If this parameter is specified, the command displays information only about the aggregate or aggregates that have the specified amount of space in use by cross volume deduplication metadata.

[-cross-volume-dedupe-metadata-percent <percent_no_limit>] - Aggregate Dedupe Metadata Percent

If this parameter is specified, the command displays information only about the aggregate or aggregates that have the specified percentage of space in use by cross volume deduplication metadata.

[-cross-volume-dedupe-temp-metadata {<integer>[KB|MB|GB|TB|PB]}] - Aggregate Dedupe Temporary Metadata

If this parameter is specified, the command displays information only about the aggregate or aggregates that have the specified amount of space in use by cross volume deduplication temporary metadata.

[-cross-volume-dedupe-temp-metadata-percent <percent_no_limit>] - Aggregate Dedupe Temporary Metadata Percent

If this parameter is specified, the command displays information only about the aggregate or aggregates that have the specified percentage of space in use by cross volume deduplication temporary metadata.

[-total-provisioned-space {<integer>[KB|MB|GB|TB|PB]}] - Total Space Provisioned inside Aggregate

If this parameter is specified, the command displays information about the total provisioned space which is the summation of volume size of all the volumes inside the aggregate.

[-total-provisioned-space-percent <percent_no_limit>] - Percentage Space Provisioned inside Aggregate

If this parameter is specified, the command displays information about the percentage of total provisioned space, which is the summation of volume size of all the volumes inside the aggregate, against the aggregate's size.

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

If this parameter is specified, the command displays information only about the aggregates whose physical space use in the attached object store matches the specified value.

[-object-store-physical-used-percent <percent_no_limit>] - Object Store Physical Used Percentage

If this parameter is specified, the command displays information only about aggregates whose physical space in use in the attached object store as a percentage of the license limit matches the specified value.

[-object-store-referenced-capacity {<integer>[KB|MB|GB|TB|PB]}] - Total Object Store Logical Referenced Capacity

If this parameter is specified, the command displays information only about the aggregates whose logical reference capacity space in use in the attached object store matches the specified value.

[-object-store-referenced-capacity-percent <percent_no_limit>] - Object Store Logical Referenced Capacity Percentage

If this parameter is specified, the command displays information only about aggregates whose logical reference capacity space in use in the attached object store as a percentage of the license limit matches the specified value.

[-object-store-metadata {<integer>[KB|MB|GB|TB|PB]}] - (DEPRECATED)-Object Store Metadata

This parameter is deprecated in ONTAP 9.10.1 and later. If this parameter is specified, the command displays information only about the aggregates whose metadata space in use in the attached object store matches the specified value.

[-object-store-metadata-percent <percent_no_limit>] - (DEPRECATED)-Object Store Metadata Percent

This parameter is deprecated in ONTAP 9.10.1 and later. If this parameter is specified, the command displays information only about aggregates whose metadata space in use in the attached object store as a percentage of the license limit matches the specified value.

[-object-store-unreclaimed-space {<integer>[KB|MB|GB|TB|PB]}] - (DEPRECATED)-Total Unreclaimed Space

This parameter is deprecated in ONTAP 9.10.1 and later. If this parameter is specified, the command displays information only about the aggregates whose unreclaimed space in use in the attached object store matches the specified value.

[-object-store-unreclaimed-space-percent <percent_no_limit>] - (DEPRECATED)-Object Store Unreclaimed Space Percentage

This parameter is deprecated in ONTAP 9.10.1 and later. If this parameter is specified, the command displays information only about aggregates whose unreclaimed space in use in the attached object store as a percentage of the license limit matches the specified value.

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

If this parameter is specified, the command displays information only about the aggregates whose attached object store size limit matches the specified value.

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

If this parameter is specified, the command displays information only about the aggregates whose amount of space saved by storage efficiency matches the specified value.

[-object-store-sis-space-saved-percent <percent_no_limit>] - Object Store Space Saved by Storage Efficiency Percentage

If this parameter is specified, the command displays information only about the aggregates whose percentage of space saved by storage efficiency matches the specified value.

[-object-store-logical-used {<integer>[KB|MB|GB|TB|PB]}] - Total Object Store Logical Used Size

If this parameter is specified, the command displays information only about the aggregates whose logical space use in the attached object store matches the specified value.

[-object-store-logical-used-percent <percent_no_limit>] - Object Store Logical Used Percentage

If this parameter is specified, the command displays information only about aggregates whose logical space in use in the attached object store as a percentage of the license limit matches the specified value.

[-object-store-logical-unreferenced-capacity {<integer>[KB|MB|GB|TB|PB]}] - Object Store Logical Unreferenced Capacity

If this parameter is specified, the command displays information only about the aggregates whose logical unreferenced capacity in use in the attached object store matches the specified value.

[-object-store-logical-unreferenced-capacity-percent <percent_no_limit>] - Object Store Logical Unreferenced Percentage

This parameter is deprecated in ONTAP 9.10.1 and later. If this parameter is specified, the command displays information only about aggregates whose logical unreferenced capacity in use in the attached object store as a percentage of the license limit matches the specified value.

Examples

The following example displays information about all aggregates:

cluster1::> storage aggregate show-space
Aggregate : aggr0
Feature                                          Used      Used%
      --------------------------------           ----------     ------
      Volume Footprints                              7.21GB        90%
      Aggregate Metadata                              520KB         0%
      Snapshot Reserve                              408.4MB         5%
      Total Used                                     7.61GB        95%
Total Physical Used                            3.41GB        43%
Total Provisioned Space                        7.17GB        90%
Aggregate : aggr1
Feature                                          Used      Used%
      --------------------------------           ----------     ------
      Volume Footprints                             101.0MB         0%
      Aggregate Metadata                              300KB         0%
      Snapshot Reserve                                   0B         0%
      Total Used                                    101.3MB         0%
Total Physical Used                            8.92MB         0%
Total Provisioned Space                         100MB         0%

2 entries were displayed.

The following example displays information about all the aggregates in a system including the ones that have an object store attached to them.

cluster1::> storage aggregate show-space
Aggregate : aggr0
Feature                                          Used      Used%
      --------------------------------           ----------     ------
      Volume Footprints                             112.1GB        90%
      Aggregate Metadata                            30.21MB         0%
      Snapshot Reserve                               6.20GB         5%
      Total Used                                    118.3GB        95%
Total Physical Used                           19.21GB        15%
Total Provisioned Space                       111.5GB        90%
Aggregate : aggr1
      Performance Tier
      Feature                                          Used      Used%
      --------------------------------           ----------     ------
      Volume Footprints                             130.1GB        14%
      Aggregate Metadata                            11.74GB         1%
      Snapshot Reserve                              45.35GB         5%
      Total Used                                    139.1GB        15%
Total Physical Used                           32.96GB         4%
Total Provisioned Space                        6.77TB       765%
Aggregate : aggr1
      Object Store: my-store
      Feature                                          Used      Used%
      --------------------------------           ----------     ------
      Logical Used                                  32.39GB          -
      Logical Referenced Capacity                   32.18GB          -
      Logical Unreferenced Capacity                 208.3MB          -
      Space Saved by Storage Efficiency             29.65GB          -
Total Physical Used                            2.74GB          -