Interfaces

Module for working with interfaces in EOS

This module provides an API for pragmatically working with EOS interface configurations. Interfaces include any data or management plane interface available in EOS.

param name:The name of the interface the configuration should be applied to. The interface name is the full interface identifier.
type name:string
param shutdown:True if the interface is administratively disabled, and False if the interface is administratively enable. This value does not validate the interfaces operational state.
type shutdown:boolean
param description:
 The interface description string. This value is an arbitrary operator defined value.
type description:
 string
param sflow:True if sFlow is enabled on the interface otherwise False
type sflow:boolean
param flowcontrol_send:
 The flowcontrol send configuration value for the interface. Valid values are on or off
type flowcontrol_send:
 string
param flowcontrol_receive:
 The flowcontrol receive configuration value for the interface. Valid values are on or off
type flowcontrol_receive:
 string
class pyeapi.api.interfaces.BaseInterface(node)

Bases: pyeapi.api.abstract.EntityCollection

create(name)

Creates a new interface on the node

Note

This method will attempt to create the interface regardless if the interface exists or not. If the interface already exists then this method will still return True

Parameters:name (string) – The full name of the interface.
Returns:True if the interface could be created otherwise False (see Note)
default(name)

Defaults an interface in the running configuration

Parameters:name (string) – The full name of the interface
Returns:True if the command operation succeeds otherwise False
delete(name)

Deletes the interface from the node

Note

This method will attempt to delete the interface from the nodes operational config. If the interface does not exist then this method will not perform any changes but still return True

Parameters:name (string) – The full name of the interface
Returns:True if the interface could be deleted otherwise False (see Node)
get(name)

Returns a generic interface as a set of key/value pairs

This class is should normally serve as a base class for building more specific interface resources. The attributes of this resource are common to all interfaces regardless of type in EOS.

The generic interface resource returns the following:

  • name (str): The name of the interface
  • type (str): Always returns ‘generic’
  • shutdown (bool): True if the interface is shutdown
  • description (str): The interface description value
Parameters:name (str) – The interface identifier to retrieve from the running-configuration
Returns:
A Python dictionary object of key/value pairs that represents
the interface configuration. If the specified interface does not exist, then None is returned
set_description(name, value=None, default=False, disable=False)

Configures the interface description

EosVersion:
4.13.7M
Parameters:
  • name (string) – The interface identifier. It must be a full interface name (ie Ethernet, not Et)
  • value (string) – The value to set the description to.
  • default (boolean) – Specifies to default the interface description
  • disable (boolean) – Specifies to negate the interface description
Returns:

True if the operation succeeds otherwise False

set_encapsulation(name, vid, default=False, disable=False)

Configures the subinterface encapsulation value

Parameters:
  • name (string) – The interface identifier. It must be a full interface name (ie Ethernet, not Et)
  • vid (int) – The vlan id number
  • default (boolean) – Specifies to default the subinterface encapsulation
  • disable (boolean) – Specifies to disable the subinterface encapsulation
Returns:

True if the operation succeeds otherwise False is returned

set_shutdown(name, default=False, disable=True)

Configures the interface shutdown state

Default configuration for set_shutdown is disable=True, meaning ‘no shutdown’. Setting both default and disable to False will effectively enable shutdown on the interface.

Parameters:
  • name (string) – The interface identifier. It must be a full interface name (ie Ethernet, not Et)
  • default (boolean) – Specifies to default the interface shutdown
  • disable (boolean) – Specifies to disable interface shutdown, i.e. disable=True => no shutdown
Returns:

True if the operation succeeds otherwise False is returned

class pyeapi.api.interfaces.EthernetInterface(node)

Bases: pyeapi.api.interfaces.BaseInterface

create(name)

Create an Ethernet subinterface

Parameters:

name (string) – The subinterface name. Ex: Ethernet1.1

Raises:
  • NotImplementedError – creating physical Ethernet interfaces is not
  • supported. Only subinterfaces can be created.
delete(name)

Delete an Ethernet subinterfaces

Parameters:

name (string) – The subinterface name. Ex: Ethernet1.1

Raises:
  • NotImplementedError – creating physical Ethernet interfaces is not
  • supported. Only subinterfaces can be created.
get(name)

Returns an interface as a set of key/value pairs

Parameters:name (string) – the interface identifier to retrieve the from the configuration
Returns:A Python dictionary object of key/value pairs that represent the current configuration for the specified node. If the specified interface name does not exist, then None is returned:
{
    "name": <string>,
    "type": "ethernet",
    "sflow": [true, false],
    "flowcontrol_send": [on, off],
    "flowcontrol_receive": [on, off]
}
set_flowcontrol(name, direction, value=None, default=False, disable=False)

Configures the interface flowcontrol value

