Trunk Interface Port

The Trunk Ethernet port configuration allows to define the multiple attributes that an trunk port can have.

Diagram

Classes

vxlan

Name	Type	Constraint	Mandatory	Default Value
topology	Class	topology	No

topology (vxlan)

Name	Type	Constraint	Mandatory	Default Value
switches	List	switches	No

switches (vxlan.topology)

Name	Type	Constraint	Mandatory	Default Value
interfaces	List	Any[Class[`[topology_switch_access_interface]`] or Class[topology_switch_trunk_interface] or Class[`[topology_switch_access_po_interface]`] or Class[`[topology_switch_trunk_po_interface]`] or Class[`[topology_switch_routed_interface]`] or Class[`[topology_switch_routed_sub_interface]`] or Class[`[topology_switch_routed_po_interface]`] or Class[`[topology_switch_loopback_interface]`] or Class[`[topology_switch_dot1q_host_interface]`]]	No

topology_switch_trunk_interface (vxlan.topology.switches.interfaces)

Name	Type	Constraint	Mandatory	Default Value
name	String	Regex: `(?i)^(?:e\|eth(?:ernet)?)\d(?:\/\d+){1,2}$`	Yes
mode	Choice	`trunk`	Yes
description	String	max: `256`	No	`NetAsCode Trunk Interface`
mtu	Any	Integer[min: `1500`, max: `9216`] or Choice[`default`, `jumbo`]	No	`jumbo`
speed	String	Regex: `(?i)^(auto\|100mb\|1gb\|10gb\|25gb\|40gb\|100gb\|200gb\|400gb\|800gb)$`	No	`auto`
enabled	Boolean	`true`, `false`	No	`true`
enable_cdp	Boolean	`true`, `false`	No	`true`
trunk_allowed_vlans	List	trunk_allowed_vlans	No	`none`
spanning_tree_portfast	Boolean	`true`, `false`	No	`true`
enable_bpdu_guard	Boolean	`true`, `false`	No	`true`
duplex	Choice	`auto`, `full`, `half`	No	`auto`
orphan_port	Boolean	`true`, `false`	No	`false`
native_vlan	Integer	min: `1`, max: `4094`	No
enable_qos	Boolean	`true`, `false`	No	`false`
qos_policy	String		No
queuing_policy	String		No
monitor	Boolean	`true`, `false`	No	`false`
freeform_config	String		No
fec	Choice	`auto`, `fc-fec`, `off`, `rs-cons16`, `rs-fec`, `rs-ieee`	No	`auto`
enable_storm_control	Boolean	`true`, `false`	No	`false`
storm_control_action	Choice	`shutdown`, `trap`, `default`	No	`default`
storm_control_broadcast_level_percent	Number	min: `0.0`, max: `100.0`	No
storm_control_broadcast_level_pps	Integer	min: `0`, max: `200000000`	No
storm_control_multicast_level_percent	Number	min: `0.0`, max: `100.0`	No
storm_control_multicast_level_pps	Integer	min: `0`, max: `200000000`	No
storm_control_unicast_level_percent	Number	min: `0.0`, max: `100.0`	No
storm_control_unicast_level_pps	Integer	min: `0`, max: `200000000`	No

topology_switch_trunk_interface (vxlan.topology.switches.interfaces)

Name	Type	Constraint	Mandatory	Default Value
name	String	Regex: `(?i)^(?:e\|eth(?:ernet)?)\d(?:\/\d+){1,2}$`	Yes
mode	Choice	`trunk`	Yes
description	String	max: `256`	No	`NetAsCode Trunk Interface`
mtu	Any	Integer[min: `1500`, max: `9216`] or Choice[`default`, `jumbo`]	No	`jumbo`
speed	String	Regex: `(?i)^(auto\|100mb\|1gb\|10gb\|25gb\|40gb\|100gb\|200gb\|400gb\|800gb)$`	No	`auto`
enabled	Boolean	`true`, `false`	No	`true`
trunk_allowed_vlans	List	trunk_allowed_vlans	No	`none`
spanning_tree_portfast	Boolean	`true`, `false`	No	`true`
enable_bpdu_guard	Boolean	`true`, `false`	No	`true`
duplex	Choice	`auto`, `full`, `half`	No	`auto`
orphan_port	Boolean	`true`, `false`	No	`false`
native_vlan	Integer	min: `1`, max: `4094`	No
enable_qos	Boolean	`true`, `false`	No	`false`
qos_policy	String		No
queuing_policy	String		No
monitor	Boolean	`true`, `false`	No	`false`
freeform_config	String		No

trunk_allowed_vlans (vxlan.topology.switches.interfaces.topology_switch_trunk_interface)

Name	Type	Constraint	Mandatory	Default Value
from	Integer	min: `1`, max: `4094`	Yes	`none`
to	Integer	min: `1`, max: `4094`	No	`none`

Forward Error Correction (FEC)

If you previously configured FEC via freeform_config, you must migrate to the fec parameter using the same value and remove the FEC configuration from freeform_config to avoid conflicts.

Forward Error Correction (FEC) controls error correction on the physical interface. The following FEC modes are supported:

