nxos_evpn_vni – Управляет идентификатором сети Cisco EVPN VXLAN (VNI)

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

Описание
Параметры
Примечания
Примеры
Значения возврата
Статус

Описание

Управляет конфигурациями идентификаторов сети VXLAN (VNI) Cisco Ethernet Virtual Private Network (EVPN) на устройстве Nexus.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
provider словарь			Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli`. Этот параметр требуется только при использовании NX-API. Дополнительная информация в руководстве NXOS Platform Options. Объект словаря с данными подключения.
	auth_pass строка добавлено в 2.5.3		Указывает пароль для входа в привилегированный режим на удаленном устройстве, если это необходимо. Если authorize равно false, этот аргумент не имеет значения. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_AUTH_PASS`.
	authorize логическое значение добавлено в 2.5.3	Варианты: нет ← да	Инструктирует модуль войти в привилегированный режим на удаленном устройстве перед отправкой команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_AUTHORIZE`.
	host строка / обязательно		Указывает имя хоста DNS или адрес для подключения к удаленному устройству по указанному транспорту. Значение host используется как адрес назначения для транспорта.
	password строка		Указывает пароль для аутентификации подключения к удаленному устройству. Этот аргумент обычно используется для транспортов cli или nxapi. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_PASSWORD`.
	port целое число	По умолчанию: "0 (использовать общий порт)"	Указывает порт для подключения к удаленному устройству. Это значение применяется к cli или nxapi. Если порт не задан в задаче, значение по умолчанию будет соответствовать обычному порту транспорта. (cli=22, http=80, https=443).
	ssh_keyfile строка		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспорта cli. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout целое число добавлено в 2.3	По умолчанию: 10	Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечет до завершения операции, модуль выдаст ошибку. NX-API может медленно возвращать данные при длительных командах (sh mac, sh bgp и т.д.).
	transport строка / обязательно	Варианты: cli ← nxapi	Настраивает транспортное соединение для подключения к удаленному устройству. Аргумент transport поддерживает подключение к устройству через cli (ssh) или nxapi.
	use_proxy логическое значение добавлено в 2.5	Варианты: нет да ←	Если `no`, переменные среды `http_proxy` и `https_proxy` будут проигнорированы.
	use_ssl логическое значение	Варианты: нет ← да	Настраивает transport для использования SSL, если установлено `yes`, только когда `transport=nxapi`, в противном случае это значение игнорируется.
	username строка		Настраивает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации входа в CLI или аутентификации nxapi в зависимости от используемого транспорта. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_USERNAME`.
	validate_certs логическое значение	Варианты: нет да ←	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых сайтах с использованием самозаверенных сертификатов. Если аргумент transport не nxapi, это значение игнорируется.
route_distinguisher - / обязательно			Различитель маршрутов VPN (RD). RD объединяется с префиксом IPv4 или IPv6, полученным маршрутизатором PE, для создания уникального глобального адреса.
route_target_both -			Включает/выключает настройки route-target для импорта и экспорта сообществ целевых сообществ с помощью одного свойства.
route_target_export -			Устанавливает расширенные сообщества route-target 'экспорт'.
route_target_import -			Устанавливает расширенные сообщества route-target 'импорт'.
state -		Варианты: present ← absent	Определяет, должно ли быть конфигурация на устройстве или нет.
vni - / обязательно			Идентификатор сети EVPN VXLAN.

Примечания

Примечание

Проверено на NXOSv 7.3.(0)D1(1) на VIRL
Значения по умолчанию, где поддерживаются, восстанавливают значения параметров по умолчанию.
Переопределение RD не допускается. Сначала необходимо установить значения по умолчанию, а затем перенастроить их.
route_target_both, route_target_import и route_target_export valid — список расширенных сообществ (например, [‘1.2.3.4:5’, ‘33:55’]) или ключевые слова ‘auto’ или ‘default’.
Свойство route_target_both не рекомендуется из-за несогласованного поведения свойства на различных платформах Nexus и версиях образа. По этой причине рекомендуется использовать явные свойства route_target_export и route_target_import вместо route_target_both.
Допустимые значения RD — строка в одном из форматов различителя маршрута, ключевое слово ‘auto’ или ключевое слово ‘default’.
Дополнительная информация о использовании CLI и NX-API находится в руководстве NXOS Platform Options
Дополнительная информация об использовании Ansible для управления сетевыми устройствами — в руководстве Ansible Network Guide
Дополнительная информация об использовании Ansible для управления устройствами Cisco — на странице интеграции Cisco integration.

Примеры

- name: vni configuration
  nxos_evpn_vni:
    vni: 6000
    route_distinguisher: "60:10"
    route_target_import:
      - "5000:10"
      - "4100:100"
    route_target_export: auto
    route_target_both: default

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

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

Ключ	Возвращаемое значение	Описание
commands list	всегда	Команды, отправленные на устройство Пример: ['evpn', 'vni 6000 l2', 'route-target import 5001:10']

Статус

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

Поддержка Red Hat

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

Авторы

Gabriele Gerbino (@GGabriele)

Подсказка

Если вы обнаружите какие-либо проблемы в данной документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 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/nxos_evpn_vni_module.html