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	Варианты: нет ← да	Удаление 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 список	всегда	Список команд режима конфигурации, которые нужно отправить на устройство Пример: ['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']

Статус

Гарантируется отсутствие обратной совместимости интерфейса. [превью]
Этот модуль поддерживается сообществом 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.8/modules/edgeswitch_vlan_module.html