Skip to content

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

Diagram

Classes

switch (meraki.domains.organizations.networks)

NameTypeConstraintMandatoryDefault Value
qos_rulesList[qos_rules]No

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

NameTypeConstraintMandatoryDefault Value
vlanAnyInteger[min: 1, max: 4094] or String[matches: `(?:[1-9][1-9][0-9][1-9][0-9]2
protocolChoiceANY, TCP, UDPNo
dscpIntegermin: -1, max: 63No
source_portIntegermin: 0, max: 65535No
source_port_rangeStringRegex: ^([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_portIntegermin: 0, max: 65535No
destination_port_rangeStringRegex: ^([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_nameStringmin: 1, max: 127Yes

Examples

Example-1: The example below demonstrates switch QoS rules configuration using tested YAML configuration from pipeline fixtures.

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"

Configuration Parameters

ParameterTypeRequiredDescription
qos_rulesArrayNoList of QoS rule definitions
qos_rules[n].qos_rule_nameStringYesDescriptive name for the QoS rule
qos_rules[n].vlanIntegerYesVLAN ID for traffic matching
qos_rules[n].protocolStringYesNetwork protocol: “TCP”, “UDP”, “ANY”
qos_rules[n].source_portIntegerNoSpecific source port number
qos_rules[n].source_port_rangeStringNoSource port range (e.g., “1024-2048”)
qos_rules[n].destination_portIntegerNoSpecific destination port number
qos_rules[n].destination_port_rangeStringNoDestination port range (e.g., “80-90”)
qos_rules[n].dscpIntegerYesDSCP marking value (0-63)

DSCP Marking Values

DSCP ValueTraffic ClassPriority LevelTypical Applications
46Expedited Forwarding (EF)HighestVoice, real-time audio
34Assured Forwarding 41 (AF41)HighVideo conferencing
26Assured Forwarding 31 (AF31)Medium-HighCritical business apps
18Assured Forwarding 21 (AF21)MediumInteractive applications
10Assured Forwarding 11 (AF11)LowBulk data transfer
8Class Selector 1 (CS1)LowestBackground traffic
0Best Effort (BE)DefaultStandard traffic

Protocol Classification

ProtocolCommon PortsTraffic TypeQoS Recommendation
TCP80, 443, 22, 23Web, secure, managementStandard-Medium
UDP53, 123, 5060-5070DNS, NTP, VoiceHigh for voice
ANYAll protocolsCatch-all rulesUse sparingly

Common Application Port Mappings

ApplicationProtocolPort(s)DSCP RecommendationPriority Justification
Voice (SIP)UDP5060-507046Real-time communication
Voice (RTP)UDP16384-3276746Audio media streams
Video ConferenceUDP1024-6553534Video media streams
Remote DesktopTCP338926Interactive business app
DatabaseTCP1433, 3306, 543226Critical business data
Web (HTTP)TCP800Standard web traffic
Web (HTTPS)TCP4430Secure web traffic
File TransferTCP20-2110Bulk data transfer
Email (SMTP)TCP25, 58718Business communication
Email (IMAP)TCP143, 99318Email access