Skip to content

VLAN Configuration

Dashboard Location: Security and SD-WAN > Configure > Addressing & VLANs > VLANs

VLAN configuration in Meraki appliances provides comprehensive network segmentation capabilities including subnet management, DHCP services, IPv6 support, and advanced networking features. This functionality enables organizations to create secure network boundaries, implement traffic isolation policies, and support complex network architectures while maintaining centralized management and visibility. VLAN configuration is essential for enterprise deployments requiring network segmentation, security isolation, and scalable network design.

Diagram

appliance (meraki.domains.organizations.networks)

Section titled “appliance (meraki.domains.organizations.networks)”
NameTypeConstraintMandatoryDefault Value
vlansList[vlans]No

vlans (meraki.domains.organizations.networks.appliance)

Section titled “vlans (meraki.domains.organizations.networks.appliance)”
NameTypeConstraintMandatoryDefault Value
nameStringmin: 1, max: 127No
subnetStringRegex: ^((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
appliance_ipIPNo
template_vlan_typeChoicesame, uniqueNo
cidrStringRegex: ^(?i:any|(\d{1,3}\.){3}\d{1,3}(\/\d{1,2})?)(,(any|(\d{1,3}\.){3}\d{1,3}(\/\d{1,2})?))*$No
maskIntegermin: 0, max: 32No
ipv6Class[ipv6]No
dhcp_handlingChoiceDo not respond to DHCP requests, Relay DHCP to another server, Run a DHCP serverNo
dhcp_lease_timeChoice1 day, 1 hour, 1 week, 12 hours, 30 minutes, 4 hoursNo
mandatory_dhcpBooleantrue, falseNo
dhcp_optionsList[dhcp_options]No
dhcp_boot_optionsBooleantrue, falseNo
group_policy_nameStringmin: 1, max: 127No
vlan_idAnyInteger[min: 1, max: 4094] or String[matches: `(?:[1-9][1-9][0-9][1-9][0-9]2
vpn_nat_subnetStringRegex: ^((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
dhcp_relay_server_ipsListIPNo
dhcp_boot_next_serverIPNo
dhcp_boot_filenameStringmin: 1, max: 127No
fixed_ip_assignmentsClass[fixed_ip_assignments]No
reserved_ip_rangesList[reserved_ip_ranges]No
dns_nameserversStringRegex: ^(upstream_dns|google_dns|opendns|custom)$No

ipv6 (meraki.domains.organizations.networks.appliance.vlans)

Section titled “ipv6 (meraki.domains.organizations.networks.appliance.vlans)”
NameTypeConstraintMandatoryDefault Value
enabledBooleantrue, falseNo
prefix_assignmentsList[prefix_assignments]No

dhcp_options (meraki.domains.organizations.networks.appliance.vlans)

Section titled “dhcp_options (meraki.domains.organizations.networks.appliance.vlans)”
NameTypeConstraintMandatoryDefault Value
codeStringRegex: ^([2-9]|1[0-9][0-9]?|2[0-9]|2[0-5][0-4]|[3-9][0-9])$Yes
typeChoicehex, integer, ip, textYes
valueStringmin: 1, max: 127Yes

fixed_ip_assignments (meraki.domains.organizations.networks.appliance.vlans)

Section titled “fixed_ip_assignments (meraki.domains.organizations.networks.appliance.vlans)”
NameTypeConstraintMandatoryDefault Value
ipIPNo
nameStringmin: 1, max: 127No

reserved_ip_ranges (meraki.domains.organizations.networks.appliance.vlans)

Section titled “reserved_ip_ranges (meraki.domains.organizations.networks.appliance.vlans)”
NameTypeConstraintMandatoryDefault Value
startIPYes
endIPYes
commentStringmin: 1, max: 127Yes

prefix_assignments (meraki.domains.organizations.networks.appliance.vlans.ipv6)

Section titled “prefix_assignments (meraki.domains.organizations.networks.appliance.vlans.ipv6)”
NameTypeConstraintMandatoryDefault Value
autonomousBooleantrue, falseNo
static_prefixIPNo
static_appliance_ip6IPNo
originClass[origin]No

origin (meraki.domains.organizations.networks.appliance.vlans.ipv6.prefix_assignments)

Section titled “origin (meraki.domains.organizations.networks.appliance.vlans.ipv6.prefix_assignments)”
NameTypeConstraintMandatoryDefault Value
typeChoiceindependent, internetYes
interfacesListString[min: 1, max: 10]No

Example-1: The example below demonstrates VLAN 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
appliance:
vlans:
- vlan_id: 10
name: "VLAN10"
subnet: "192.168.10.0/24"
appliance_ip: "192.168.10.1"
dhcp_handling: "Run a DHCP server"
dhcp_lease_time: "1 day"
dhcp_boot_options: false
dhcp_options:
- code: "66"
type: "text"
value: "tftp.example.com"
- code: "67"
type: "text"
value: "bootfile"
reserved_ip_ranges:
- start: "192.168.10.40"
end: "192.168.10.50"
comment: "Reserved for printers"
dns_nameservers: "8.8.8.8"
mandatory_dhcp: true
- vlan_id: 20
name: "Guest"
subnet: "192.168.20.0/24"
appliance_ip: "192.168.20.1"
dhcp_handling: "Run a DHCP server"
dhcp_lease_time: "4 hours"
dns_nameservers: "1.1.1.1"
mandatory_dhcp: true