storage aggregate show-space

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 Snapshot copies. This field includes the space that is reserved for Snapshot copies 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 Snapshot copies.
[-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 accomodate 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 Snapshot copies.

[-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.
[-object-store-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 whose physical space use in the attached object store matches the specified value.
[-object-store-physical-used-percent <percent_no_limit>] - 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 Referenced Capacity
If this parameter is specified, the command displays information only about the aggregates whose reference capacity space in use in the attached object store matches the specified value.
[-object-store-referenced-capacity-percent <percent_no_limit>] - Object Store Referenced Capacity Percentage
If this parameter is specified, the command displays information only about aggregates whose 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]}] - Object Store Metadata
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>] - Object Store Metadata Percent
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]}] - Total Unreclaimed Space
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>] - Object Store Unreclaimed Space Percentage
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.

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%