lbcli create qos-policy (2.3.16 and above)

AI Tools

Creates a new Quality of Service (QoS) policy.

Synopsis

Creates a new QoS policy.

lbcli create qos-policy [flags]

Examples:

# Create a QoS policy. lbcli -J $JWT create qos-policy --name=iops-gold --description="best iops" --type iops --write-limit 256 --read-limit 512 --projects "default" lbcli -J $JWT create qos-policy --name=bw-silver --description="good enough bw" --type bw --write-limit 10 --read-limit 10 --projects "default" lbcli -J $JWT create qos-policy --name=another-qos-policy --description="yet another policy" --global true --type iops-per-gb --write-limit 0 --read-limit 10 --projects "default"

Flag

Short

Type

Default

Description

--description


string


Policy description.

--help

-h

bool


Help for qos-policy.

--name


string


Policy name (required).

--global


bool


Indicates that this policy is global.

--projects


stringSlice


Specify the projects that can have access to this policy.

Note: Either specify the policy as Global (global=true), or explicitly name specific projects that can use this policy.

--read-limit


uint32


Specify the rate limit for read operations.

The units of this field are defined by the rate limit Type field.

Note: A 0 value encodes unlimited.

--type


string


Limit type (iops, bw, ips-per-gb) (Required).

  • iops: Volume read and write bandwidth limits, specified in units of IOPs. The granularity increases by 256 IOPs each time. For example, 400 IOPs would be rounded up to 512 IOPs. Note that the IOPs limit assumes a 4 KB block size for rate calculations.

  • bw: Volume read and write bandwidth limits, specified in units of MB/s. The granularity must be in full MB/s.

  • iops-per-gb: Volume read and write bandwidth, specified in limits in IOPs per GB of volume size. For example, if we configure 100 units, and the volume size is 10 GB, then the actual limit will be 1000 IOPs/second. Note that the volume size will be rounded down if it is not a whole GB.

--wri


uint32


Specify the rate limit for write operations.

The units of this field are defined by the rate limit Type field.

Note: A 0 value encodes unlimited.