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.9/modules/slxos_interface_module.html