junipernetworks.junos.junos_vlan – (deprecated, removed after 2022-06-01) Управление VLAN на устройствах Juniper JUNOS

Примечание

Этот плагин входит в коллекцию junipernetworks.junos (версия 1.3.0).

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

Для использования в плейбуке укажите: junipernetworks.junos.junos_vlan

В версии 1.0.0: of junipernetworks.junos

УСТАРЕВШИЙ
Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

УСТАРЕВШИЙ

Удалено в: после выпуска основной версии после 2022-06-01
Почему: Выпущены обновленные модули с более широкими возможностями
Альтернатива: Используйте junipernetworks.junos.junos_vlans вместо этого.

Описание

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

Примечание

У этого модуля есть соответствующий плагин действий.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

ncclient (>=v0.5.2)

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
active boolean		Варианты: нет да ←	Указывает, активна ли конфигурация или деактивирована
aggregate список / элементы=словарь			Список определений VLAN.
	active boolean	Варианты: нет да	Указывает, активна ли конфигурация или деактивирована
	description строка		Текстовое описание VLAN.
	filter_input строка		Имя входного фильтра.
	filter_output строка		Имя выходного фильтра.
	interfaces список / элементы=строка		Список интерфейсов для проверки правильности конфигурации VLAN.
	l3_interface строка		Имя логического интерфейса 3-го уровня.
	name строка / обязательно		Имя VLAN.
	state строка	Варианты: present absent	Состояние конфигурации VLAN.
	vlan_id целое число / обязательно		ID VLAN. Диапазон 1-4094.
description строка			Текстовое описание VLAN.
filter_input строка			Имя входного фильтра.
filter_output строка			Имя выходного фильтра.
interfaces список / элементы=строка			Список интерфейсов для проверки правильности конфигурации VLAN.
l3_interface строка			Имя логического интерфейса 3-го уровня.
name строка			Имя VLAN.
provider словарь			Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli` или `connection: netconf` Дополнительная информация в руководстве Junos OS Platform Options. Объект словаря, содержащий данные подключения.
	host строка		Указывает имя или адрес хоста DNS для подключения к удаленному устройству через указанный транспорт. Значение host используется в качестве целевого адреса для транспорта.
	password строка		Указывает пароль для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сессии SSH. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_PASSWORD`
	port целое число		Указывает порт для создания подключения к удаленному устройству. Значение порта будет по умолчанию равно общеизвестному порту SSH 22 (для `transport=cli`) или порту 830 (для `transport=netconf`) устройства.
	ssh_keyfile путь		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Это значение — путь к ключу, используемому для аутентификации сессии SSH. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`
	timeout целое число		Указывает тайм-аут в секундах для связи с сетевым устройством при подключении или отправке команд. Если тайм-аут истечет до завершения операции, модуль вернет ошибку.
	transport строка	Варианты: cli netconf ←	Настраивает транспортное соединение для подключения к удаленному устройству.
	username строка		Настраивает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сессии SSH. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_USERNAME`
state строка		Варианты: present ← absent	Состояние конфигурации VLAN.
vlan_id целое число			ID VLAN. Диапазон 1-4094.

Примечания

Примечание

Этот модуль требует, чтобы на удаленном управляемом устройстве был включен системный сервис netconf.
Тестировано на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
Рекомендуемое подключение — netconf. См. Руководство по параметрам платформы Junos OS.
Этот модуль также работает с подключениями local для плейбуков старого образца.
Дополнительную информацию об использовании CLI и netconf см. в руководстве по параметрам платформы Junos OS
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве Ansible по сетям
Дополнительную информацию об использовании Ansible для управления устройствами Juniper см. на https://www.ansible.com/ansible-juniper.

Примеры

- name: configure VLAN ID and name
  junipernetworks.junos.junos_vlan:
    name: test
    vlan_id: 20

- name: Link to logical layer 3 interface
  junipernetworks.junos.junos_vlan:
    name: test
    vlan_id: 20
    l3-interface: vlan.20

- name: remove VLAN configuration
  junipernetworks.junos.junos_vlan:
    name: test
    state: absent

- name: deactive VLAN configuration
  junipernetworks.junos.junos_vlan:
    name: test
    state: present
    active: false

- name: activate VLAN configuration
  junipernetworks.junos.junos_vlan:
    name: test
    state: present
    active: true

- name: Create vlan configuration using aggregate
  junipernetworks.junos.junos_vlan:
    aggregate:
    - {vlan_id: 159, name: test_vlan_1, description: test vlan-1}
    - {vlan_id: 160, name: test_vlan_2, description: test vlan-2}

- name: Delete vlan configuration using aggregate
  junipernetworks.junos.junos_vlan:
    aggregate:
    - {vlan_id: 159, name: test_vlan_1}
    - {vlan_id: 160, name: test_vlan_2}
    state: absent

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

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

Ключ	Возвращенное значение	Описание
diff.prepared строка	при изменении конфигурации и включенном варианте diff.	Разница в конфигурации до и после применения изменений. Пример: [edit vlans] + test-vlan-1 { + vlan-id 60; + }

Статус

Этот модуль будет удален в следующей основной версии после 2022-06-01. [устарел]
Дополнительная информация в разделе УСТАРЕВШИЙ.

Авторы

Ganesh Nalawade (@ganeshrn)

© 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/junipernetworks/junos/junos_vlan_module.html