Switch QoS Rules Configuration

Dashboard Location: Switching > Configure > Switch Settings > Quality of Service

Network Traffic Prioritization Management

Switch QoS (Quality of Service) rules configuration in Meraki networks provides administrators with the capability to implement traffic prioritization and bandwidth management based on network protocols, VLAN assignments, port ranges, and DSCP markings. functionality enables performance optimization for critical applications, ensures consistent service delivery, manages network congestion, and supports service level agreements through granular traffic classification and prioritization. QoS rules are essential for maintaining network performance in mixed-traffic environments, supporting real-time applications, and ensuring optimal user experience across diverse network services.

Diagram

Classes

switch (meraki.domains.organizations.networks)

Name	Type	Constraint	Mandatory	Default Value
qos_rules	List	`[qos_rules]`	No

qos_rules (meraki.domains.organizations.networks.switch)

Name	Type	Constraint	Mandatory	Default Value
vlan	Any	Integer[min: `1`, max: `4094`] or String[matches: `(?:[1-9]	[1-9][0-9]	[1-9][0-9]2
protocol	Choice	`ANY`, `TCP`, `UDP`	No
dscp	Integer	min: `-1`, max: `63`	No
source_port	Integer	min: `0`, max: `65535`	No
source_port_range	String	Regex: `^([1-9]\|[1-9]\d{1,3}\|[1-5]\d{4}\|6[0-4]\d{3}\|65[0-4]\d{2}\|655[0-2]\d\|6553[0-5])-(\d\|[1-9]\d{1,3}\|[1-5]\d{4}\|6[0-4]\d{3}\|65[0-4]\d{2}\|655[0-2]\d\|6553[0-5])$`	No
destination_port	Integer	min: `0`, max: `65535`	No
destination_port_range	String	Regex: `^([1-9]\|[1-9]\d{1,3}\|[1-5]\d{4}\|6[0-4]\d{3}\|65[0-4]\d{2}\|655[0-2]\d\|6553[0-5])-(\d\|[1-9]\d{1,3}\|[1-5]\d{4}\|6[0-4]\d{3}\|65[0-4]\d{2}\|655[0-2]\d\|6553[0-5])$`	No
qos_rule_name	String	min: `1`, max: `127`	Yes

Examples

Example-1: The example below demonstrates QoS rules configuration.

Below configuration implements Quality of Service policies for traffic prioritization and bandwidth management. The example includes DSCP marking, traffic classification, and priority queuing for different application types and network services.

This configuration defines three QoS (Quality of Service) rules applied to VLAN 100, allowing traffic prioritization based on protocol and port matching. Each rule specifies how traffic should be classified using DSCP (Differentiated Services Code Point) values:

Rule 2: Matches TCP traffic with source port 2000 and destination ports 300–400, and assigns DSCP 0 (default best-effort service).
Rule 1: Matches UDP traffic with source ports 72–82 and destination port 3003, assigning DSCP 0.
Rule 3: Matches UDP traffic with source ports 83–85 and destination port 3003, but sets DSCP -1, which typically indicates no DSCP marking or that existing DSCP values should be preserved/ignored.

These rules help classify and prioritize specific application traffic on VLAN 100, ensuring efficient bandwidth use and service differentiation for TCP/UDP flows.

meraki:
  domains:
    - name: !env domain
      administrator:
        name: !env org_admin
      organizations:
        - name: !env org
          networks:
            - name: !env network_name
              product_types:
                - appliance
                - switch
                - wireless
                - camera
                - sensor
                - cellularGateway
              switch:
                qos_rules:
                  - vlan: 100
                    protocol: TCP
                    source_port: 2000
                    destination_port_range: 300-400
                    dscp: 0
                    qos_rule_name: "Rule 2"
                  - vlan: 100
                    protocol: UDP
                    source_port_range: 72-82
                    destination_port: 3003
                    dscp: 0
                    qos_rule_name: "Rule 1"
                  - vlan: 100
                    protocol: UDP
                    source_port_range: 83-85
                    destination_port: 3003
                    dscp: -1
                    qos_rule_name: "Rule 3"