junipernetworks.junos.junos_vlan – (deprecated, removed after 2022-06-01) Manage VLANs on Juniper JUNOS network devices

Примечание

This plugin is part of the junipernetworks.junos collection (version 1.2.1).

To install it use: ansible-galaxy collection install junipernetworks.junos.

To use it in a playbook, specify: junipernetworks.junos.junos_vlan.

New in version 1.0.0: of junipernetworks.junos

УСТЕРЕГЛО
Описание
Требования
Параметры
Примечания
Примеры
Значения возврата
Статус

УСТЕРЕГЛО

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

Описание

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

Примечание

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

Требования

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

ncclient (>=v0.5.2)

Параметры

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

Примечания

Примечание

Этот модуль требует включения системной службы netconf на удалённом управляемом устройстве.
Тестировалось на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
Рекомендуемое подключение netconf. См. раздел Junos OS Platform Options.
Этот модуль также работает с подключениями local для устаревших плейбуков.
Для получения информации об использовании CLI и netconf см. руководство Junos OS Platform Options
Для получения дополнительной информации об использовании 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 string	при изменении конфигурации и включенном параметре diff.	Разница в конфигурации до и после применения изменений. Пример: [edit vlans] + test-vlan-1 { + vlan-id 60; + }

Статус

Этот модуль будет удалён в следующем основном релизе после 2022-06-01. [устарел]
Для получения дополнительной информации см. УСТЕРЕГЛО.

Авторы

Ganesh Nalawade (@ganeshrn)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/junipernetworks/junos/junos_vlan_module.html