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

Примечание

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

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

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

Новое в версии 1.0.0: плагина 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`. Если аргумент transport не равен eapi, это значение игнорируется.
	username строка		Настраивает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации входа в CLI или аутентификации eAPI в зависимости от используемого транспорта. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_USERNAME`.
	validate_certs логическое	Варианты: нет да ←	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых сайтах с самозаверяющимися сертификатами. Если аргумент transport не равен eapi, это значение игнорируется.
state строка		Варианты: present ← absent	Состояние конфигурации интерфейса L3. Указывает, должна ли конфигурация присутствовать или отсутствовать на удалённом устройстве.

Примечания

Примечание

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

Примеры

- 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/arista/eos/eos_l3_interface_module.html