Skip to main content

storage aggregate object-store modify

Contributors
Suggest changes
PDFs

Modify attributes 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 modify command is used to update one or more object store parameters.

Parameters

-aggregate <text> - Aggregate Name

This parameter identifies the aggregate to which the object store to be modified is attached.

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

This parameter identifies the configuration name of the object store to be modified.

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

This optional parameter specifies the usage threshold below which ONTAP reclaims unused space from objects in the object store. When ONTAP writes data to the object store, it packages multiple file system blocks into one object. Over time, blocks stored in an object can be freed, leaving part of the object unused. When the percentage of used blocks in an object falls below this threshold, a background task moves the blocks which are still used to a new object. Afterwards, ONTAP frees the original object to reclaim the unused space. Valid values are between 0% and 99%. The default value depends on the object store's provider type. It is 20% for AWS_S3 , 25% for Azure_Cloud , 40% for SGWS , 20% for IBM_COS , 20% for AliCloud , 20% for GoogleCloud and 40% for ONTAP_S3 . Consult the FabricPool best practices guidelines for more information.

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

This optional parameter specifies the percentage of space in the performance tier which must be used before data is tiered out to the capacity tier.

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

This parameter specifies the object store mirror type. Valid mirror types are primary or mirror .

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

This parameter specifies force tiering option enabled or not on primary object stores for aggregates in a MetroCluster configuration.

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

This optional parameter specifies the minimum percentage of performance tier free space that must exist in order for migration of data from the capacity tier to performance tier to be allowed.

Examples

The following example modifies the unreclaimed space threshold of an object store attached to an aggregate named aggr1:

cluster1::> storage aggregate object-store modify -aggregate aggr1 -object-store-name my-store -unreclaimed-space-threshold 20%