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

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install community.network.

Чтобы использовать её в плейбуке, укажите: community.network.edgeswitch_vlan.

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

Описание

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

Псевдонимы: network.edgeswitch.edgeswitch_vlan

Параметры

Параметр	Комментарии
aggregate строка	Список определений VLAN.
auto_exclude логическое	Каждый интерфейс коммутатора будет исключён из vlan_id, если не определён в _interfaces. Это стандартное поведение для всех интерфейсов коммутатора. Варианты:* `false` `true`
auto_tag логическое	Каждый интерфейс коммутатора будет настроен на прием и передачу немаркированных кадров для vlan_id, если не определён в _interfaces. Это стандартное поведение для всех интерфейсов коммутатора. Варианты:* `false` `true`
auto_untag логическое	Каждый интерфейс коммутатора будет настроен на прием немаркированных кадров и передачу их с маркировкой для vlan_id, если не определён в _interfaces. Это стандартное поведение для всех интерфейсов коммутатора. Варианты:* `false` `true`
excluded_interfaces строка	Список интерфейсов, которые должны быть исключены из VLAN. Поддерживаются диапазоны интерфейсов.
name строка	Имя VLAN.
purge логическое	Удалить VLAN, не определённые в параметре aggregate. Варианты: `false` ← (по умолчанию) `true`
state строка	действие над конфигурацией VLAN. Варианты: `"present"` ← (по умолчанию) `"absent"`
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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/network/edgeswitch_vlan_module.html