community.network.cnos_vlan (5.0.2) — module

Install collection

Install with ansible-galaxy collection install community.network:==5.0.2

Add to requirements.yml

  collections:
    - name: community.network
      version: 5.0.2

Description

This module provides declarative management of VLANs on Lenovo CNOS network devices.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Create vlan
  community.network.cnos_vlan:
    vlan_id: 100
    name: test-vlan
    state: present

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Add interfaces to VLAN
  community.network.cnos_vlan:
    vlan_id: 100
    interfaces:
      - Ethernet1/33
      - Ethernet1/44

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Check if interfaces is assigned to VLAN
  community.network.cnos_vlan:
    vlan_id: 100
    associated_interfaces:
      - Ethernet1/33
      - Ethernet1/44

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Delete vlan
  community.network.cnos_vlan:
    vlan_id: 100
    state: absent

Inputs

    
name:
    description:
    - Name of the VLAN.

delay:
    default: 10
    description:
    - Delay the play should wait to check for declarative intent params values.

purge:
    default: false
    description:
    - Purge VLANs not defined in the I(aggregate) parameter.
    type: bool

state:
    choices:
    - present
    - absent
    - active
    - suspend
    default: present
    description:
    - State of the VLAN configuration.

vlan_id:
    description:
    - ID of the VLAN. Range 1-4094.
    required: true

aggregate:
    description: List of VLANs definitions.

interfaces:
    description:
    - List of interfaces that should be associated to the VLAN.
    required: true

associated_interfaces:
    description:
    - This is a intent option and checks the operational state of the for given vlan C(name)
      for associated interfaces. If the value in the C(associated_interfaces) does not
      match with the operational state of vlan interfaces on device it will result in
      failure.

Outputs

commands:
  description: The list of configuration mode commands to send to the device
  returned: always
  sample:
  - vlan 100
  - name test-vlan
  type: list