junos_l3_interface - Управление интерфейсами L3 на сетевых устройствах Juniper JUNOS

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

Обзор
- Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Поддержка
- Автор

Обзор

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

Требования

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

ncclient (>=v0.5.2)

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
active bool		Варианты: нет да ←	Указывает, активна или деактивирована конфигурация.
aggregate			Список определений интерфейсов L3.
ipv4			IPv4 интерфейса L3.
ipv6			IPv6 интерфейса L3.
name			Имя интерфейса L3.
provider			Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli` или `connection: netconf`. Дополнительная информация приведена в руководстве Junos OS Platform Options. Объект типа dict, содержащий данные соединения.
	host обязательно		Указывает имя хоста DNS или адрес для подключения к удалённому устройству через указанный транспорт. Значение host используется в качестве адреса назначения для транспорта.
	port	Значение по умолчанию: 22	Указывает порт для подключения к удалённому устройству. Значение порта по умолчанию - 22 (для `transport=cli`) или 830 (для `transport=netconf`) устройства.
	username		Настраивает имя пользователя для аутентификации соединения с удалённым устройством. Это значение используется для аутентификации сессии SSH. Если значение не указано в задаче, вместо него используется значение переменной окружения `ANSIBLE_NET_USERNAME`.
	password		Указывает пароль для аутентификации соединения с удалённым устройством. Это значение используется для аутентификации сессии SSH. Если значение не указано в задаче, вместо него используется значение переменной окружения `ANSIBLE_NET_PASSWORD`.
	timeout	Значение по умолчанию: 10	Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечёт до завершения операции, модуль выдаст ошибку.
	ssh_keyfile		Указывает SSH-ключ для аутентификации соединения с удалённым устройством. Это путь к ключу, используемому для аутентификации сессии SSH. Если значение не указано в задаче, вместо него используется значение переменной окружения `ANSIBLE_NET_SSH_KEYFILE`.
state		Варианты: present ← absent	Состояние конфигурации интерфейса L3.
unit		Значение по умолчанию: 0	Логический номер интерфейса.

Примечания

Примечание

Для работы этого модуля на управляемом удалённом устройстве должна быть включена служба 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 Network Guide
Дополнительная информация об использовании Ansible для управления сетевыми устройствами Juniper находится на https://www.ansible.com/ansible-juniper.

Примеры

- name: Set ge-0/0/1 IPv4 address
  junos_l3_interface:
    name: ge-0/0/1
    ipv4: 192.168.0.1

- name: Remove ge-0/0/1 IPv4 address
  junos_l3_interface:
    name: ge-0/0/1
    state: absent

- name: Set ipv4 address using aggregate
  junos_l3_interface:
    aggregate:
    - name: ge-0/0/1
      ipv4: 1.1.1.1
    - name: ge-0/0/2
      ipv4: 2.2.2.2
      ipv6: fd5d:12c9:2201:2::2

- name: Delete ipv4 address using aggregate
  junos_l3_interface:
    aggregate:
    - name: ge-0/0/1
      ipv4: 1.1.1.1
    - name: ge-0/0/2
      ipv4: 2.2.2.2
    state: absent

Возвращаемые значения

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

Ключ	Возвращаемое значение	Описание
diff строка	при изменении конфигурации и включённом параметре diff.	Разница в конфигурации до и после применения изменения. Пример: [edit interfaces ge-0/0/1 unit 0 family inet] + address 1.1.1.1/32; [edit interfaces ge-0/0/1 unit 0 family inet6] + address fd5d:12c9:2201:1::1/128;

Статус

Этот модуль помечен как preview, что означает, что он не гарантирует обратную совместимость интерфейса.

Техническое обслуживание

Этот модуль помечен как сетевой, что означает, что он поддерживается командой Ansible Network Team. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.

Список других модулей, также поддерживаемых командой Ansible Network Team, см. в этом разделе.

Поддержка

Дополнительную информацию о поддержке этого модуля компанией 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.6/modules/junos_l3_interface_module.html