Skip to main content

storage aggregate show-space

Contributors
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 across all the volumes in the aggr.

[-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 across all the volumes against aggr'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                       5.75GB        91%
      Aggregate Metadata                       380KB         0%
      Snapshot Reserve                       325.3MB         5%
Total Used                              6.07GB        96%
Total Physical Used                    221.9MB         3%
Aggregate : aggr1
Feature                                   Used      Used%
      --------------------------------    ----------     ------
      Volume Footprints                       2.03GB        33%
      Aggregate Metadata                       304KB         0%
Total Used                              2.03GB        33%
Total Physical Used                     2.23MB         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.

cluster-1::> storage aggregate show-space
Aggregate : aggr0
Feature                                   Used      Used%
      --------------------------------    ----------     ------
      Volume Footprints                       2.87GB        90%
      Aggregate Metadata                       328KB         0%
      Snapshot Reserve                       162.6MB         5%
      Total Used                              3.03GB        95%
Total Physical Used                     2.08GB        65%
Aggregate : aggr1
      Performance Tier
      Feature                                   Used      Used%
      --------------------------------    ----------     ------
      Volume Footprints                       1.25GB        13%
      Aggregate Metadata                       540KB         0%
      Snapshot Reserve                            0B         0%
      Total Used                              1.25GB        13%
Total Physical Used                     1.23GB        13%
Aggregate : aggr1
      Object Store: my-store
      Feature                                   Used      Used%
      --------------------------------    ----------     ------
      Referenced Capacity                    811.2MB         0%
      Metadata                                    0B         0%
      Unreclaimed Space                           0B         0%
      Space Saved by Storage Efficiency           0B         0%
Total Physical Used                    811.2MB         0%