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

Примечание

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

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

Чтобы использовать его в playbook, укажите: 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 целое число		Указывает порт для подключения к удалённому устройству. Значение порта по умолчанию 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/junipernetworks/junos/junos_l2_interface_module.html