auto - Automatic FEC selection (default, not visible in show run)
fc-fec - FireCode FEC (also known as BASE-R or Clause 74)
off - FEC disabled
rs-cons16 - Reed-Solomon FEC Consortium 1.6
rs-fec - Reed-Solomon FEC (Clause 91 for 100G, Consortium 1.5 for 25G/50G)
rs-ieee - Reed-Solomon FEC IEEE standard

Storm Control

If you previously configured storm control via freeform_config, you must migrate to the storm control parameters using the same values and remove the storm control configuration from freeform_config to avoid conflicts.

You cannot configure both percentage-based (*_percent) and PPS-based (*_pps) thresholds on the same interface. Choose one method per interface.

Storm control prevents traffic storms on Layer 2 interfaces by limiting broadcast, multicast, and unicast traffic. The following parameters are supported:

Control Parameters:

enable_storm_control - Enable or disable storm control (boolean)
storm_control_action - Action when threshold is exceeded: shutdown, trap, or default

Percentage-based Thresholds (0.00-100.00%):

storm_control_broadcast_level_percent - Broadcast traffic threshold as percentage of bandwidth
storm_control_multicast_level_percent - Multicast traffic threshold as percentage of bandwidth
storm_control_unicast_level_percent - Unicast traffic threshold as percentage of bandwidth

PPS-based Thresholds (0-200000000 packets/sec):

storm_control_broadcast_level_pps - Broadcast traffic threshold in packets per second
storm_control_multicast_level_pps - Multicast traffic threshold in packets per second
storm_control_unicast_level_pps - Unicast traffic threshold in packets per second

Example 1 - Basic Trunk Interface Configuration

This configuration creates Ethernet1/11, Ethernet1/12 and Ethernet1/13 on switch dc1-leaf1.

Interface Ethernet1/11 is configured with VLANs 10-20, 30, 40-50, MTU set as Jumbo (9216), speed auto and spanning-tree portfast enabled and BPDU guard disabled.
Interface Ethernet1/12 is configured with VLANs 45-48, the rest of the attributes are configured with the default settings.
Interface Ethernet1/13 is configured with all VLANs (1-4094), the rest of the attributes are configured with the default settings.

vxlan:
  topology:
    switches:
      - name: dc1-leaf1
        interfaces:
          - name: Ethernet1/11
            mode: trunk
            description: 'Trunk Interface 1'
            enabled: true
            mtu: jumbo
            speed: auto
            trunk_allowed_vlans:
              - from: 10
                to: 20
              - from: 30
              - from: 40
                to: 50
            spanning_tree_portfast: true
            enable_bpdu_guard: false
          - name: e1/12
            mode: trunk
            speed: 10gb
            trunk_allowed_vlans:
              - from: 45
                to: 48
          - name: e1/13
            mode: trunk
            trunk_allowed_vlans:
              - from: 1
                to: 4094

Example 2 - FEC Configuration on 25G Trunk Interfaces

This configuration demonstrates FEC on 25G trunk interfaces with VLAN trunking:

Interface Ethernet1/5 with RS-FEC IEEE
Interface Ethernet1/6 with FC-FEC

vxlan:
  topology:
    switches:
      - name: dc1-leaf1
        interfaces:
          - name: Ethernet1/5
            mode: trunk
            description: '25G Trunk with RS-FEC IEEE'
            speed: 25gb
            fec: rs-ieee
            trunk_allowed_vlans:
              - from: 100
                to: 200
          - name: Ethernet1/6
            mode: trunk
            description: '25G Trunk with FC-FEC'
            speed: 25gb
            fec: fc-fec
            trunk_allowed_vlans:
              - from: 100
                to: 200

Example 3 - Storm Control on Trunk Interfaces

This configuration demonstrates storm control on trunk interfaces:

vxlan:
  topology:
    switches:
      - name: dc1-leaf1
        interfaces:
          - name: Ethernet1/10
            mode: trunk
            description: 'Trunk with percentage-based storm control'
            enable_storm_control: true
            storm_control_action: trap
            storm_control_broadcast_level_percent: 10.00
            storm_control_multicast_level_percent: 10.00
            trunk_allowed_vlans:
              - from: 100
                to: 200

Example

This configuration creates Ethernet1/11, Ethernet1/12 and Ethernet1/13 on switch dc1-leaf1.

Interface Ethernet1/11 is configured with VLANs 10-20, 30, 40-50, MTU set as Jumbo (9216), speed auto and spanning-tree portfast enabled and BPDU guard disabled.
Interface Ethernet1/12 is configured with VLANs 45-48, the rest of the attributes are configured with the default settings.
Interface Ethernet1/13 is configured with all VLANs (1-4904), the rest of the attributes are configured with the default settings.

vxlan:
  topology:
    switches:
      - name: dc1-leaf1
        interfaces:
          - name: Ethernet1/11
            mode: trunk
            description: 'Trunk Interface 1'
            enabled: true
            mtu: jumbo
            speed: auto
            trunk_allowed_vlans:
              - from: 10
                to: 20
              - from: 30
              - from: 40
                to: 50
            spanning_tree_portfast: true
            enable_bpdu_guard: false
          - name: e1/12
            mode: trunk
            speed: 10gb
            trunk_allowed_vlans:
              - from: 45
                to: 48
          - name: e1/13
            mode: trunk
            trunk_allowed_vlans:
              - from: 1
                to: 4094