eos_lacp¶
Collection Note
This module is part of the arista.eos collection. To install the collection, use:
Added in version1.0.0.
Synopsis¶
- This module manages Global Link Aggregation Control Protocol (LACP) on Arista EOS devices.
Parameters¶
| Parameter | Defaults / Choices | Comments |
|---|---|---|
| config dict |
LACP global options. | |
| config.system | LACP system options. | |
| running_config str |
This option is used only with state I(parsed). The value of this option should be the output received from the EOS device by executing the command B(show running-config | section ^lacp). The state I(parsed) reads the configuration from C(running_config) option and transforms it into Ansible structured data as per the resource module's argspec and the value is then returned in the I(parsed) key within the result. |
|
| state str |
Default: merged Choices: merged, replaced, deleted, parsed, rendered, gathered |
The state of the configuration after module completion. |
Notes¶
Note
- Tested against Arista EOS 4.24.6F
- This module works with connection C(network_cli). See the L(EOS Platform Options,../network/user_guide/platform_eos.html).
Examples¶
# Using merged
# Before state:
# -------------
# veos# show running-config | include lacp
# lacp system-priority 10
- name: Merge provided global LACP attributes with device attributes
arista.eos.eos_lacp:
config:
system:
priority: 20
state: merged
# After state:
# ------------
# veos# show running-config | include lacp
# lacp system-priority 20
#
# Using replaced
# Before state:
# -------------
# veos# show running-config | include lacp
# lacp system-priority 10
- name: Replace device global LACP attributes with provided attributes
arista.eos.eos_lacp:
config:
system:
priority: 20
state: replaced
# After state:
# ------------
# veos# show running-config | include lacp
# lacp system-priority 20
#
# Using deleted
# Before state:
# -------------
# veos# show running-config | include lacp
# lacp system-priority 10
- name: Delete global LACP attributes
arista.eos.eos_lacp:
state: deleted
# After state:
# ------------
# veos# show running-config | include lacp
#
# Using rendered:
- name: Use Rendered to convert the structured data to native config
arista.eos.eos_lacp:
config:
system:
priority: 20
state: rendered
# Output:
# ------------
# rendered:
# - "lacp system-priority 20"
#
# Using parsed:
# parsed.cfg
# lacp system-priority 20
- name: Use parsed to convert native configs to structured data
arista.eos.eos_lacp:
running_config: "{{ lookup('file', 'parsed.cfg') }}"
state: parsed
# Output:
# parsed:
# system:
# priority: 20
# Using gathered:
# nathive config:
# -------------
# lacp system-priority 10
- name: Gather lacp facts from the device
arista.eos.eos_lacp:
state: gathered
# Output:
# gathered:
# system:
# priority: 10
#
Return Values¶
| Key | Data Type | Description | Returned |
|---|---|---|---|
| after | dict | The configuration as structured data after module completion. | when changed |
| before | dict | The configuration as structured data prior to module invocation. | always |
| commands | list | The set of commands pushed to the remote device. | always |
Authors¶
- Nathaniel Case (@qalthos)