add qos-rule

In the R82.00.X releases, this command is available starting from the R82.00.00 version.

Description

Adds a new QoS rule.

Syntax

add qos-rule

[ name <name> ]

[ comment "<comment>" ]

[ source <source> ]

[ destination <destination> ]

[ service <service> ]

[ low-latency-rule true ]

[ low-latency-rule false ]

[ limit-bandwidth { false | true limit-percentage <1-100> } ]

[ guarantee-bandwidth { false | true guarantee-percentage <1-100> } ]

[ weight <weight> ]

[ hours-range-enabled { false | true hours-range-from <hours-range-from> hours-range-to <hours-range-to> } ]

[ diffserv-mark { false | true diffserv-mark-val <1-63> } ]

[ { position <position> | position-above <position-above> | position-below <position-below> } ]

[ log {log | none} ]

[ vpn {true | false} ]

Parameters

Parameter	Description
comment	Configures the comment text. A string that contains less than 257 characters, of this set: `a-z` (lower-case letters) `A-Z` (upper-case letters) `0-9` (digits) '`,`' (comma) '`.`' (period) '`-`' (minus) '`(`' (opening round bracket) '`)`' (closing round bracket) '`:`' (colon) '`@`' (at)
destination	Network object that is the target of the connection.
diffserv-mark	Controls whether to use a DiffServ Mark - a way to mark connections so a third party handles it.
diffserv-mark-val	Configures the DiffServ Mark value. This marks packets to be given priority on the public network according to their DSCP. You can get the DSCP value from your ISP or private WAN administrator. To use this option, your ISP or private WAN must support DiffServ.
guarantee-bandwidth	Enables (`true`) or disables (`false`) traffic guarantee. Available only if `low-latency-rule` = `false`.
guarantee-percentage	Configures the traffic guarantee percentage. Available only if `guarantee-bandwidth` = `true`.
hours-range-enabled	Controls whether to enable this rule during specific hours of the day.
hours-range-from	Configures the start time during the day (in the format HH:MM) when to enable this rule. Available only if `hours-range-enabled` = `true`.
hours-range-to	Configures the end time during the day (in the format HH:MM) when to disable this rule. Available only if `hours-range-enabled` = `true`.
limit-bandwidth	Controls whether to limit traffic (`true`) or not (`false`). Available only if `low-latency-rule` = `false`.
limit-percentage	Configures the traffic limit percentage. Available only if `limit-bandwidth` = `true`.
log	Controls whether to generate a log for this rule.
low-latency-rule	Configures the Low (`false`) or Normal (`true`) latency for this rule. If you configure the Low (`false`) latency, you can also configure the limit and guarantee.
name	Name of this rule. A string that begins with a letter and contains up to 32 characters without spaces, of this set: `a-z` (lower-case letters) `A-Z` (upper-case letters) `0-9` (digits) '`.`' (period) '`-`' (minus) '`_`' (underscore)
position	Specifies the order of the rule (a decimal number) in comparison to other manual rules.
position-above	Specifies the relative order of the rule (a decimal number) in comparison to other manual rules.
position-below	Specifies the relative order of the rule (a decimal number) in comparison to other manual rules.
service	Specifies the service object. Press the TAB key to see the available options.
source	Specifies the Network object or User group that initiates the connection. Press the TAB key to see the available options.
vpn	Enables (`true`) or disables (`false`) this rule for traffic that passes over a VPN tunnel.
weight	Configures the traffic weight, relative to the weights configures in other QoS rules.

Example Command

add qos-rule name MyQosRule comment "QoS for HTTP from Internal to External" source MyInternalNetwork destination MyExternalNetwork service HTTP low-latency-rule false limit-bandwidth true limit-percentage 15 guarantee-bandwidth true guarantee-percentage 30 weight 30 hours-range-enabled true hours-range-from 20:00 hours-range-to 23:00 diffserv-mark true diffserv-mark-val 5 position 2 log none vpn true