Interface¶
Keys
Leafs
admin_status
higher_layer_if
if_index
last_change
lower_layer_if
oper_status
phys_address
routing_instance
speed
type
Children
Enum Classes
-
class
InterfacesState.
Interface
¶ Bases:
Entity
Class Hierarchy:
InterfacesState
Interface
This class represents state data.
The list of interfaces on the device.
System-controlled interfaces created by the system are
always present in this list, whether they are configured or
not.
-
name
(key)¶ The name of the interface. A server implementation MAY map this leaf to the ifName MIB object. Such an implementation needs to use some mechanism to handle the differences in size and characters allowed between this leaf and ifName. The definition of such a mechanism is outside the scope of this document
type: str
config: False
-
type
¶ The type of the interface
type: one of the below values:
IanaInterfaceType
mandatory: True
config: False
-
admin_status
¶ The desired state of the interface. This leaf has the same read semantics as ifAdminStatus
type:
AdminStatus
mandatory: True
config: False
-
oper_status
¶ The current operational state of the interface. This leaf has the same semantics as ifOperStatus
type:
OperStatus
mandatory: True
config: False
-
last_change
¶ The time the interface entered its current operational state. If the current state was entered prior to the last re-initialization of the local network management subsystem, then this node is not present
type: str
pattern: \d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[\+\-]\d{2}:\d{2})config: False
-
if_index
¶ The ifIndex value for the ifEntry represented by this interface
type: int
range: 1..2147483647mandatory: True
config: False
-
phys_address
¶ The interface’s address at its protocol sub-layer. For example, for an 802.x interface, this object normally contains a Media Access Control (MAC) address. The interface’s media-specific modules must define the bit and byte ordering and the format of the value of this object. For interfaces that do not have such an address (e.g., a serial line), this node is not present
type: str
pattern: ([0-9a-fA-F]{2}(:[0-9a-fA-F]{2})*)?config: False
-
higher_layer_if
¶ A list of references to interfaces layered on top of this interface
type: list of str
refers to:
name
config: False
-
lower_layer_if
¶ A list of references to interfaces layered underneath this interface
type: list of str
refers to:
name
config: False
-
speed
¶ An estimate of the interface’s current bandwidth in bits per second. For interfaces that do not vary in bandwidth or for those where no accurate estimation can be made, this node should contain the nominal bandwidth. For interfaces that have no concept of bandwidth, this node is not present
type: int
range: 0..18446744073709551615config: False
units: bits/second
-
statistics
¶ A collection of interface-related statistics objects
type:
Statistics
config: False
-
diffserv_target_entry
¶ policy target for inbound or outbound direction
type: list of
DiffservTargetEntry
config: False
-
ipv4
¶ Interface-specific parameters for the IPv4 address family
type:
Ipv4
presence node: True
config: False
-
routing_instance
¶ The name of the routing instance to which the interface is assigned
type: str
config: False
-