/system/qos/{QoS.name}/queues/{Queue.queue_number}

patch

https://switch-ip/rest/v10.16/system/qos/{QoS.name}/queues/{Queue.queue_number}

Path Params

QoS.name

string

required

Reference Resource: QoS
There must be a user-defined name of the schedule profile.

Queue.queue_number

string

required

Reference Resource: Queue
Schedule parameters for individual queues. Queues are numbered in priority order, with zero being the lowest priority. The maximum number of queues is hardware dependent.

Body Params

algorithm

string

enum

This parameter selects the scheduling behavior of the queue: * strict - Strict Priority will service all packets in the queue before any packets in lower numbered queues as long as there are no packets in any higher number queue. dwrr - Deficit Weighted Round Robin will apportion available bandwidth among all non-empty dwrr queues in relation to their queue weights. wfq - Weighted Fair Queuing will apportion available bandwidth among all non-empty wfq queues in relation to their queue weights. If this parameter is missing, it is assumed to be 'strict'.

Allowed:

bandwidth

integer

1 to 400000000

The bandwidth limit to apply to egress queue traffic. If no bandwidth value is applied, the bandwidth will not be limited per queue. If the algorithm configured on this queue does not support a bandwidth limit, this value will be ignored. Bandwidth limits to configure per-queue shaping are supported on queues which use the following algorithms: - Strict Configuration can be validated by referring to [egress_shape_hw_rate] (Port.rate_limits_status.egress_shape_hw_rate).

bandwidth_units

string

enum

Units of the egress queue bandwidth: kbps: kilobits per second. percent - the units are in percentage of port speed.

Allowed:

burst

int64

1 to 4294967295

The burst size (in kilobytes) allowed per bandwidth-limited queue. If no burst is specified, the default burst of 32 KB will be applied. Per-queue burst is supported on queues which use the following algorithms: - Strict Configuration can be validated by referring to [egress_burst_hw_rate] (Port.rate_limits_status.egress_burst_hw_rate).

queue_number

integer

required

Reference Resource: Queue
Schedule parameters for individual queues. Queues are numbered in priority order, with zero being the lowest priority. The maximum number of queues is hardware dependent.

weight

integer

1 to 127

The weight value for this queue. The maximum weight is hardware dependent.

Responses

204

No Content

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

415

Unsupported Media Type

500

Internal Server Error

501

Not Implemented

503

Service Unavailable

Language

Response

Click Try It! to start a request and see the response here!