Switch Routing Interfaces Configuration

Dashboard Location: Switching > Configure > Routing and DHCP

Layer 3 Interface Management

Switch routing interfaces configuration in Meraki networks provides administrators with the capability to implement Layer 3 routing functionality on capable switches, enabling inter-VLAN routing, gateway services, and advanced networking features. This functionality supports subnet management, IP address assignment, multicast routing, OSPF protocol integration, and dual-stack IPv4/IPv6 configuration. Switch routing interfaces are essential for distributed routing architectures, network segmentation, reducing network hops, and providing high-performance inter-VLAN communication without requiring dedicated routers.

Diagram

Classes

devices (meraki.domains.organizations.networks)

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

switch_routing_interfaces (meraki.domains.organizations.networks.devices)

Name	Type	Constraint	Mandatory	Default Value
name	String	min: `1`, max: `127`	No
subnet	String	Regex: `^((25[0-5]\|2[0-4][0-9]\|1[0-9]{2}\|[1-9]?[0-9])\.){3}(25[0-5]\|2[0-4][0-9]\|1[0-9]{2}\|[1-9]?[0-9])\/([1-9]\|[12][0-9]\|3[0-2])$`	No
interface_ip	IP		No
multicast_routing	Choice	`IGMP snooping querier`, `disabled`, `enabled`	No
vlan_id	Any	Integer[min: `1`, max: `4094`] or String[matches: `(?:[1-9]	[1-9][0-9]	[1-9][0-9]2
default_gateway	IP		No
ospf_settings	Class	`[ospf_settings]`	No
ipv6	Class	`[ipv6]`	No
dhcp	Class	`[dhcp]`	No

ospf_settings (meraki.domains.organizations.networks.devices.switch_routing_interfaces)

Name	Type	Constraint	Mandatory
area	Any	String[min: `1`, max: `13`] or IP or Integer[min: `1`, max: `4294967295`]	No
cost	Integer	min: `1`, max: `65535`	No
is_passive	Boolean	`true`, `false`	No

ipv6 (meraki.domains.organizations.networks.devices.switch_routing_interfaces)

Name	Type	Constraint	Mandatory
assignment_mode	Choice	`eui-64`, `static`	No
prefix	String	min: `1`, max: `1024`	No
address	String	min: `1`, max: `1024`	No
gateway	IP		No

dhcp (meraki.domains.organizations.networks.devices.switch_routing_interfaces)

Name	Type	Constraint	Mandatory
dhcp_mode	Choice	`dhcpDisabled`, `dhcpRelay`, `dhcpServer`	No
dhcp_relay_server_ips	List	IP	No
dhcp_lease_time	Choice	`1 day`, `1 hour`, `1 week`, `12 hours`, `30 minutes`, `4 hours`	No
dns_nameservers_option	Choice	`custom`, `googlePublicDns`, `openDns`	No
dns_custom_nameservers	List	IP	No
boot_next_server	IP		No
boot_file_name	String	min: `1`, max: `127`	No
dhcp_options	List	`[dhcp_options]`	No
reserved_ip_ranges	List	`[reserved_ip_ranges]`	No
fixed_ip_assignments	List	`[fixed_ip_assignments]`	No
boot_options	Boolean	`true`, `false`	No

dhcp_options (meraki.domains.organizations.networks.devices.switch_routing_interfaces.dhcp)

Name	Type	Constraint	Mandatory
code	String	Regex: `^([2-9]\|1[0-9][0-9]?\|2[0-9]\|2[0-5][0-4]\|[3-9][0-9])$`	Yes
type	Choice	`hex`, `integer`, `ip`, `text`	Yes
value	String	min: `1`, max: `127`	Yes

reserved_ip_ranges (meraki.domains.organizations.networks.devices.switch_routing_interfaces.dhcp)

Name	Type	Constraint	Mandatory
start	IP		Yes
end	IP		Yes
comment	String	min: `1`, max: `127`	No

fixed_ip_assignments (meraki.domains.organizations.networks.devices.switch_routing_interfaces.dhcp)

Name	Type	Constraint	Mandatory
name	String	min: `1`, max: `127`	Yes
mac	MAC		Yes
ip	IP		Yes

Examples

Example-1: The example below demonstrates switch routing interfaces 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
              devices:
                - name: "!env dmz_switch_02"
                  switch_routing_interfaces:
                    - name: "VLAN 10"
                      subnet: "1.1.1.0/24"
                      interface_ip: "1.1.1.1"
                      multicast_routing: "disabled"
                      vlan_id: 100
                      default_gateway: "1.1.1.254"
                      ospf_settings:
                        area: "0"
                        cost: 1
                        is_passive: false

Configuration Parameters

Parameter	Type	Required	Description
`switch_routing_interfaces`	Array	No	List of routing interface definitions
`switch_routing_interfaces[n].name`	String	Yes	Descriptive name for the routing interface
`switch_routing_interfaces[n].subnet`	String	Yes	Network subnet in CIDR notation (e.g., “192.168.1.0/24”)
`switch_routing_interfaces[n].interface_ip`	String	Yes	IP address of the switch interface
`switch_routing_interfaces[n].multicast_routing`	String	No	Multicast routing: “enabled”, “disabled” (default: “disabled”)
`switch_routing_interfaces[n].vlan_id`	Integer	Yes	VLAN ID associated with the routing interface
`switch_routing_interfaces[n].default_gateway`	String	No	Default gateway for the interface
`switch_routing_interfaces[n].ospf_settings`	Object	No	OSPF configuration for the interface
`switch_routing_interfaces[n].ospf_settings.area`	String	Yes	OSPF area ID
`switch_routing_interfaces[n].ospf_settings.cost`	Integer	Yes	OSPF interface cost (1-65535)
`switch_routing_interfaces[n].ospf_settings.is_passive`	Boolean	Yes	Enable passive OSPF interface
`switch_routing_interfaces[n].ipv6`	Object	No	IPv6 configuration settings
`switch_routing_interfaces[n].ipv6.assignment_mode`	String	Yes	IPv6 assignment: “static”, “auto”
`switch_routing_interfaces[n].ipv6.prefix`	String	Conditional	IPv6 prefix (required for static mode)
`switch_routing_interfaces[n].ipv6.address`	String	Conditional	IPv6 address (required for static mode)
`switch_routing_interfaces[n].ipv6.gateway`	String	No	IPv6 default gateway

Interface Types and Deployment

Interface Type	Use Case	Routing Behavior	Performance Characteristics
VLAN Interface	Inter-VLAN routing	Layer 3 gateway	Wire-speed routing
Loopback Interface	Management/OSPF router ID	Virtual interface	High availability
Point-to-Point	WAN connections	Direct routing	Low latency
Management Interface	Out-of-band management	Administrative access	Dedicated management

Subnet Planning Guidelines

Subnet Size	CIDR	Hosts	Recommended Use	Growth Consideration
/24	256 addresses	254 hosts	Departmental networks	Standard deployment
/25	128 addresses	126 hosts	Small departments	Conservative allocation
/23	512 addresses	510 hosts	Large departments	Future expansion
/22	1024 addresses	1022 hosts	Campus networks	Significant growth