Parameters:
  • name (string) – The interface identifier. It must be a full interface name (ie Ethernet, not Et)
  • direction (string) – one of either ‘send’ or ‘receive’
  • value (boolean) – True if the interface should enable flow control packet handling, otherwise False
  • default (boolean) – Specifies to default the interface flow control send or receive value
  • disable (boolean) – Specifies to disable the interface flow control send or receive value
Returns:

True if the operation succeeds otherwise False is returned

set_flowcontrol_receive(name, value=None, default=False, disable=False)

Configures the interface flowcontrol receive value

Parameters:
  • name (string) – The interface identifier. It must be a full interface name (ie Ethernet, not Et)
  • value (boolean) – True if the interface should enable receiving flow control packets, otherwise False
  • default (boolean) – Specifies to default the interface flow control receive value
  • disable (boolean) – Specifies to disable the interface flow control receive value
Returns:

True if the operation succeeds otherwise False is returned

set_flowcontrol_send(name, value=None, default=False, disable=False)

Configures the interface flowcontrol send value

Parameters:
  • name (string) – The interface identifier. It must be a full interface name (ie Ethernet, not Et)
  • value (boolean) – True if the interface should enable sending flow control packets, otherwise False
  • default (boolean) – Specifies to default the interface flow control send value
  • disable (boolean) – Specifies to disable the interface flow control send value
Returns:

True if the operation succeeds otherwise False is returned

set_sflow(name, value=None, default=False, disable=False)

Configures the sFlow state on the interface

Parameters:
  • name (string) – The interface identifier. It must be a full interface name (ie Ethernet, not Et)
  • value (boolean) – True if sFlow should be enabled otherwise False
  • default (boolean) – Specifies the default value for sFlow
  • disable (boolean) – Specifies to disable sFlow
Returns:

True if the operation succeeds otherwise False is returned

set_vrf(name, vrf, default=False, disable=False)

Applies a VRF to the interface

Note: VRF being applied to interface must already exist in switch
config. Ethernet port must be in routed mode. This functionality can also be handled in the VRF api.
Parameters:
  • name (str) – The interface identifier. It must be a full interface name (ie Ethernet, not Et)
  • vrf (str) – The vrf name to be applied to the interface
  • default (bool) – Specifies the default value for VRF
  • disable (bool) – Specifies to disable VRF
Returns:

True if the operation succeeds otherwise False is returned

class pyeapi.api.interfaces.Interfaces(node, *args, **kwargs)

Bases: pyeapi.api.abstract.EntityCollection

get(name)
get_instance(interface)
getall()

Returns all interfaces in a dict object.

Returns:A Python dictionary object containing all interface configuration indexed by interface name:
{
    "Ethernet1": {...},
    "Ethernet2": {...}
}
marshall(name, *args, **kwargs)
class pyeapi.api.interfaces.PortchannelInterface(node)

Bases: pyeapi.api.interfaces.BaseInterface

get(name)

Returns a Port-Channel interface as a set of key/value pairs

Parameters:name (str) – The interface identifier to retrieve from the running-configuration
Returns:A Python dictionary object of key/value pairs that represents the interface configuration. If the specified interface does not exist, then None is returned:
{
    "name": <string>,
    "type": "portchannel",
    "members": <arrary of interface names>,
    "minimum_links: <integer>,
    "lacp_mode": [on, active, passive]
}
get_lacp_mode(name)

Returns the LACP mode for the specified Port-Channel interface

Parameters:name (str) – The Port-Channel interface name to return the LACP mode for from the configuration
Returns:
The configured LACP mode for the interface. Valid mode values
are ‘on’, ‘passive’, ‘active’
get_members(name)

Returns the member interfaces for the specified Port-Channel

Parameters:name (str) – The Port-channel interface name to return the member interfaces for
Returns:
A list of physical interface names that belong to the specified
interface
set_lacp_fallback(name, mode=None)

Configures the Port-Channel lacp_fallback

Parameters:
  • name (str) – The Port-Channel interface name
  • mode (str) –

    The Port-Channel LACP fallback setting Valid values are ‘disabled’, ‘static’, ‘individual’:

    • static - Fallback to static LAG mode
    • individual - Fallback to individual ports
    • disabled - Disable LACP fallback
Returns:

True if the operation succeeds otherwise False is returned

set_lacp_mode(name, mode)

Configures the LACP mode of the member interfaces

Parameters:
  • name (str) – The Port-Channel interface name to configure the LACP mode
  • mode (str) – The LACP mode to configure the member interfaces to. Valid values are ‘on, ‘passive’, ‘active’
Returns:

True if the operation succeeds otherwise False

