BDI

Bridge Domain Interfaces (BDI) provide Layer 3 routing capability for bridge domains, acting as the routed interface (SVI equivalent) for VXLAN or other bridging constructs. They support IP addressing, MAC address configuration, and zone-based firewall membership. BDI interfaces are essential for VXLAN fabrics where Layer 3 gateway functionality is needed for bridge domain traffic, providing a stable routed endpoint that connects overlay bridge domains to the underlay routing infrastructure.

Diagram

Classes

iosxe

Name	Type	Constraint	Mandatory	Default Value
devices	List	devices	No
device_groups	List	device_groups	No
global	Class	global	No

devices (iosxe)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

device_groups (iosxe)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

global (iosxe)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

configuration (iosxe.devices)

Name	Type	Constraint	Mandatory	Default Value
interfaces	Class	interfaces	No

interfaces (iosxe.devices.configuration)

Name	Type	Constraint	Mandatory	Default Value
bdis	List	bdis	No

bdis (iosxe.devices.configuration.interfaces)

Name	Type	Constraint	Mandatory	Default Value
id	Integer		Yes
mac_address	Any	MAC or String[Regex: ^[0-9a-fA-F]{4}\.[0-9a-fA-F]{4}\.[0-9a-fA-F]{4}$] or String[Regex: ^.*[\$\%]\{.*$]	No
ip_mtu	Integer	min: 68, max: 18000	No

Examples

BDI with Custom IP MTU

BDI interfaces are L3 constructs and use ip mtu (L3 packet size) rather than the interface-level mtu (L2 frame size) used by physical and Port-Channel interfaces.

Cisco IOS-XE CLI Equivalent:

interface BDI100
 mac-address 0000.11AA.22BB
 ip mtu 1400

NAC YAML Configuration:

iosxe:
  devices:
    - name: Device1
      configuration:
        interfaces:
          bdis:
            - id: 100
              mac_address: 0000.11AA.22BB
              ip_mtu: 1400