Note
This plugin is part of the community.network collection (version 2.0.1).
To install it use: ansible-galaxy collection install community.network.
To use it in a playbook, specify: community.network.ce_lacp.
New in version 0.2.0: of community.network
| Parameter | Choices/Defaults | Comments |
|---|---|---|
| collector_delay integer | Value of delay time in units of 10 microseconds. | |
| fast_timeout integer | When lacp timeout type is 'Fast', user-defined time can be a number(3~90). | |
| global_priority integer | Configure lacp priority on system-view. | |
| max_active_linknumber integer | Max active linknumber in link aggregation group. | |
| mixed_rate_link_enable boolean |
| Value of max active linknumber. |
| mode string |
| Specifies the working mode of an Eth-Trunk interface. |
| port_id_extension_enable boolean |
| Enable the function of extending the LACP negotiation port number. |
| preempt_delay integer | Value of preemption delay time. | |
| preempt_enable boolean |
| Specifies lacp preempt enable of Eth-Trunk lacp. The value is an boolean 'true' or 'false'. |
| priority integer | The priority of eth-trunk member interface. | |
| select string |
| Select priority or speed to preempt. |
| state string |
| Manage the state of the resource. |
| state_flapping boolean |
| Lacp dampening state-flapping. |
| system_id string | Link Aggregation Control Protocol System ID,interface Eth-Trunk View. Formate 'X-X-X',X is hex(a,aa,aaa, or aaaa) | |
| timeout_type string |
| Lacp timeout type,that may be 'Fast' or 'Slow'. |
| trunk_id integer | Eth-Trunk interface number. The value is an integer. The value range depends on the assign forward eth-trunk mode command. When 256 is specified, the value ranges from 0 to 255. When 512 is specified, the value ranges from 0 to 511. When 1024 is specified, the value ranges from 0 to 1023. | |
| unexpected_mac_disable boolean |
| Lacp dampening unexpected-mac disable. |
Note
state=absent removes the Eth-Trunk config and interface if it already exists. If members to be removed are not explicitly passed, all existing members (if any), are removed, and Eth-Trunk removed.netconf.local connections for legacy playbooks.- name: Ensure Eth-Trunk100 is created, and set to mode lacp-static
community.network.ce_lacp:
trunk_id: 100
mode: 'lacp-static'
state: present
- name: Ensure Eth-Trunk100 is created, add two members, and set global priority to 1231
community.network.ce_lacp:
trunk_id: 100
global_priority: 1231
state: present
- name: Ensure Eth-Trunk100 is created, and set mode to Dynamic and configure other options
community.network.ce_lacp:
trunk_id: 100
mode: Dynamic
preempt_enable: True,
state_flapping: True,
port_id_extension_enable: True,
unexpected_mac_disable: True,
timeout_type: Fast,
fast_timeout: 123,
mixed_rate_link_enable: True,
preempt_delay: 23,
collector_delay: 33,
state: present
Common return values are documented here, the following are the fields unique to this module:
| Key | Returned | Description |
|---|---|---|
| end_state dictionary | always | k/v pairs of Eth-Trunk info after module execution Sample: {'hash_type': 'mac', 'members_detail': [{'memberIfName': '10GE1/0/24', 'memberIfState': 'Down'}, {'memberIfName': '10GE1/0/25', 'memberIfState': 'Down'}], 'min_links': '1', 'mode': 'lacp-static', 'trunk_id': '100'} |
| existing dictionary | always | k/v pairs of existing Eth-Trunk Sample: {'hash_type': 'mac', 'members_detail': [{'memberIfName': '10GE1/0/25', 'memberIfState': 'Down'}], 'min_links': '1', 'mode': 'manual', 'trunk_id': '100'} |
| proposed dictionary | always | k/v pairs of parameters passed into module Sample: {'members': ['10GE1/0/24', '10GE1/0/25'], 'mode': 'lacp-static', 'trunk_id': '100'} |
| updates list / elements=string | always | command sent to the device Sample: ['interface Eth-Trunk 100', 'mode lacp-static', 'interface 10GE1/0/25', 'eth-trunk 100'] |
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/network/ce_lacp_module.html