VLAN Profile Assignments

Dashboard Location: Network-wide > Configure > VLAN Profiles

VLAN Profile Assignment Management

VLAN profile assignments link devices and switch stacks to a specific VLAN profile within a network. Once assigned, switch ports on those devices can reference VLAN names symbolically (via vlan_name and voice_vlan_name) instead of hardcoded VLAN IDs. The module resolves the symbolic name to the corresponding numeric VLAN ID at apply time by looking up the assigned profile. If the name is not found in the assigned profile, the network’s Default profile is used as a fallback.

Diagram

Classes

networks (meraki.domains.organizations)

Name	Type	Constraint	Mandatory	Default Value
vlan_profiles_assignments	List	[vlan_profiles_assignments]	No

vlan_profiles_assignments (meraki.domains.organizations.networks)

Name	Type	Constraint	Mandatory	Default Value
devices	List	String[min: 1, max: 127]	No
stacks	List	String[min: 1, max: 127]	No
vlan_profile_iname	String	min: 1, max: 127	Yes

Examples

Example-1: The example below demonstrates VLAN profile assignment configuration.

This configuration assigns the “CORP” VLAN profile to two individual switches (access_switch_01 and access_switch_02) and a switch stack (DEV_CORE) within a network. Once assigned, ports on these devices can use vlan_name and voice_vlan_name fields to reference VLANs by their symbolic names defined in the CORP profile, rather than specifying numeric VLAN IDs directly. The devices list accepts device names and the stacks list accepts stack names as defined in the network configuration.

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
              vlan_profiles:
                - name: Default Profile
                  iname: Default
                  vlan_names:
                    - name: default
                      vlan_id: "1"
                    - name: internal
                      vlan_id: "2"
                  vlan_groups: []
                - name: CORP
                  iname: CORP
                  vlan_names:
                    - name: default
                      vlan_id: "100"
                    - name: internal
                      vlan_id: "200"
                  vlan_groups: []
              vlan_profiles_assignments:
                - vlan_profile_iname: CORP
                  devices:
                    - !env access_switch_01
                    - !env access_switch_02
                  stacks:
                    - DEV_CORE