community.network.edgeswitch_vlan – Управление VLAN на устройствах Ubiquiti Edgeswitch

Примечание

Этот плагин входит в коллекцию community.network (версия 2.0.1).

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

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

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

Обзор

Этот модуль обеспечивает декларативное управление VLAN на устройствах Ubiquiti Edgeswitch.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
aggregate строка		Список определений VLAN.
auto_exclude булево	Варианты: no yes	Каждый интерфейс коммутатора будет исключен из vlan_id, если не определён в *_interfaces. Это значение по умолчанию для всех интерфейсов коммутатора.
auto_tag булево	Варианты: no yes	Каждый интерфейс коммутатора будет настроен на принятие и передачу немаркированных кадров для vlan_id, если не определён в *_interfaces. Это значение по умолчанию для всех интерфейсов коммутатора.
auto_untag булево	Варианты: no yes	Каждый интерфейс коммутатора будет настроен на принятие немаркированных кадров и передачу их с маркировкой для vlan_id, если не определён в *_interfaces. Это значение по умолчанию для всех интерфейсов коммутатора.
excluded_interfaces строка		Список интерфейсов, которые должны быть исключены из VLAN. Можно указать диапазон интерфейсов.
name строка		Имя VLAN.
purge булево	Варианты: no ← yes	Очистить VLAN, не определённые в параметре aggregate.
state строка	Варианты: present ← absent	действие по конфигурации VLAN.
tagged_interfaces строка		Список интерфейсов, которые должны принимать и передавать маркированные кадры для VLAN. Можно указать диапазон интерфейсов.
untagged_interfaces строка		Список интерфейсов, которые должны принимать немаркированные кадры и передавать их с маркировкой для VLAN. Можно указать диапазон интерфейсов.
vlan_id строка		ID VLAN. Диапазон 1-4093.

Примечания

Примечание

Проверено на edgeswitch 1.7.4
Этот модуль использует собственный синтаксис Ubiquiti для VLAN и не поддерживает синтаксис совместимости switchport. Для ясности, настоятельно рекомендуется не использовать оба синтаксиса на одном интерфейсе.
Edgeswitch не поддерживает удаление или изменение имени VLAN 1
Так как auto_tag, auto_untag и auto_exclude являются значениями по умолчанию для всех интерфейсов, они взаимоисключающие.

Примеры

- name: Create vlan
  community.network.edgeswitch_vlan:
    vlan_id: 100
    name: voice
    action: present

- name: Add interfaces to VLAN
  community.network.edgeswitch_vlan:
    vlan_id: 100
    tagged_interfaces:
      - 0/1
      - 0/4-0/6

- name: Setup three vlans and delete the rest
  community.network.edgeswitch_vlan:
    purge: true
    aggregate:
      - { vlan_id: 1, name: default, auto_untag: true, excluded_interfaces: 0/45-0/48 }
      - { vlan_id: 100, name: voice, auto_tag: true }
      - { vlan_id: 200, name: video, auto_exclude: true, untagged_interfaces: 0/45-0/48, tagged_interfaces: 0/49 }

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

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

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

Ключ	Возвращаемое значение	Описание
commands список / элементы=строка	всегда	Список команд конфигурации, которые необходимо отправить устройству. Пример: ['vlan database', 'vlan 100', 'vlan name 100 "test vlan"', 'exit', 'interface 0/1', 'vlan pvid 50', 'vlan participation include 50,100', 'vlan tagging 100', 'vlan participation exclude 200', 'no vlan tagging 200']

Авторы

Frederic Bor (@f-bor)

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