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

Новая в версии 2.8.

Обзор
Параметры
Примечания
Примеры
Значения возврата
Статус

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
aggregate -		Список определений VLAN.
auto_exclude boolean	Варианты: no yes	Каждый из интерфейсов коммутатора будет исключен из vlan_id, если не определен в *_interfaces. Это значение по умолчанию для всех интерфейсов коммутатора.
auto_tag boolean	Варианты: no yes	Каждый из интерфейсов коммутатора будет настроен на прием и передачу немаркированных кадров для vlan_id, если не определен в *_interfaces. Это значение по умолчанию для всех интерфейсов коммутатора.
auto_untag boolean	Варианты: no yes	Каждый из интерфейсов коммутатора будет настроен на прием немаркированных кадров и передачу их в виде маркированных для vlan_id, если не определен в *_interfaces. Это значение по умолчанию для всех интерфейсов коммутатора.
excluded_interfaces -		Список интерфейсов, которые должны быть исключены из VLAN. Принимаются диапазоны интерфейсов.
name -		Имя VLAN.
purge boolean	Варианты: 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
  edgeswitch_vlan:
    vlan_id: 100
    name: voice
    action: present

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

- name: setup three vlans and delete the rest
  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
  edgeswitch_vlan:
    vlan_id: 100
    state: absent

Значения возврата

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

Ключ	Возвращаемое значение	Описание
commands list	всегда	Список команд режима конфигурации для отправки на устройство Пример: ['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']

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [preview]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Frederic Bor (@f-bor)

Подсказка

Если вы заметите какие-либо проблемы в этом документе, вы можете изменить этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/edgeswitch_vlan_module.html