junos_vlan – Управление VLAN на сетевых устройствах Juniper JUNOS

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

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

Описание

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

Требования

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

ncclient (>=v0.5.2)

Параметры

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

Примечания

Примечание

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

Примеры

- name: configure VLAN ID and name
  junos_vlan:
    vlan_name: test
    vlan_id: 20
    name: test-vlan

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

- name: remove VLAN configuration
  junos_vlan:
    vlan_name: test
    state: absent

- name: deactive VLAN configuration
  junos_vlan:
    vlan_name: test
    state: present
    active: False

- name: activate VLAN configuration
  junos_vlan:
    vlan_name: test
    state: present
    active: True

- name: Create vlan configuration using aggregate
  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
  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; + }

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается командой Ansible Network. [сеть]

Поддержка Red Hat

Дополнительную информацию о поддержке этого модуля Red Hat см. в этой статье базы знаний Red Hat.

Авторы

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.8/modules/junos_vlan_module.html