Interface Bundle Ether

This feature manages Bundle Ethernet (Link Aggregation) interface configuration including bundle interfaces and subinterfaces. Bundle Ether interfaces provide link aggregation capabilities that combine multiple physical interfaces into a single logical interface, delivering increased bandwidth, redundancy, and load distribution across member interfaces using protocols such as LACP (Link Aggregation Control Protocol) or static configuration. They enable seamless failover when individual member links fail while maintaining session continuity, and support both Layer 2 and Layer 3 support.

Diagram

Classes

interfaces (iosxr.devices.configuration)

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

bundle_ethernets (iosxr.devices.configuration.interfaces)

Name	Type	Constraint	Mandatory	Default Value
id	Any	Integer[min: 1] or String[Regex: ^[1-9][0-9]*$] or String[Regex: ^.*[\$\%]\{.*$]	Yes
interface_groups	List	String	No
arp_cache_limit	Integer	min: 0, max: 127999	No
arp_gratuitous_ignore	Boolean	true, false	No
arp_learning	Choice	disable, local	No
arp_timeout	Integer	min: 30, max: 2144448000	No
bandwidth	Integer	min: 0, max: 9223372036854775807	No
bfd	Class	[bfd]	No
bundle_lacp_delay	Integer	min: 1000, max: 15000	No
bundle_lacp_fallback_timeout	Integer	min: 1, max: 120	No
bundle_load_balancing_hash	Choice	src-ip, dst-ip	No
bundle_maximum_active_links	Integer	min: 1, max: 64	No
bundle_minimum_active_links	Integer	min: 1, max: 64	No
bundle_shutdown	Boolean	true, false	No
dampening	Boolean	true, false	No
dampening_decay_half_life	Integer	min: 1, max: 45	No
dampening_max_suppress_time	Integer	min: 1, max: 255	No
dampening_reuse_threshold	Integer	min: 1, max: 20000	No
dampening_suppress_threshold	Integer	min: 1, max: 20000	No
description	String		No
ethernet_cfm	Class	[ethernet_cfm]	No
flow_monitors	Class	[flow_monitors]	No
ipv4	Class	[ipv4]	No
ipv6	Class	[ipv6]	No
l2transport	Class	[l2transport]	No
lacp_churn_logging	Choice	actor, both, partner	No
lacp_cisco_enable	Boolean	true, false	No
lacp_cisco_enable_link_order_signaled	Boolean	true, false	No
lacp_mode	Choice	active, on, passive	No
lacp_non_revertive	Boolean	true, false	No
lacp_period	Any	Integer[min: 2, max: 30000] or Choice[short] or String[Regex: ^.*[\$\%]\{.*$]	No
lacp_switchover_suppress_flaps	Integer	min: 100, max: 65535	No
lacp_system_mac	String		No
lacp_system_priority	Integer	min: 1, max: 65535	No
lldp	Boolean	true, false	No
lldp_receive_disable	Boolean	true, false	No
lldp_transmit_disable	Boolean	true, false	No
load_interval	Integer		No
logging_events_link_status	Boolean	true, false	No
mac_address	String		No
monitor_sessions	List	[monitor_sessions]	No
mpls_mtu	Integer	min: 68, max: 65535	No
mtu	Integer	min: 64, max: 65535	No
multipoint	Boolean	true, false	No
point_to_point	Boolean	true, false	No
proxy_arp	Boolean	true, false	No
ptp	Class	[ptp]	No
service_policy_input	List	[service_policy_input]	No
service_policy_output	List	[service_policy_output]	No
shutdown	Boolean	true, false	No
subinterfaces	List	[subinterfaces]	No
vrf	String		No

bfd (iosxr.devices.configuration.interfaces.bundle_ethernets)

Name	Type	Constraint	Mandatory	Default Value
address_family_ipv4	Class	[address_family_ipv4]	No
address_family_ipv6	Class	[address_family_ipv6]	No
mode	Choice	cisco, ietf	No

ethernet_cfm (iosxr.devices.configuration.interfaces.bundle_ethernets)

Name	Type	Constraint	Mandatory	Default Value
ais_transmission_up_cos	Integer	min: 0, max: 7	No
ais_transmission_up_interval	Choice	1s, 1m	No
bandwidth_notifications	Class	[bandwidth_notifications]	No
mep_domains	List	[mep_domains]	No

flow_monitors (iosxr.devices.configuration.interfaces.bundle_ethernets)

Name	Type	Constraint	Mandatory	Default Value
ipv4	List	[ipv4]	No
ipv6	List	[ipv6]	No

ipv4 (iosxr.devices.configuration.interfaces.bundle_ethernets)

Name	Type	Constraint	Mandatory	Default Value
access_group_egress	Class	[access_group_egress]	No
access_group_ingress	Class	[access_group_ingress]	No
address	IP		No
mask	IP		No
algorithm	Integer	min: 128, max: 255	No
forwarding_enable	Boolean	true, false	No
helper_addresses	List	[helper_addresses]	No
mask_reply	Boolean	true, false	No
mtu	Integer	min: 68, max: 65535	No
point_to_point	Boolean	true, false	No
redirects	Boolean	true, false	No
route_tag	Integer	min: 1, max: 4294967295	No
secondaries	List	[secondaries]	No
tcp_mss_adjust	Boolean	true, false	No
ttl_propagate_disable	Boolean	true, false	No
unnumbered	String		No
unreachables_disable	Boolean	true, false	No
verify_unicast_source_reachable_via_allow_default	Boolean	true, false	No
verify_unicast_source_reachable_via_allow_self_ping	Boolean	true, false	No
verify_unicast_source_reachable_via	Choice	any, rx	No

ipv6 (iosxr.devices.configuration.interfaces.bundle_ethernets)

Name	Type	Constraint	Mandatory	Default Value
access_group_egress	Class	[access_group_egress]	No
access_group_ingress	Class	[access_group_ingress]	No
addresses	List	[addresses]	No
autoconfig	Boolean	true, false	No
dhcp	Boolean	true, false	No
enable	Boolean	true, false	No
eui64_addresses	List	[eui64_addresses]	No
link_local_address	IP		No
link_local_route_tag	Integer	min: 1, max: 4294967295	No
link_local_zone	String		No
mtu	Integer	min: 1280, max: 65535	No
nd_cache_limit	Integer	min: 0, max: 128000	No
nd_dad_attempts	Integer	min: 0, max: 600	No
nd_managed_config_flag	Boolean	true, false	No
nd_ns_interval	Integer	min: 1000, max: 4294967295	No
nd_other_config_flag	Boolean	true, false	No
nd_prefix_default_no_adv	Boolean	true, false	No
nd_prefix_default_no_autoconfig	Boolean	true, false	No
nd_ra_interval_max	Integer	min: 4, max: 1800	No
nd_ra_interval_min	Integer	min: 3, max: 1800	No
nd_ra_lifetime	Integer	min: 0, max: 9000	No
nd_reachable_time	Integer	min: 0, max: 3600000	No
nd_redirects	Boolean	true, false	No
nd_suppress_ra	Boolean	true, false	No
nd_unicast_ra	Boolean	true, false	No
tcp_mss_adjust	Boolean	true, false	No
ttl_propagate_disable	Boolean	true, false	No
unreachables_disable	Boolean	true, false	No
verify_unicast_source_reachable_via_allow_default	Boolean	true, false	No
verify_unicast_source_reachable_via_allow_self_ping	Boolean	true, false	No
verify_unicast_source_reachable_via	Choice	any, rx	No

l2transport (iosxr.devices.configuration.interfaces.bundle_ethernets)

Name	Type	Constraint	Mandatory	Default Value
enable	Boolean	true, false	No

monitor_sessions (iosxr.devices.configuration.interfaces.bundle_ethernets)

Name	Type	Constraint	Mandatory	Default Value
name	String		Yes
direction	Choice	rx-only, tx-only	No
ipv4_acl	String		No
ipv6_acl	String		No
mirror_first	Integer	min: 1, max: 10000	No
mirror_interval	Choice	128, 16, 16K, 1K, 2, 256, 2K, 32, 4, 4K, 512, 64, 8, 8K	No
port_level	Boolean	true, false	No
type	Choice	ethernet, ipv4, ipv6, mpls-ipv4, mpls-ipv6	No

ptp (iosxr.devices.configuration.interfaces.bundle_ethernets)

Name	Type	Constraint	Mandatory	Default Value
enable	Boolean	true, false	No
announce_frequency	Choice	1, 2, 4, 8, 16, 32, 64, 128	No
announce_grant_duration	Integer	min: 60, max: 1000	No
announce_interval	Choice	1, 2, 4, 8, 16, 32, 64, 128	No
announce_timeout	Integer	min: 2, max: 10	No
clock_operation	Choice	one-step, two-step	No
cos	Integer	min: 0, max: 7	No
cos_event	Integer	min: 0, max: 7	No
cos_general	Integer	min: 0, max: 7	No
delay_asymmetry_unit	Choice	nanoseconds, microseconds, milliseconds	No
delay_asymmetry_value	Integer	min: -500000000, max: 500000000	No
delay_request_frequency	Choice	1, 2, 4, 8, 16, 32, 64, 128	No
delay_request_interval	Choice	1, 2, 4, 8, 16, 32, 64, 128	No
delay_response_grant_duration	Integer	min: 60, max: 1000	No
delay_response_timeout	Integer	min: 100, max: 100000	No
dscp	Integer	min: 0, max: 63	No
dscp_event	Integer	min: 0, max: 63	No
dscp_general	Integer	min: 0, max: 63	No
interop	Class	[interop]	No
ipv4_ttl	Integer	min: 1, max: 255	No
ipv6_hop_limit	Integer	min: 1, max: 255	No
local_priority	Integer	min: 1, max: 255	No
masters	List	[masters]	No
multicast	Choice	enable, disable, mixed	No
multicast_target_address	Choice	01-1B-19-00-00-00, 01-80-C2-00-00-0E	No
port_state	Choice	any, master-only, slave-only	No
profile	String		No
slaves	List	[slaves]	No
source_ipv4_address	Any	IP or Choice[disable] or String[Regex: ^.*[\$\%]\{.*$]	No
source_ipv6_address	Any	IP or Choice[disable] or String[Regex: ^.*[\$\%]\{.*$]	No
sync_frequency	Choice	1, 2, 4, 8, 16, 32, 64, 128	No
sync_grant_duration	Integer	min: 60, max: 1000	No
sync_interval	Choice	1, 2, 4, 8, 16, 32, 64, 128	No
sync_timeout	Integer	min: 100, max: 100000	No
transport	Choice	ethernet, ipv4, ipv6	No
unicast_grant_invalid_request	Choice	deny, reduce	No

service_policy_input (iosxr.devices.configuration.interfaces.bundle_ethernets)

Name	Type	Constraint	Mandatory	Default Value
name	String		No

subinterfaces (iosxr.devices.configuration.interfaces.bundle_ethernets)

Name	Type	Constraint	Mandatory	Default Value
id	String	Regex: ^[1-9][0-9]*\.[0-9]+$	Yes
interface_groups	List	String	No
arp_cache_limit	Integer	min: 0, max: 127999	No
arp_gratuitous_ignore	Boolean	true, false	No
arp_learning	Choice	disable, local	No
arp_timeout	Integer	min: 30, max: 2144448000	No
bandwidth	Integer	min: 0, max: 9223372036854775807	No
dampening	Boolean	true, false	No
dampening_decay_half_life	Integer	min: 1, max: 45	No
dampening_max_suppress_time	Integer	min: 1, max: 255	No
dampening_reuse_threshold	Integer	min: 1, max: 20000	No
dampening_suppress_threshold	Integer	min: 1, max: 20000	No
description	String		No
encapsulation_dot1q_vlan	Integer	min: 1, max: 4094	No
encapsulation_dot1q_second_dot1q	Integer	min: 1, max: 4094	No
ethernet_cfm	Class	[ethernet_cfm]	No
flow_monitors	Class	[flow_monitors]	No
ipv4	Class	[ipv4]	No
ipv6	Class	[ipv6]	No
l2transport	Class	[l2transport]	No
lldp	Boolean	true, false	No
lldp_receive_disable	Boolean	true, false	No
lldp_transmit_disable	Boolean	true, false	No
load_interval	Integer		No
logging_events_link_status	Boolean	true, false	No
monitor_sessions	List	[monitor_sessions]	No
mpls_mtu	Integer	min: 68, max: 65535	No
mtu	Integer	min: 64, max: 65535	No
multipoint	Boolean	true, false	No
point_to_point	Boolean	true, false	No
proxy_arp	Boolean	true, false	No
ptp	Class	[ptp]	No
rewrite_ingress_tag_pop_one	Boolean	true, false	No
rewrite_ingress_tag_pop_two	Boolean	true, false	No
service_policy_input	List	[service_policy_input]	No
service_policy_output	List	[service_policy_output]	No
shutdown	Boolean	true, false	No
vrf	String		No

address_family_ipv4 (iosxr.devices.configuration.interfaces.bundle_ethernets.bfd)

Name	Type	Constraint	Mandatory	Default Value
destination	String		No
echo_minimum_interval	Integer		No
fast_detect	Boolean	true, false	No
minimum_interval	Integer		No
multiplier	Integer		No
timers_nbr_unconfig	Integer		No
timers_start	Integer		No

address_family_ipv6 (iosxr.devices.configuration.interfaces.bundle_ethernets.bfd)

Name	Type	Constraint	Mandatory	Default Value
destination	String		No
fast_detect	Boolean	true, false	No
minimum_interval	Integer		No
multiplier	Integer		No
timers_nbr_unconfig	Integer		No
timers_start	Integer		No

bandwidth_notifications (iosxr.devices.configuration.interfaces.bundle_ethernets.ethernet_cfm)

Name	Type	Constraint	Mandatory	Default Value
hold_off	Integer	min: 0, max: 600	No
log_changes	Boolean	true, false	No
loss_threshold	Integer	min: 2, max: 255	No
wait_to_restore	Integer	min: 0, max: 600	No

mep_domains (iosxr.devices.configuration.interfaces.bundle_ethernets.ethernet_cfm)

Name	Type	Constraint	Mandatory	Default Value
cos	Integer		No
domain	String		Yes
loss_measurement_counters	Class	[loss_measurement_counters]	No
mep_id	Integer		Yes
propagate_remote_status	Boolean	true, false	No
service	String		Yes
sla_operation_profiles	List	[sla_operation_profiles]	No

ipv4 (iosxr.devices.configuration.interfaces.bundle_ethernets.flow_monitors)

Name	Type	Constraint	Mandatory	Default Value
monitor_map	String		Yes
sampler_map	String		No
direction	Choice	ingress, egress	Yes

access_group_egress (iosxr.devices.configuration.interfaces.bundle_ethernets.ipv4)

Name	Type	Constraint	Mandatory	Default Value
acl	String		No
compress	Integer		No
hardware_count	Boolean	true, false	No
interface_statistics	Boolean	true, false	No

helper_addresses (iosxr.devices.configuration.interfaces.bundle_ethernets.ipv4)

Name	Type	Constraint	Mandatory	Default Value
address	IP		Yes
vrf	String		Yes

secondaries (iosxr.devices.configuration.interfaces.bundle_ethernets.ipv4)

Name	Type	Constraint	Mandatory	Default Value
address	IP		Yes
mask	IP		Yes
algorithm	Integer	min: 128, max: 255	No
route_tag	Integer	min: 1, max: 4294967295	No

access_group_egress (iosxr.devices.configuration.interfaces.bundle_ethernets.ipv6)

Name	Type	Constraint	Mandatory	Default Value
acl	String		No
compress	Integer		No
interface_statistics	Boolean	true, false	No

addresses (iosxr.devices.configuration.interfaces.bundle_ethernets.ipv6)

Name	Type	Constraint	Mandatory	Default Value
address	IP		Yes
length	Integer	min: 0, max: 128	Yes
algorithm	Integer	min: 128, max: 255	No
route_tag	Integer	min: 1, max: 4294967295	No
zone	String		No

eui64_addresses (iosxr.devices.configuration.interfaces.bundle_ethernets.ipv6)

Name	Type	Constraint	Mandatory	Default Value
address	IP		Yes
length	Integer	min: 0, max: 128	Yes
algorithm	Integer	min: 128, max: 255	No
route_tag	Integer	min: 1, max: 4294967295	No
zone	String		No

interop (iosxr.devices.configuration.interfaces.bundle_ethernets.ptp)

Name	Type	Constraint	Mandatory	Default Value
domain	Integer	min: 0, max: 255	No
egress_conversion	Class	[egress_conversion]	No
ingress_conversion	Class	[ingress_conversion]	No
profile	Choice	default, g-8265-1, g-8275-1, g-8275-2	No

masters (iosxr.devices.configuration.interfaces.bundle_ethernets.ptp)

Name	Type	Constraint	Mandatory	Default Value
address	String		Yes
clock_class	Integer	min: 0, max: 255	No
delay_asymmetry_unit	Choice	nanoseconds, microseconds, milliseconds	No
delay_asymmetry_value	Integer	min: -500000000, max: 500000000	No
multicast	Choice	enable, mixed	No
non_negotiated	Boolean	true, false	No
priority	Integer	min: 0, max: 255	No

slaves (iosxr.devices.configuration.interfaces.bundle_ethernets.ptp)

Name	Type	Constraint	Mandatory	Default Value
address	String		Yes
non_negotiated	Boolean	true, false	Yes

l2transport (iosxr.devices.configuration.interfaces.bundle_ethernets.subinterfaces)

Name	Type	Constraint	Mandatory	Default Value
enable	Boolean	true, false	No
encapsulation_dot1q_second_dot1q	Integer	min: 1, max: 4094	No
encapsulation_dot1q_vlan	Integer	min: 1, max: 4094	No

loss_measurement_counters (iosxr.devices.configuration.interfaces.bundle_ethernets.ethernet_cfm.mep_domains)

Name	Type	Constraint	Mandatory	Default Value
aggregate	Boolean	true, false	No
priority_cos_range_from	Integer	min: 0, max: 7	No
priority_cos_range_to	Integer	min: 0, max: 7	No
priority_cos_values	List	Integer[min: 0, max: 7]	No

sla_operation_profiles (iosxr.devices.configuration.interfaces.bundle_ethernets.ethernet_cfm.mep_domains)

Name	Type	Constraint	Mandatory	Default Value
mac_address	String		No
mep_id	Integer		No
profile	String		Yes

egress_conversion (iosxr.devices.configuration.interfaces.bundle_ethernets.ptp.interop)

Name	Type	Constraint	Mandatory	Default Value
clock_accuracy	Integer	min: 0, max: 254	No
clock_class_default	Integer	min: 0, max: 255	No
clock_class_mappings	List	[clock_class_mappings]	No
offset_scaled_log_variance	Integer	min: 0, max: 65535	No
priority1	Integer	min: 0, max: 255	No
priority2	Integer	min: 0, max: 255	No

clock_class_mappings (iosxr.devices.configuration.interfaces.bundle_ethernets.ptp.interop.egress_conversion)

Name	Type	Constraint	Mandatory	Default Value
class_from	Integer	min: 0, max: 255	Yes
class_to	Integer	min: 0, max: 255	Yes

Guidelines and Limitations

Data Normalization

MAC Address Formats

Interface fields accept MAC addresses in any of three formats:

1. colon-separated (e.g., "01:01:01:01:01:01")
2. dash-separated (e.g., "01-01-01-01-01-01")
3. dotted (e.g., "0101.0101.0101")

All 3 formats can be used interchangeably. The normalization layer coverts the user-specified format to colon-separated before sending to the device.

Examples

Example 1: Basic Bundle Ethernet Interface

iosxr:
  devices:
    - name: router-1
      host: 10.10.10.1:57400
      configuration:
        hostname: router-1
        interfaces:
          bundle_ethernets:
            - id: 10
              description: "LAG to Core"
              shutdown: false
              mtu: 9000
              ipv4:
                address: 192.168.10.1
                mask: 255.255.255.0

Example 2: Bundle Ethernet with Subinterfaces

iosxr:
  devices:
    - name: router-1
      host: 10.10.10.1:57400
      configuration:
        hostname: router-1
        interfaces:
          bundle_ethernets:
            - id: 20
              description: "LAG Trunk"
              shutdown: false
              subinterfaces:
                - id: "20.100"
                  description: "VLAN 100"
                  encapsulation_dot1q_vlan: 100
                  ipv4:
                    address: 10.100.1.1
                    mask: 255.255.255.0
                  vrf: CUSTOMER_A
                - id: "20.200"
                  description: "VLAN 200"
                  encapsulation_dot1q_vlan: 200
                  ipv4:
                    address: 10.200.1.1
                    mask: 255.255.255.0
                  vrf: CUSTOMER_B

Example 3: Advanced Bundle Configuration

iosxr:
  devices:
    - name: router-1
      host: 10.10.10.1:57400
      configuration:
        hostname: router-1
        interfaces:
          ethernets:
            - type: TenGigE
              id: 0/0/0/1
              description: "Member of Bundle-Ether30"
              shutdown: false
              bundle_id: 30
              bundle_mode: active
            - type: TenGigE
              id: 0/0/0/2
              description: "Member of Bundle-Ether30"
              shutdown: false
              bundle_id: 30
              bundle_mode: active
          bundle_ethernets:
            - id: 30
              description: "LACP Bundle"
              shutdown: false
              bandwidth: 20000000
              mtu: 9000
              load_interval: 30
              ipv4:
                address: 10.30.1.1
                mask: 255.255.255.0
              ipv6:
                enable: true
                addresses:
                  - address: 2001:db8:30::1
                    length: 64
              service_policy_input:
                - name: QOS_IN
              service_policy_output:
                - name: QOS_OUT

Example 4: Bundle Ethernet with BFD

iosxr:
  devices:
    - name: router-1
      host: 10.10.10.1:57400
      configuration:
        hostname: router-1
        interfaces:
          bundle_ethernets:
            - id: 40
              description: "LAG with BFD"
              shutdown: false
              bfd:
                mode: ietf
                address_family_ipv4:
                  destination: 10.0.0.2
                  fast_detect: true
                  minimum_interval: 300
                  multiplier: 3
                address_family_ipv6:
                  destination: "2001:db8::2"
                  fast_detect: true
                  minimum_interval: 300
                  multiplier: 3
              ipv4:
                address: 10.40.1.1
                mask: 255.255.255.0