Documentation

ce_mlag_interface - Manages MLAG interfaces on HUAWEI CloudEngine switches.

New in version 2.4.

Synopsis

  • Manages MLAG interface attributes on HUAWEI CloudEngine switches.

Options

parameter required default choices comments
dfs_group_id
no present
ID of a DFS group.The value is 1.
eth_trunk_id
no
Name of the local M-LAG interface. The value is ranging from 0 to 511.
interface
no
Name of the interface that enters the Error-Down state when the peer-link fails. The value is a string of 1 to 63 characters.
mlag_error_down
no
  • enable
  • disable
Configure the interface on the slave device to enter the Error-Down state.
mlag_id
no
ID of the M-LAG. The value is an integer that ranges from 1 to 2048.
mlag_priority_id
no
M-LAG global LACP system priority. The value is an integer ranging from 0 to 65535. The default value is 32768.
mlag_system_id
no
M-LAG global LACP system MAC address. The value is a string of 0 to 255 characters. The default value is the MAC address of the Ethernet port of MPU.
state
no present
  • present
  • absent
Specify desired state of the resource.

Examples

- name: mlag interface module test
  hosts: cloudengine
  connection: local
  gather_facts: no
  vars:
    cli:
      host: "{{ inventory_hostname }}"
      port: "{{ ansible_ssh_port }}"
      username: "{{ username }}"
      password: "{{ password }}"
      transport: cli

  tasks:

  - name: Set interface mlag error down
    ce_mlag_interface:
      interface: 10GE2/0/1
      mlag_error_down: enable
      provider: "{{ cli }}"
  - name: Create mlag
    ce_mlag_interface:
      eth_trunk_id: 1
      dfs_group_id: 1
      mlag_id: 4
      provider: "{{ cli }}"
  - name: Set mlag global attribute
    ce_mlag_interface:
      mlag_system_id: 0020-1409-0407
      mlag_priority_id: 5
      provider: "{{ cli }}"
  - name: Set mlag interface attribute
    ce_mlag_interface:
      eth_trunk_id: 1
      mlag_system_id: 0020-1409-0400
      mlag_priority_id: 3
      provider: "{{ cli }}"

Return Values

Common return values are documented here Return Values, the following are the fields unique to this module:

name description returned type sample
end_state k/v pairs of aaa params after module execution always dict {}
changed check to see if a change was made on the device always boolean True
updates command sent to the device always list {'interface eth-trunk1': None, 'undo m-lag unpaired-port suspend': None}
proposed k/v pairs of parameters passed into module always dict {'interface': 'eth-trunk1', 'mlag_error_down': 'disable', 'state': 'present'}
existing k/v pairs of existing aaa server always dict {'mlagErrorDownInfos': [{'portName': 'Eth-Trunk1', 'dfsgroupId': '1'}]}


Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Support

This module is community maintained without core committer oversight.

For more information on what this means please read Module Support

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.