Skip to main content

qos adaptive-policy-group modify

Contributors
Suggest changes

Modify an adaptive policy group

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

Description

The qos adaptive-policy-group modify command modifies an adaptive policy group.

Only user-created adaptive policy groups can be modified. Default adaptive policy groups are read-only and cannot be modified.

Parameters

-policy-group <text> - Name

Specifies the name of the adaptive policy group. Adaptive policy group names must be unique and are restricted to 127 alphanumeric characters including underscores "_" and hyphens "-". Adaptive policy group names must start with an alphanumeric character. Use the qos adaptive-policy-group rename command to change the adaptive policy group name.

[-expected-iops {<integer>[IOPS[/{GB|TB}]] (default: TB)}] - Expected IOPS

Specifies the minimum expected IOPS per TB or GB allocated based on the storage object allocated size. QoS minimum throughput setting is calculated from the expected-iops parameter. It is set only for the storage objects that reside on AFF platforms.

[-peak-iops {<integer>[IOPS[/{GB|TB}]] (default: TB)}] - Peak IOPS

Specifies the maximum possible IOPS per TB or GB allocated based on the storage object allocated size or the storage object used size.

[-absolute-min-iops <qos_tput>] - Absolute Minimum IOPS

Specifies the absolute minimum IOPS which is used as an override when the expected IOPS is less than this value. The default value is computed as follows:

if expected-iops >= 6144/TB, then absolute-min-iops = 1000IOPS; if expected-iops >= 2048/TB and expected-iops < 6144/TB, then absolute-min-iops = 500IOPS; if expected-iops >= 1/MB and expected-iops < 2048/TB, then absolute-min-iops = 75IOPS.

[-expected-iops-allocation {used-space|allocated-space}] - Expected IOPS Allocation

Specifies the expected IOPS allocation policy. The allocation policy is either allocated-space or used-space . When the expected-iops-allocation policy is set to allocated-space , the expected IOPS is calculated based on the size of the storage object. When the expected-iops-allocation policy is set to used-space , the expected IOPS is calculated based on the amount of data stored in the storage object taking into account storage efficiencies. The default value is allocated-space .

[-peak-iops-allocation {used-space|allocated-space}] - Peak IOPS Allocation

Specifies the peak IOPS allocation policy. The allocation policy is either allocated-space or used-space . When the peak-iops-allocation policy is set to allocated-space , the peak IOPS is calculated based on the size of the storage object. When the peak-iops-allocation policy is set to used-space , the peak IOPS is calculated based on the amount of data stored in the storage object taking into account storage efficiencies. The default value is used-space .

[-block-size {ANY|4K|8K|16K|32K|64K|128K}] - Block Size

Specifies the I/O block size for the QoS adaptive policy group. The default value is "ANY". When block-size of "ANY" is specified, then control is by IOPS. When block-size other than "ANY" is specified, then control is by IOPS and bytes per second(bps). bps is the product of IOPS and block-size.

Examples

The following example modifies the "p1" adaptive policy group with specified values.
cluster1::> qos adaptive-policy-group modify -policy-group p1
            -expected-iops 200IOPS/TB -peak-iops 2000IOPS/TB
            -absolute-min-iops 100IOPS