Switch Link Aggregations Configuration

Dashboard Location: Switching > Configure > Link Aggregation

Network Link Aggregation and LACP Management

Switch Link Aggregations configuration in Meraki networks provides administrators with comprehensive port bonding and link aggregation capabilities, enabling increased bandwidth, redundancy, and load distribution across multiple physical connections. This functionality supports enterprise network resilience, bandwidth optimization, high availability requirements, and traffic load balancing through Link Aggregation Control Protocol (LACP) and static link bundling for enhanced network performance and fault tolerance.

Diagram

Classes

switch (meraki.domains.organizations.networks)

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

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

Name	Type	Constraint	Mandatory
switch_ports	List	`[switch_ports]`	No
switch_profile_ports	List	`[switch_profile_ports]`	No
link_aggregation_name	String	min: `1`, max: `127`	Yes

switch_ports (meraki.domains.organizations.networks.switch.link_aggregations)

Name	Type	Constraint	Mandatory	Default Value
port_id	Any	Integer[min: `1`, max: `24`] or String[matches: `(\d{1,3})`]	Yes
device	Any	String[matches: `^[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}$`] or String[min: `1`, max: `127`]	Yes

switch_profile_ports (meraki.domains.organizations.networks.switch.link_aggregations)

Name	Type	Constraint	Mandatory	Default Value
profile	String	min: `1`, max: `127`	Yes
port_id	Any	Integer[min: `1`, max: `24`] or String[matches: `(\d{1,3})`]	Yes

Examples

Example-1: The example below demonstrates switch link aggregations 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:
                link_aggregations:
                  - switch_ports:
                      - device: !env core_switch_01
                        port_id: 8
                      - device: !env core_switch_01
                        port_id: 9
                    link_aggregation_name: "LAG1"
                    # switch_profile_ports:
                    #   - profile: "1"
                    #     port_id: 1
                    #   - profile: "1"
                    #     port_id: 2
                  - switch_ports:
                      - device: !env core_switch_02
                        port_id: 8
                      - device: !env core_switch_02
                        port_id: 9
                    link_aggregation_name: "LAG1"
                    # switch_profile_ports:
                    #   - profile: "2"
                    #     port_id: 3
                    #   - profile: "2"
                    #     port_id: 4