Skip to main content

storage aggregate object-store show-space

Contributors
Suggest changes
PDFs

Display space utilization of object stores attached to an aggregate

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

Description

The ` storage aggregate object-store show-space` command displays information about the amount of space used in the object store for each of the aggregates in FabricPool. The used space is displayed in both absolute size as well as a percentage of the FabricPool license limit.

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 <text>] - Aggregate Name

If this parameter is specified, the command displays space information only about object stores that are attached to the specified aggregates.

[-object-store-name <text>] - ONTAP Name for this Object Store Config

If this parameter is specified, the command displays space information only about object stores whose configuration name matches the specified names.

[-object-store-availability <object Store Availability>] - Availability of the Object Store

If this parameter is specified, the command displays space information about the object stores whose availability status matches the specified value. Supported values with this parameter are - available and unavailable.

[-object-store-unavailable-reason <text>] - Reason why Object Store is Unavailable

If this parameter is specified, the command displays information only about object stores whose unavailability reason matches the specified reason.

[-provider-type <providerType>] - Type of the Object Store Provider

If this parameter is specified, the command displays information only about object store configurations whose provider type matches the specified value.

[-license-used-percent <percent_no_limit>] - License Space Used Percent

If this parameter is specified, the command displays space information only about object stores whose space used by the associated aggregate as a percentage of the license limit matches the specified value. If the object store does not require a license, then this field is not set.

[-unreclaimed-space-threshold <percent>] - Threshold for Reclaiming Unreferenced Space (privilege: advanced)

If this parameter is specified, the command displays information only about object stores whose threshold for reclaiming unused space from objects in the object store matches the specified value.

[-tiering-fullness-threshold <percent>] - Aggregate Fullness Threshold Required for Tiering (privilege: advanced)

If this parameter is specified, the command displays information only about object stores whose performance tier fullness threshold for tiering matches the specified value.

[-mirror-type {primary|mirror}] - Object Store Mirror Type

If this parameter is specified, the command displays information about object stores with a mirror-type that matches the specified value.

[-is-mirror-degraded {true|false}] - This object store is in mirror degraded mode

If this parameter is specified, the command displays information only about mirror object stores which have the specified mirror degraded state.

[-force-tiering-on-metrocluster {true|false}] - Force Tiering with no Mirror in a MetroCluster Configuration

If this parameter is specified, the command displays information only about primary object stores for which force tiering is toggled on for aggregates in a MetroCluster configuration.

[-cluster <Cluster name>] - The name of the Cluster to which the bin belongs

If this parameter is specified, the command displays information only about object stores for which cluster matches the specified value.

[-migrate-threshold <percent>] - Minimum Aggregate Space Threshold (privilege: advanced)

If this parameter is specified, the command displays information only about object stores whose performance tier migrate threshold matches the specified value.

Examples

The following example displays space information about all object stores:

cluster1::>storage aggregate object-store show-space