Skip to main content

Iface

Fields

nametypenullabledescription
nameStringfalseThe name of the interface.
interfaceTypeIfaceTypefalseThe type of the interface.
layerLayerfalseDenotes whether this is a Layer 2 (physical) or Layer 3 (logical) interface.
mtuIntegertrueThe max transmission unit size in octets for the physical interface. Note that this is the L2 MTU, which is normalized to include the length of the L2 payload, but not the L2 header and trailers (such as the MAC source and destination, Ethernet type, or VLAN headers). Some vendors include the length of the L2 header when reporting the L2 MTU, and as a result the MTU value reported by the device will differ from the value reported here. For example, Cisco IOS-XR includes L2 headers. An interface that reports a 1514 byte MTU on IOS-XR is normalized to 1500 after subtracting 14 bytes of L2 headers.
loopbackModeBoolfalseWhen set to true, the interface is logically looped back, such that packets that are forwarded via the interface are received on the same interface.
aliasesList<String>falseThe set of all names that refer to this interface. For example, on Cisco, an interface named "eth1" might also be referred to as "Ethernet1". This field would then include both "eth1" and "Ethernet1".
descriptionStringtrueA textual description of the interface.
adminStatusAdminStatusfalseThe desired state of the interface. Here, it reflects the administrative state as set by enabling or disabling the interface.
operStatusOperStatusfalseThe current operational state of the interface.
subinterfacesList<SubInterface>falseThe list of subinterfaces (logical interfaces) associated with a physical interface.
ethernetEthernetfalseEthernet-specific configuration and state of the interface.
aclsIfaceAclsfalseAccess control list details specific to this interface.
routedVlanRoutedVlantrueNon-null when the interface is a logical interface providing L3 routing for VLANs.
bridgeBridgetrueNon-null when the interface is a bridge (BVI, BDI, etc.)
aggregationAggregationtrueNon-null when the interface is set to type IF_AGGREGATE.
tunnelTunneltrueIn the case that the interface is logical tunnel interface, the parameters for the tunnel are specified within this subtree.
teTunnelTeTunneltrueIn the case that the interface is a logical Traffic Engineering (TE) tunnel interface, the parameters for the TE tunnel are specified within this subtree.
linksList<PhysicalLink>falseThe other interfaces that this interface connects to.
cdpDeviceDiscoveryIfaceInfofalse--
lldpDeviceDiscoveryIfaceInfofalse--

Used by

network → devices → interfaces

See also

Data model path