Interface BVI

This feature manages Bridge Virtual Interface (BVI) interface configuration.

Diagram

Classes

interfaces (iosxr.devices.configuration)

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

bvis (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_timeout	Integer	min: 30, max: 2144448000	No
arp_learning	Choice	disable, local	No
arp_gratuitous_ignore	Boolean	true, false	No
arp_cache_limit	Integer	min: 0, max: 127999	No
bandwidth	Integer	min: 0, max: 9223372036854775807	No
dampening	Boolean	true, false	No
dampening_decay_half_life	Integer	min: 1, max: 45	No
dampening_reuse_threshold	Integer	min: 1, max: 20000	No
dampening_suppress_threshold	Integer	min: 1, max: 20000	No
dampening_max_suppress_time	Integer	min: 1, max: 255	No
description	String		No
host_routing	Boolean	true, false	No
ipv4	Class	[ipv4]	No
ipv6	Class	[ipv6]	No
load_interval	Integer		No
logging_events_link_status	Boolean	true, false	No
mac_address	String		No
monitor_sessions	List	[monitor_sessions]	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
vrf	String		No

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

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.bvis)

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

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

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.bvis)

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.bvis)

Name	Type	Constraint	Mandatory	Default Value
name	String		No

access_group_egress (iosxr.devices.configuration.interfaces.bvis.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.bvis.ipv4)

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

secondaries (iosxr.devices.configuration.interfaces.bvis.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.bvis.ipv6)

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

addresses (iosxr.devices.configuration.interfaces.bvis.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.bvis.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.bvis.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.bvis.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.bvis.ptp)

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

egress_conversion (iosxr.devices.configuration.interfaces.bvis.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.bvis.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 BVI Interface

iosxr:
  devices:
    - name: router-1
      host: 10.10.10.1:57400
      configuration:
        hostname: router-1
        interfaces:
          bvis:
            - id: 100
              description: "BVI 100 Gateway"
              shutdown: false
              ipv4:
                address: 192.168.100.1
                mask: 255.255.255.0

Example 2: BVI with IPv6

iosxr:
  devices:
    - name: router-1
      host: 10.10.10.1:57400
      configuration:
        hostname: router-1
        interfaces:
          bvis:
            - id: 200
              description: "Dual Stack BVI"
              shutdown: false
              mtu: 9000
              ipv4:
                address: 10.200.1.1
                mask: 255.255.255.0
              ipv6:
                enable: true
                addresses:
                  - address: 2001:db8:200::1
                    length: 64

Example 3: BVI with Advanced Features

iosxr:
  devices:
    - name: router-1
      host: 10.10.10.1:57400
      configuration:
        hostname: router-1
        interfaces:
          bvis:
            - id: 300
              shutdown: false
              bandwidth: 1000000
              mtu: 9000
              vrf: ENTERPRISE
              ipv4:
                address: 172.16.30.1
                mask: 255.255.255.0
                helper_addresses:
                  - address: 10.1.1.10
                    vrf: default
                access_group_ingress:
                  acl: ACL_IN
                access_group_egress:
                  acl: ACL_OUT
              service_policy_input:
                - name: QOS_IN
              service_policy_output:
                - name: QOS_OUT