arista.eos.eos_l3_interface – (устаревшее, удалено после 2022-06-01) Управление интерфейсами L3 на устройствах Arista EOS.

Примечание

Этот плагин входит в коллекцию arista.eos (версия 1.2.0).

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

Для использования в книге задач укажите: arista.eos.eos_l3_interface.

Введено в версии 1.0.0: of arista.eos

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

УСТАРЕВШЕ

Удалено в: главной версии после 2022-06-01
Почему: Выпущены обновлённые модули с большей функциональностью
Альтернатива: eos_l3_interfaces

Описание

Этот модуль предоставляет декларативное управление интерфейсами L3 на устройствах Arista EOS.

Примечание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
aggregate список / элементы=словарь			Список определений интерфейсов L3. Каждый элемент списка aggregate должен определять имя интерфейса `name` и необязательный `ipv4` или `ipv6` адрес.
	ipv4 строка		IPv4-адрес, который нужно установить для интерфейса L3, упомянутого в параметре name. Формат адреса — <ipv4-адрес>/<маска>, маска — число в диапазоне 0–32, например, 192.168.0.1/24
	ipv6 строка		IPv6-адрес, который нужно установить для интерфейса L3, упомянутого в параметре name. Формат адреса — <ipv6-адрес>/<маска>, маска — число в диапазоне 0–128, например, fd5d:12c9:2201:1::1/64
	name строка / обязательно		Имя интерфейса L3, который нужно настроить, например, ethernet1
	state строка	Варианты: present absent	Состояние конфигурации интерфейса L3. Указывает, должна ли конфигурация присутствовать или отсутствовать на удалённом устройстве.
ipv4 строка			IPv4-адрес, который нужно установить для интерфейса L3, упомянутого в параметре name. Формат адреса — <ipv4-адрес>/<маска>, маска — число в диапазоне 0–32, например, 192.168.0.1/24
ipv6 строка			IPv6-адрес, который нужно установить для интерфейса L3, упомянутого в параметре name. Формат адреса — <ipv6-адрес>/<маска>, маска — число в диапазоне 0–128, например, fd5d:12c9:2201:1::1/64
	name строка		Имя интерфейса L3, который нужно настроить, например, ethernet1
provider словарь			Устаревший Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli`. Начиная с Ansible 2.6, рекомендуется использовать `connection: httpapi` для eAPI. Этот параметр будет удалён в версии после 2022-06-01. Дополнительную информацию см. в руководстве EOS Platform Options. Словарь, содержащий сведения о подключении.
	auth_pass строка		Указывает пароль, который необходимо использовать для входа в привилегированный режим на удалённом устройстве. Если authorize равно false, этот аргумент ничего не делает. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_AUTH_PASS`.
	authorize булево	Варианты: нет ← да	Указывает модулю войти в привилегированный режим на удалённом устройстве перед отправкой каких-либо команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_AUTHORIZE`.
	host строка		Указывает имя хоста DNS или адрес для подключения к удалённому устройству по указанному транспорту. Значение параметра host используется в качестве адреса назначения для транспорта.
	password строка		Указывает пароль для аутентификации подключения к удалённому устройству. Этот параметр обычно используется для транспортов cli или eapi. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_PASSWORD`.
	port целое число	По умолчанию: 0	Указывает порт для создания подключения к удалённому устройству. Это значение относится к транспорту cli или eapi. Значение порта по умолчанию соответствует обычному порту транспорта, если он не указан в задаче (cli=22, http=80, https=443).
	ssh_keyfile путь		Указывает файл ключа SSH для аутентификации подключения к удалённому устройству. Этот параметр используется только для транспортов cli. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout целое число		Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечёт до завершения операции, модуль выдаст ошибку.
	transport строка	Варианты: cli ← eapi	Настраивает транспортное соединение для подключения к удалённому устройству.
	use_proxy булево	Варианты: нет да ←	Если `no`, переменные среды `http_proxy` и `https_proxy` будут проигнорированы.
	use_ssl булево	Варианты: нет да ←	Настраивает транспорт transport для использования SSL, если установлено `yes`, только когда `transport=eapi`. Если транспорт не eapi, это значение игнорируется.
	username строка		Указывает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации входа по CLI или аутентификации eAPI в зависимости от используемого транспорта. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_USERNAME`.
	validate_certs булево	Варианты: нет да ←	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с самозаверенными сертификатами. Если транспорт не eapi, это значение игнорируется.
state строка		Варианты: present ← absent	Состояние конфигурации интерфейса L3. Указывает, должна ли конфигурация присутствовать или отсутствовать на удалённом устройстве.

Примечания

Примечание

Проверено на EOS 4.15
Подробную информацию о использовании CLI, eAPI и привилегированного режима см. в руководстве EOS Platform Options
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве Ansible Network Guide
Дополнительную информацию об использовании Ansible для управления устройствами Arista EOS см. на странице интеграции Arista.

Примеры

- name: Remove ethernet1 IPv4 and IPv6 address
  arista.eos.eos_l3_interface:
    name: ethernet1
    state: absent

- name: Set ethernet1 IPv4 address
  arista.eos.eos_l3_interface:
    name: ethernet1
    ipv4: 192.168.0.1/24

- name: Set ethernet1 IPv6 address
  arista.eos.eos_l3_interface:
    name: ethernet1
    ipv6: fd5d:12c9:2201:1::1/64

- name: Set interface Vlan1 (SVI) IPv4 address
  arista.eos.eos_l3_interface:
    name: Vlan1
    ipv4: 192.168.0.5/24

- name: Set IP addresses on aggregate
  arista.eos.eos_l3_interface:
    aggregate:
    - {name: ethernet1, ipv4: 192.168.2.10/24}
    - {name: ethernet1, ipv4: 192.168.3.10/24, ipv6: fd5d:12c9:2201:1::1/64}

- name: Remove IP addresses on aggregate
  arista.eos.eos_l3_interface:
    aggregate:
    - {name: ethernet1, ipv4: 192.168.2.10/24}
    - {name: ethernet1, ipv4: 192.168.3.10/24, ipv6: fd5d:12c9:2201:1::1/64}
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
commands list / elements=string	всегда, за исключением платформ, использующих транспорт Netconf для управления устройством.	Список команд конфигурации режима, которые нужно отправить устройству Пример: ['interface ethernet1', 'ip address 192.168.0.1/24', 'ipv6 address fd5d:12c9:2201:1::1/64']

Статус

Этот модуль будет удален в крупном релизе после 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/arista/eos/eos_l3_interface_module.html