lbcli update qos-policy (2.3.16 and above)

AI Tools

Updates an existing QoS policy.

Synopsis

Updates an existing QoS policy.

Note

Currently only a full update is supported. All fields should have valid values. A new policy will completely override previous values.

lbcli update qos-policy [flags]

Examples:

# Update an existing QoS policy. lbcli -J $JWT update qos-policy --uuid=435b55ad-6ce1-4b0d-b0f5-3a37db8825f3 --description="best iops" --type iops --write-limit 256 --read-limit 1024 --projects proj-a,proj-b lbcli -J $JWT update qos-policy --name=bw-silver --description="good enough bw" --type bw --write-limit 10 --read-limit 10 --projects proj-a lbcli -J $JWT update qos-policy --name=another-qos-policy --description="yet another policy" --global true --type iops-per-gb --write-limit 0 --read-limit 10

Flag

Short

Type

Default

Description

--help

-h

bool


Help for qos-policy.

--description


string


Policy description.

--global


bool


Sets the policy as global (available for use by all projects/volumes in the cluster).

Note: The Lightbits 2.3.16 release does not support updating the value of global from true to false, and vice versa.

--name


string


Policy name.

--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.

--pure-iops


bool


When true, each IO costs 1 IOPS regardless of size (only valid with iops/iops-per-gb types).

--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 bandwith 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 read-limit=30, write-limit=20 and volume size is 7Tib, the actual limits for this volume would be: read 210,000 IOPs, write 140,000 IOPs. Note that the volume size will be rounded down if it is not a whole GB.

--uuid


string


Policy UUID.

--write-limit


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.