community.network.ce_lacp – Manages Eth-Trunk interfaces on HUAWEI CloudEngine switches
Note
This plugin is part of the community.network collection (version 3.0.0).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
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
Parameters
Parameter |
Comments |
---|---|
Value of delay time in units of 10 microseconds. |
|
When lacp timeout type is ‘Fast’, user-defined time can be a number(3~90). |
|
Configure lacp priority on system-view. |
|
Max active linknumber in link aggregation group. |
|
Value of max active linknumber. Choices:
|
|
Specifies the working mode of an Eth-Trunk interface. Choices:
|
|
Enable the function of extending the LACP negotiation port number. Choices:
|
|
Value of preemption delay time. |
|
Specifies lacp preempt enable of Eth-Trunk lacp. The value is an boolean ‘true’ or ‘false’. Choices:
|
|
The priority of eth-trunk member interface. |
|
Select priority or speed to preempt. Choices:
|
|
Manage the state of the resource. Choices:
|
|
Lacp dampening state-flapping. Choices:
|
|
Link Aggregation Control Protocol System ID,interface Eth-Trunk View. Formate ‘X-X-X’,X is hex(a,aa,aaa, or aaaa) |
|
Lacp timeout type,that may be ‘Fast’ or ‘Slow’. Choices:
|
|
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. |
|
Lacp dampening unexpected-mac disable. Choices:
|
Notes
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.This module requires the netconf system service be enabled on the remote device being managed.
Recommended connection is
netconf
.This module also works with
local
connections for legacy playbooks.
Examples
- 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
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
k/v pairs of Eth-Trunk info after module execution Returned: always 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”} |
|
k/v pairs of existing Eth-Trunk Returned: always Sample: {“hash_type”: “mac”, “members_detail”: [{“memberIfName”: “10GE1/0/25”, “memberIfState”: “Down”}], “min_links”: “1”, “mode”: “manual”, “trunk_id”: “100”} |
|
k/v pairs of parameters passed into module Returned: always Sample: {“members”: [“10GE1/0/24”, “10GE1/0/25”], “mode”: “lacp-static”, “trunk_id”: “100”} |
|
command sent to the device Returned: always Sample: [“interface Eth-Trunk 100”, “mode lacp-static”, “interface 10GE1/0/25”, “eth-trunk 100”] |
Authors
xuxiaowei0512 (@CloudEngine-Ansible)