slxos_interface – Manage Interfaces on Extreme SLX-OS network devices
New in version 2.6.
Synopsis
- This module provides declarative management of Interfaces on Extreme SLX-OS network devices.
Parameters
Parameter | Choices/Defaults | Comments | |
---|---|---|---|
aggregate
-
|
List of Interfaces definitions.
|
||
delay
-
|
Default:
10
|
Time in seconds to wait before checking for the operational state on remote device. This wait is applicable for operational state argument which are
state with values
up /
down ,
tx_rate and
rx_rate.
|
|
description
-
|
Description of Interface.
|
||
enabled
boolean
|
|
Interface link status.
|
|
mtu
-
|
Maximum size of transmit packet.
|
||
name
- /
required
|
Name of the Interface.
|
||
neighbors
-
|
Check the operational state of given interface
name for LLDP neighbor.
The following suboptions are available.
|
||
host
-
|
LLDP neighbor host for given interface
name .
|
||
port
-
|
LLDP neighbor port to which given interface
name is connected.
|
||
rx_rate
-
|
Receiver rate in bits per second (bps).
|
||
speed
-
|
Interface link speed.
|
||
state
-
|
|
State of the Interface configuration,
up means present and operationally up and
down means present and operationally
down
|
|
tx_rate
-
|
Transmit rate in bits per second (bps).
|
Notes
Note
- Tested against SLX-OS 17s.1.02
Examples
- name: configure interface slxos_interface: name: Ethernet 0/2 description: test-interface speed: 1000 mtu: 9216 - name: remove interface slxos_interface: name: Loopback 9 state: absent - name: make interface up slxos_interface: name: Ethernet 0/2 enabled: True - name: make interface down slxos_interface: name: Ethernet 0/2 enabled: False - name: Check intent arguments slxos_interface: name: Ethernet 0/2 state: up tx_rate: ge(0) rx_rate: le(0) - name: Check neighbors intent arguments slxos_interface: name: Ethernet 0/41 neighbors: - port: Ethernet 0/41 host: SLX - name: Config + intent slxos_interface: name: Ethernet 0/2 enabled: False state: down - name: Add interface using aggregate slxos_interface: aggregate: - { name: Ethernet 0/1, mtu: 1548, description: test-interface-1 } - { name: Ethernet 0/2, mtu: 1548, description: test-interface-2 } speed: 10000 state: present - name: Delete interface using aggregate slxos_interface: aggregate: - name: Loopback 9 - name: Loopback 10 state: absent
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
commands
list
|
always, except for the platforms that use Netconf transport to manage the device. |
The list of configuration mode commands to send to the device.
Sample:
['interface Ethernet 0/2', 'description test-interface', 'mtu 1548']
|
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Lindsay Hill (@LindsayHill)
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/slxos_interface_module.html