junos_l2_interface – Управление интерфейсом второго уровня на устройствах Juniper JUNOS

Новая версия с 2.5.

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

УСТАНОВЛЕНО

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

Описание

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

Требования

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

ncclient (>=v0.5.2)

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
access_vlan -			Настройка заданного VLAN в порту доступа. Значение `access_vlan` должно быть именем VLAN.
active boolean		Варианты: нет да ←	Указывает, активна или деактивирована конфигурация
aggregate -			Список определений интерфейсов второго уровня.
description -			Описание интерфейса.
enhanced_layer boolean добавлено в 2.7		Варианты: нет да ←	Истина, если ваше устройство имеет ПО Enhanced Layer 2 (ELS).
filter_input - добавлено в 2.8			Имя входного фильтра ethernet-switching.
filter_output - добавлено в 2.8			Имя выходного фильтра ethernet-switching.
mode -		Варианты: доступ trunk	Режим, в котором должен быть настроен интерфейс.
name -			Имя интерфейса без номера логического блока.
native_vlan -			Базовый VLAN, который нужно настроить в порту trunk. Значение `native_vlan` должно быть идентификатором VLAN.
provider словарь			Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli` или `connection: netconf`. Для получения дополнительной информации см. руководство по платформам Junos OS Junos OS Platform Options. Объект словаря, содержащий данные подключения.
	host строка / обязательно		Указывает имя хоста DNS или адрес для подключения к удаленному устройству через указанный транспорт. Значение host используется в качестве адреса назначения для транспорта.
	password строка		Указывает пароль для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сессии SSH. Если значение не указано в задаче, вместо него используется значение переменной среды `ANSIBLE_NET_PASSWORD`.
	port целое число	По умолчанию: 22	Указывает порт для создания подключения к удаленному устройству. Значение порта по умолчанию — 22 (для `transport=cli`) или 830 (для `transport=netconf`) устройства.
	ssh_keyfile путь		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Это значение — путь к ключу, используемому для аутентификации сессии SSH. Если значение не указано в задаче, вместо него используется значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout целое число	По умолчанию: 10	Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут превышен до завершения операции, модуль вернёт ошибку.
	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
  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
  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
  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; + } + } + } + }

Статус

Этот модуль будет удалён в версии 2.13. [устарел]
Для получения дополнительной информации см. УСТАНОВЛЕНО.

Авторы

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.9/modules/junos_l2_interface_module.html