junipernetworks.junos.junos_l2_interface – (устаревшее, удалено после 2022-06-01) Управление интерфейсом L2 на устройствах Juniper JUNOS

Примечание

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

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

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

Новое в версии 1.0.0: of junipernetworks.junos

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

УСТАРЕВШЕ

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

Описание

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

Примечание

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

Требования

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

ncclient (>=v0.5.2)

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
access_vlan строка			Настроить заданный VLAN на порту доступа. Значение `access_vlan` должно быть именем VLAN.
active логический		Варианты: нет да ←	Указывает, активна или деактивирована конфигурация.
aggregate список / элементы=словарь			Список определений интерфейсов второго уровня.
	access_vlan строка		Настроить заданный VLAN на порту доступа. Значение `access_vlan` должно быть именем VLAN.
	active логический	Варианты: нет да	Указывает, активна или деактивирована конфигурация.
	description строка		Описание интерфейса.
	enhanced_layer логический	Варианты: нет да	Истинно, если ваше устройство имеет ПО Enhanced Layer 2 (ELS).
	filter_input строка		Имя входного фильтра ethernet-switching.
	filter_output строка		Имя выходного фильтра ethernet-switching.
	mode строка	Варианты: access trunk	Режим конфигурации интерфейса.
	name строка / обязательно		Имя интерфейса без номера логического блока.
	native_vlan целое число		VLAN по умолчанию для порта trunk. Значение `native_vlan` должно быть ID VLAN.
	state строка	Варианты: present absent	Состояние конфигурации интерфейса второго уровня.
	trunk_vlans список / элементы=строка		Список имен VLAN, которые необходимо настроить на порту trunk. Значение `trunk_vlans` должно быть списком имен VLAN.
	unit целое число		Номер логического интерфейса. Значение `unit` должно быть целым числом.
description строка			Описание интерфейса.
enhanced_layer логический		Варианты: нет да ←	Истинно, если ваше устройство имеет ПО Enhanced Layer 2 (ELS).
filter_input строка			Имя входного фильтра ethernet-switching.
filter_output строка			Имя выходного фильтра ethernet-switching.
mode строка		Варианты: access trunk	Режим конфигурации интерфейса.
name строка			Имя интерфейса без номера логического блока.
native_vlan целое число			VLAN по умолчанию для порта trunk. Значение `native_vlan` должно быть ID 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	Состояние конфигурации интерфейса второго уровня.
trunk_vlans список / элементы=строка			Список имен VLAN, которые необходимо настроить на порту trunk. Значение `trunk_vlans` должно быть списком имен VLAN.
unit целое число		По умолчанию: 0	Номер логического интерфейса. Значение `unit` должно быть целым числом.

Примечания

Примечание

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

Примеры

- name: Configure interface in access mode
  junipernetworks.junos.junos_l2_interface:
    name: ge-0/0/1
    description: interface-access
    mode: access
    access_vlan: red
    active: true
    state: present

- name: Configure interface in trunk mode
  junipernetworks.junos.junos_l2_interface:
    name: ge-0/0/1
    description: interface-trunk
    mode: trunk
    trunk_vlans:
    - blue
    - green
    native_vlan: 100
    active: true
    state: present

- name: Configure interface in access and trunk mode using aggregate
  junipernetworks.junos.junos_l2_interface:
    aggregate:
    - name: ge-0/0/1
      description: test-interface-access
      mode: access
      access_vlan: red
    - name: ge-0/0/2
      description: test-interface-trunk
      mode: trunk
      trunk_vlans:
      - blue
      - green
      native_vlan: 100
    active: true
    state: present

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

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

Ключ	Возвращаемое значение	Описание
diff строка	при изменении конфигурации и включенном параметре diff.	Разница в конфигурации до и после применения изменения. Пример: [edit interfaces] + ge-0/0/1 { + description "l2 interface configured by Ansible"; + unit 0 { + family ethernet-switching { + interface-mode access; + vlan { + members red; + } + } + } + }

Статус

Этот модуль будет удалён в основной версии после 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_l2_interface_module.html