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 bool |
| 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 flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Maintenance
This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Community, see here.
Author
- 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.6/modules/slxos_interface_module.html