community.network.ce_stp – Manages STP configuration on HUAWEI CloudEngine switches.

Note

This plugin is part of the community.network collection (version 1.3.2).

To install it use: ansible-galaxy collection install community.network.

To use it in a playbook, specify: community.network.ce_stp.

Synopsis

• Manages STP configurations on HUAWEI CloudEngine switches.

Parameters

Parameter	Choices/Defaults	Comments
bpdu_filter string	Choices: enable disable	Specify a port as a BPDU filter port.
bpdu_protection string	Choices: enable disable	Configure BPDU protection on an edge port. This function prevents network flapping caused by attack packets.
cost string		Set the path cost of the current port. The default instance is 0.
edged_port string	Choices: enable disable	Set the current port as an edge port.
interface string		Interface name. If the value is all, will apply configuration to all interfaces. if the value is a special name, only support input the full name.
loop_protection string	Choices: enable disable	Enable loop protection on the current port.
root_protection string	Choices: enable disable	Enable root protection on the current port.
state string	Choices: present ← absent	Specify desired state of the resource.
stp_converge string	Choices: fast normal	STP convergence mode. Fast means set STP aging mode to Fast. Normal means set STP aging mode to Normal.
stp_enable string	Choices: enable disable	Enable or disable STP on a switch.
stp_mode string	Choices: stp rstp mstp	Set an operation mode for the current MSTP process. The mode can be STP, RSTP, or MSTP.
tc_protection string	Choices: enable disable	Configure the TC BPDU protection function for an MSTP process.
tc_protection_interval string		Set the time the MSTP device takes to handle the maximum number of TC BPDUs and immediately refresh forwarding entries. The value is an integer ranging from 1 to 600, in seconds.
tc_protection_threshold string		Set the maximum number of TC BPDUs that the MSTP can handle. The value is an integer ranging from 1 to 255. The default value is 1 on the switch.

Notes

Note

• Recommended connection is network_cli.

• This module also works with local connections for legacy playbooks.

Examples

- name: CloudEngine stp 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: "Config stp mode"
    community.network.ce_stp:
      state: present
      stp_mode: stp
      provider: "{{ cli }}"

  - name: "Undo stp mode"
    community.network.ce_stp:
      state: absent
      stp_mode: stp
      provider: "{{ cli }}"

  - name: "Enable bpdu protection"
    community.network.ce_stp:
      state: present
      bpdu_protection: enable
      provider: "{{ cli }}"

  - name: "Disable bpdu protection"
    community.network.ce_stp:
      state: present
      bpdu_protection: disable
      provider: "{{ cli }}"

Return Values

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

Key	Returned	Description
changed boolean	always	check to see if a change was made on the device Sample: True
end_state dictionary	always	k/v pairs of aaa params after module execution Sample: {'bpdu_protection': 'enable'}
existing dictionary	always	k/v pairs of existing aaa server Sample: {'bpdu_protection': 'disable'}
proposed dictionary	always	k/v pairs of parameters passed into module Sample: {'bpdu_protection': 'enable', 'state': 'present'}
updates list / elements=string	always	command sent to the device Sample: ['stp bpdu-protection']

Authors

• wangdezhuang (@QijunPan)