cisco.nxos.nxos_lacp_interfaces – LACP interfaces resource module¶
Note
This plugin is part of the cisco.nxos collection (version 1.4.0).
To install it use: ansible-galaxy collection install cisco.nxos
.
To use it in a playbook, specify: cisco.nxos.nxos_lacp_interfaces
.
New in version 1.0.0: of cisco.nxos
Synopsis¶
This module manages Link Aggregation Control Protocol (LACP) attributes of NX-OS Interfaces.
Note
This module has a corresponding action plugin.
Parameters¶
Examples¶
# Using merged
# Before state:
# -------------
#
- name: Merge provided configuration with device configuration.
cisco.nxos.nxos_lacp_interfaces:
config:
- name: Ethernet1/3
port_priority: 5
rate: fast
state: merged
# After state:
# ------------
#
# interface Ethernet1/3
# lacp port-priority 5
# lacp rate fast
# Using replaced
# Before state:
# -------------
#
# interface Ethernet1/3
# lacp port-priority 5
# interface port-channel11
# lacp mode delay
- name: Replace device lacp interfaces configuration with the given configuration.
cisco.nxos.nxos_lacp_interfaces:
config:
- name: port-channel11
links:
min: 4
state: replaced
# After state:
# ------------
#
# interface Ethernet1/3
# lacp port-priority 5
# interface port-channel11
# lacp min-links 4
# Using overridden
# Before state:
# -------------
#
# interface Ethernet1/3
# lacp port-priority 5
# interface port-channel11
# lacp mode delay
- name: Override device configuration of all LACP interfaces attributes of given interfaces
on device with provided configuration.
cisco.nxos.nxos_lacp_interfaces:
config:
- name: port-channel11
links:
min: 4
state: overridden
# After state:
# ------------
#
# interface port-channel11
# lacp min-links 4
# Using deleted
# Before state:
# -------------
#
# interface Ethernet1/3
# lacp port-priority 5
# interface port-channel11
# lacp mode delay
- name: Delete LACP interfaces configurations.
cisco.nxos.nxos_lacp_interfaces:
state: deleted
# After state:
# ------------
#
# Using rendered
- name: Use rendered state to convert task input to device specific commands
cisco.nxos.nxos_lacp_interfaces:
config:
- name: Ethernet1/800
rate: fast
- name: Ethernet1/801
rate: fast
port_priority: 32
- name: port-channel10
links:
max: 15
min: 2
convergence:
graceful: true
state: rendered
# Task Output (redacted)
# -----------------------
# rendered:
# - "interface Ethernet1/800"
# - "lacp rate fast"
# - "interface Ethernet1/801"
# - "lacp port-priority 32"
# - "lacp rate fast"
# - "interface port-channel10"
# - "lacp min-links 2"
# - "lacp max-bundle 15"
# - "lacp graceful-convergence"
# Using parsed
# parsed.cfg
# ------------
# interface port-channel10
# lacp min-links 10
# lacp max-bundle 15
# interface Ethernet1/800
# lacp port-priority 100
# lacp rate fast
- name: Use parsed state to convert externally supplied config to structured format
cisco.nxos.nxos_lacp_interfaces:
running_config: "{{ lookup('file', 'parsed.cfg') }}"
state: parsed
# Task output (redacted)
# -----------------------
# parsed:
# - name: port-channel10
# links:
# max: 15
# min: 10
# - name: Ethernet1/800
# port_priority: 100
# rate: fast
# Using gathered
# Existing device config state
# -------------------------------
# interface Ethernet1/1
# lacp port-priority 5
# lacp rate fast
# interface port-channel10
# lacp mode delay
# interface port-channel11
# lacp max-bundle 10
# lacp min-links 5
- name: Gather lacp_interfaces facts from the device using nxos_lacp_interfaces
cisco.nxos.nxos_lacp_interfaces:
state: gathered
# Task output (redacted)
# -----------------------
# gathered:
# - name: Ethernet1/1
# port_priority: 5
# rate: fast
# - name: port-channel10
# mode: delay
# - name: port-channel11
# links:
# max: 10
# min: 5
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Authors¶
Trishna Guha (@trishnaguha)