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