Articles in this section

qospolicy modify

Sara Levy
  • Updated
Follow

This command modifies a QoS policy.

Usage

qospolicy modify --id ID
                [--mode STATIC|USED_CAPACITY|PROVISIONED_CAPACITY]
                [--limit-by BW|IOPS|BW_IOPS]
                [--static-limits STATIC_LIMITS]
                [--capacity-limits CAPACITY_LIMITS]
 

Required Parameters

--id ID

Specifies which QoS policy to modify.
 

Options

--mode STATIC|USED_CAPACITY| PROVISIONED_CAPACITY

Sets a mode of provisioning quality of service per view:

  • STATIC. Enables configuration of maximum allowed amounts of BW and IOPS.

  • USED_CAPACITY. In this mode, allowed amounts of BW and IOPS are set per unit of used logical capacity. For example, you can allow for 3 read IOPS per GB of used capacity. Static limits are also configurable and define boundaries of performance allowance.

    This mode requires that a quota is configured on the view.

  • PROVISIONED_CAPACITY. In this mode, allowed amounts of BW and IOPS are set per unit of logical capacity as provisioned by the soft limit of a quota on the view path. For example, you can allow for 1 MB/sec of read BW per GB of the capacity limit configured in a quota (the soft limit capacity). Static limits are also configurable and define boundaries of performance allowance.

    This mode requires that a quota is configured on the view.

--limit-by BW|IOPS|BW_IOPS

Specifies performance parameters by which to limit service:

  • BW_IOPS. Enables limiting of service according to bandwidth (BW) and IO per second (IOPS).

  • BW. Enables limiting of service according to BW only.

  • IOPS. enables limiting of service according to IOPS only.

--static-limits STATIC_LIMITS

Enables and configures maximum performance limits per view. Maximum limits define maximum provisioning in the absence of resource contention.

Specify STATIC_LIMITS as a comma-separated list of key=value pairs where the following key values can be valid, depending on which performance parameters are enabled by --limit-by:

  • max_reads_bw_mbps. Maximum read BW to provision, in Mbps.

  • max_reads_iops. Maximum read IOPS to provision.

    The size of a single IO for the purpose of the limit is 1 MB. In other words, the number of IOs per request is obtained by dividing request size by 1 MB.

  • max_writes_bw_mbps Maximum write BW to provision, in Mbps.

  • max_writes_iops. Maximum write IOPS to provision.

    The size of a single IO for the purpose of the limit is 1 MB. In other words, the number of IOs per request is obtained by dividing request size by 1 MB.

For example:

max_reads_bw_mbps=1024,max_reads_iops=1024,max_writes_iops=2048

--capacity-limits CAPACITY_LIMITS

Enables and configures maximum performance limits per unit of either used logical capacity or provisioned logical capacity, depending on the provisioning mode (see also --mode).

Specify CAPACITY_LIMITS as a comma-separated list of key=value pairs, where the following key values can be valid, depending on which performance parameters are enabled by --limit-by:

  • max_reads_bw_mbps_per_gb_capacity. Maximum read BW to provision per GB of used logical or provisioned logical capacity, depending on the provisioning mode (set by --mode).

  • max_reads_iops_per_gb_capacity. Maximum read IOPS to provision per GB of used logical or provisioned logical capacity, depending on the provisioning mode (set by --mode)..

    The size of a single IO for the purpose of the limit is 1 MB. In other words, the number of IOs per request is obtained by dividing request size by 1 MB.

  • max_writes_bw_mbps_per_gb_capacity. Maximum write BW to provision per GB of used logical or provisioned logical capacity, depending on the provisioning mode (set by --mode).

  • max_writes_iops_per_gb_capacity. Maximum write IOPS to provision per GB of used logical or provisioned logical capacity,depending on the provisioning mode (set by --mode).

    The size of a single IO for the purpose of the limit is 1 MB. In other words, the number of IOs per request is obtained by dividing request size by 1 MB.

For example:

max_reads_bw_mbps_per_gb_capacity=1024,max_writes_iops_per_gb_capacity=2048
 

Example

vcli: admin> qospolicy modify --id 3 --mode STATIC --limit-by BW_IOPS --static-limits max_reads_bw_mbps=1024,max_reads_iops=1024,max_writes_iops=2048
 
 

Related articles

Comments

0 comments

Article is closed for comments.