Модуль community.network.ce_vlan — Управление ресурсами и атрибутами VLAN на коммутаторах Huawei CloudEngine.

Примечание

Этот модуль является частью коллекции community.network (версия 5.0.3).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.network.

Для использования в книге задач укажите: community.network.ce_vlan.

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Управление конфигурациями VLAN на коммутаторах Huawei CloudEngine.

Псевдонимы: network.cloudengine.ce_vlan

Параметры

Параметр	Комментарии
description строка	Укажите описание VLAN, минимум 1 символ, максимум 80 символов.
name строка	Имя VLAN, минимум 1 символ, максимум 31 символ.
state строка	Управление состоянием ресурса. Варианты: `"present"` ← (по умолчанию) `"absent"`
vlan_id строка	Единственный идентификатор VLAN в диапазоне от 1 до 4094.
vlan_range строка	Диапазон VLAN, например, `2-10` или `2,5,10-15`, и т. д.

Примечания

Примечание

Для этого модуля требуется, чтобы служба netconf была включена на управляемом удалённом устройстве.
Рекомендуемое подключение — netconf.
Этот модуль также работает с подключениями local для устаревших книг задач.

Примеры

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

  tasks:

  - name: Ensure a range of VLANs are not present on the switch
    community.network.ce_vlan:
      vlan_range: "2-10,20,50,55-60,100-150"
      state: absent
      provider: "{{ cli }}"

  - name: Ensure VLAN 50 exists with the name WEB
    community.network.ce_vlan:
      vlan_id: 50
      name: WEB
      state: absent
      provider: "{{ cli }}"

  - name: Ensure VLAN is NOT on the device
    community.network.ce_vlan:
      vlan_id: 50
      state: absent
      provider: "{{ cli }}"

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Описание
changed логическое	проверка, были ли внесены изменения на устройстве Возвращается: всегда Пример: `true`
end_state словарь	k/v пары VLAN после выполнения модуля или null при использовании vlan_range Возвращается: всегда Пример: `{"description": "vlan for app", "name": "VLAN_APP", "vlan_id": "20"}`
end_state_vlans_list список / элементы=строка	список VLAN после выполнения модуля Возвращается: всегда Пример: `["1", "2", "3", "4", "5", "20", "100"]`
existing словарь	k/v пары существующего vlan или null при использовании vlan_range Возвращается: всегда Пример: `{"description": "", "name": "VLAN_APP", "vlan_id": "20"}`
existing_vlans_list список / элементы=строка	список существующих VLAN на коммутаторе до внесения изменений Возвращается: всегда Пример: `["1", "2", "3", "4", "5", "20"]`
proposed словарь	k/v пары параметров, переданных в модуль (не включают vlan_id или vlan_range) Возвращается: всегда Пример: `{"description": "vlan for app", "name": "VLAN_APP", "vlan_id": "20"}`
proposed_vlans_list список / элементы=строка	список предлагаемых VLAN Возвращается: всегда Пример: `["100"]`
updates список / элементы=строка	строка команды, отправленная на устройство Возвращается: всегда Пример: `["vlan 20", "name VLAN20"]`

Авторы

QijunPan (@QijunPan)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/network/ce_vlan_module.html