set_lacp_timeout(name, value=None)
Configures the Port-Channel LACP fallback timeout
The fallback timeout configures the period an interface in fallback mode remains in LACP mode without receiving a PDU.
Parameters:
  • name (str) – The Port-Channel interface name
  • value (int) – port-channel lacp fallback timeout in seconds
Returns:

True if the operation succeeds otherwise False is returned

set_members(name, members, mode=None)

Configures the array of member interfaces for the Port-Channel

Parameters:
  • name (str) – The Port-Channel interface name to configure the member interfaces
  • members (list) – The list of Ethernet interfaces that should be member interfaces
  • mode (str) – The LACP mode to configure the member interfaces to. Valid values are ‘on, ‘passive’, ‘active’. When there are existing channel-group members and their lacp mode differs from this attribute, all of those members will be removed and then re-added using the specified lacp mode. If this attribute is omitted, the existing lacp mode will be used for new member additions.
Returns:

True if the operation succeeds otherwise False

Configures the Port-Channel min-links value

Parameters:
  • name (str) – The Port-Channel interface name
  • value (str) – The value to configure the min-links
  • default (bool) – Specifies to default the port channel min-links value
  • disable (bool) – Specifies to disable the port channel min-links value
Returns:

True if the operation succeeds otherwise False is returned

class pyeapi.api.interfaces.VxlanInterface(node)

Bases: pyeapi.api.interfaces.BaseInterface

DEFAULT_MCAST_GRP = ''
DEFAULT_SRC_INTF = ''
add_vtep(name, vtep, vlan=None)

Adds a new VTEP endpoint to the global or local flood list

EosVersion:
4.13.7M
Parameters:
  • name (str) – The name of the interface to configure
  • vtep (str) – The IP address of the remote VTEP endpoint to add
  • vlan (str) – The VLAN ID associated with this VTEP. If the VLAN
  • is used, then the VTEP is configured as a local flood (keyword) –
  • endpoing
Returns:

True if the command completes successfully

get(name)

Returns a Vxlan interface as a set of key/value pairs

The Vxlan interface resource returns the following:

  • name (str): The name of the interface
  • type (str): Always returns ‘vxlan’
  • source_interface (str): The vxlan source-interface value
  • multicast_group (str): The vxlan multicast-group value
  • udp_port (int): The vxlan udp-port value
  • vlans (dict): The vlan to vni mappings
  • flood_list (list): The list of global VTEP flood list
  • multicast_decap (bool): If the mutlicast decap
    feature is configured
Parameters:name (str) – The interface identifier to retrieve from the running-configuration
Returns:
A Python dictionary object of key/value pairs that represents
the interface configuration. If the specified interface does not exist, then None is returned
remove_vlan(name, vid)

Removes a vlan to vni mapping for the interface

EosVersion:
4.13.7M
Parameters:vlan (str, int) – The vlan id to map to the vni
Returns:True if the command completes successfully
remove_vtep(name, vtep, vlan=None)

Removes a VTEP endpoint from the global or local flood list

EosVersion:
4.13.7M
Parameters:
  • name (str) – The name of the interface to configure
  • vtep (str) – The IP address of the remote VTEP endpoint to add
  • vlan (str) – The VLAN ID associated with this VTEP. If the VLAN
  • is used, then the VTEP is configured as a local flood (keyword) –
  • endpoing
Returns:

True if the command completes successfully

set_multicast_decap(name, default=False, disable=False)

Configures the Vxlan multicast-group decap feature

EosVersion:
4.15.0M
Parameters:name – The interface identifier to configure, defaults to Vxlan1
Returns:True if the operation succeeds otherwise False
set_multicast_group(name, value=None, default=False, disable=False)

Configures the Vxlan multicast-group value

EosVersion:
4.13.7M
Parameters:name – The interface identifier to configure, defaults to Vxlan1
Returns:True if the operation succeeds otherwise False
set_source_interface(name, value=None, default=False, disable=False)

Configures the Vxlan source-interface value

EosVersion:
4.13.7M
Parameters:name – The interface identifier to configure, defaults to Vxlan1
Returns:True if the operation succeeds otherwise False
set_udp_port(name, value=None, default=False, disable=False)

Configures vxlan udp-port value

EosVersion:
4.13.7M
Parameters:
  • name (str) – The name of the interface to configure
  • value (str) – The value to set udp-port to
  • default (bool) – Configure using the default keyword
  • disable (bool) – Negate the udp-port value
Returns:

True if the operation succeeds otherwise False

update_vlan(name, vid, vni)

Adds a new vlan to vni mapping for the interface

EosVersion:
4.13.7M
Parameters:
  • vlan (str, int) – The vlan id to map to the vni
  • vni (str, int) – The vni value to use
Returns:

True if the command completes successfully

pyeapi.api.interfaces.instance(api)
pyeapi.api.interfaces.isvalidinterface(value)