cisco.nxos.nxos_vxlan_vtep – Управляет конечной точкой виртуализации сети VXLAN (NVE).

Примечание

Этот плагин входит в коллекцию cisco.nxos (версия 1.4.0).

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

Чтобы использовать его в плейбуке, укажите: cisco.nxos.nxos_vxlan_vtep.

Новое в версии 1.0.0: of cisco.nxos

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

Описание

Управляет интерфейсом наложения VXLAN Network Virtualization Endpoint (NVE), который завершает VXLAN-туннели.

Примечание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
description строка			Описание интерфейса NVE.
global_ingress_replication_bgp булево		Варианты: no yes	Настройка протокола репликации входящих пакетов как BGP для всех VNIs. Доступно на коммутаторах серии Nexus 9000, работающих под управлением NX-OS версии 9.2(x) или выше.
global_mcast_group_L2 строка			Глобальный IP-префикс для мультикаста L2 VNIs или ключевое слово 'default'. Доступно на коммутаторах серии Nexus 9000, работающих под управлением NX-OS версии 9.2(x) или выше.
global_mcast_group_L3 строка			Глобальный IP-префикс для мультикаста L3 VNIs или ключевое слово 'default'. Доступно на коммутаторах серии Nexus 9000, работающих под управлением NX-OS версии 9.2(x) или выше.
global_suppress_arp булево		Варианты: no yes	Включает подавление ARP для всех VNIs. Доступно на коммутаторах NX-OS 9K серии, работающих под управлением 9.2.x или выше.
host_reachability булево		Варианты: no yes	Укажите механизм объявления доступности хоста. Значение «true» указывает, что для объявления доступности хоста будет использоваться BGP. Значение «false» указывает, что для объявления доступности хоста не используется никакой протокол. Другие протоколы объявления доступности хоста (например, OpenFlow, контроллер и т. д.) не поддерживаются.
interface строка / обязательно			Имя интерфейса для конечной точки виртуализации сети VXLAN.
multisite_border_gateway_interface строка добавлено в 1.1.0 of cisco.nxos			Укажите интерфейс loopback, IP-адрес которого должен использоваться для интерфейса NVE Multisite Border-gateway. Доступно на определенных коммутаторах серии Nexus 9000, работающих под управлением NX-OS 7.0(3)I7(x) или выше. Укажите «default», чтобы удалить существующую конфигурацию шлюза.
provider словарь			Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli`. Начиная с Ansible 2.6, рекомендуется использовать `connection: httpapi` для NX-API. Этот параметр будет удален в релизе после 2022-06-01. Дополнительную информацию см. в руководстве по платформам NXOS. Объект словаря с данными подключения.
	auth_pass строка		Указывает пароль для входа в привилегированный режим на удаленном устройстве, если это необходимо. Если authorize равно false, этот аргумент ничего не делает. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_AUTH_PASS`.
	authorize булево	Варианты: нет ← да	Указывает модулю войти в привилегированный режим на удаленном устройстве перед отправкой любых команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_AUTHORIZE`.
	host строка		Указывает имя хоста DNS или адрес для подключения к удаленному устройству через указанный транспорт. Значение host используется как адрес назначения для транспорта.
	password строка		Указывает пароль для аутентификации подключения к удаленному устройству. Это общий аргумент, используемый для транспортов cli или nxapi. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_PASSWORD`.
	port целое число		Указывает порт для создания подключения к удаленному устройству. Это значение применяется к cli или nxapi. Значение порта будет по умолчанию соответствовать общему порту соответствующего транспорта, если он не указан в задаче. (cli=22, http=80, https=443).
	ssh_keyfile строка		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспорта cli. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout целое число		Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истечет до завершения операции, модуль выдаст ошибку. NX-API может медленно возвращать результаты при длительных командах (sh mac, sh bgp и т. д.).
	transport строка	Варианты: cli ← nxapi	Настраивает транспортное соединение для подключения к удаленному устройству. Аргумент transport поддерживает подключение к устройству через cli (ssh) или nxapi.
	use_proxy булево	Варианты: no да ←	Если `no`, переменные среды `http_proxy` и `https_proxy` будут проигнорированы.
	use_ssl булево	Варианты: нет ← да	Настраивает transport для использования SSL, если установлено значение `yes` только тогда, когда `transport=nxapi`, в противном случае это значение игнорируется.
	username строка		Настраивает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации входа в CLI или аутентификации nxapi в зависимости от используемого транспорта. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_USERNAME`.
	validate_certs булево	Варианты: нет ← да	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с использованием самозаверенных сертификатов. Если аргумент transport не равен nxapi, это значение игнорируется.
shutdown булево		Варианты: no yes	Административно отключает интерфейс NVE.
source_interface строка			Укажите интерфейс loopback, IP-адрес которого должен использоваться для интерфейса NVE.
source_interface_hold_down_time строка			Подавляет объявление IP-адреса loopback NVE до тех пор, пока наложение не стабилизируется.
state строка		Варианты: present ← absent	Определяет, должна ли конфигурация присутствовать на устройстве или нет.

Примечания

Примечание

Проверено на NXOSv 7.3.(0)D1(1) на VIRL
Модуль используется для управления свойствами NVE, а не для создания интерфейсов NVE. Используйте cisco.nxos.nxos_interface, если хотите это сделать.
state=absent удаляет интерфейс.
По умолчанию, где это поддерживается, восстанавливает значения параметров по умолчанию.
Дополнительную информацию об использовании CLI и NX-API см. в руководстве по платформам NXOS
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве по сетям Ansible
Дополнительную информацию об использовании Ansible для управления устройствами Cisco см. на странице интеграции Cisco.

Примеры

- cisco.nxos.nxos_vxlan_vtep:
    interface: nve1
    description: default
    host_reachability: true
    source_interface: Loopback0
    source_interface_hold_down_time: 30
    shutdown: default
    multisite_border_gateway_interface: Loopback0

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

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

Ключ	Возвращаемое значение	Описание
commands список / элементы=строка	всегда	команды, отправленные устройству Пример: ['interface nve1', 'source-interface loopback0', 'source-interface hold-down-time 30', 'description simple description', 'shutdown', 'host-reachability protocol bgp', 'multisite border-gateway interface loopback0']

Авторы

Gabriele Gerbino (@GGabriele)

© 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/cisco/nxos/nxos_vxlan_vtep_module.html