nxos_bgp_af – Управляет настройками семейства адресов BGP

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

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Краткое описание

Управляет конфигурациями семейств адресов BGP на коммутаторах NX-OS.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
additional_paths_install boolean		Варианты: no yes	Установить резервный путь в таблицу переадресации и обеспечить независимую конвергенцию (PIC) в случае отказа канала PE-CE.
additional_paths_receive boolean		Варианты: no yes	Включает возможность приема дополнительных путей для всех соседей в рамках данной адресной семьи, для которых эта возможность не была отключена.
additional_paths_selection -			Настраивает возможность выбора дополнительных путей для префикса. Допустимые значения — строка, определяющая имя карты маршрутизации.
additional_paths_send boolean		Варианты: no yes	Включает возможность отправки дополнительных путей для всех соседей в рамках данной адресной семьи, для которых эта возможность не была отключена.
advertise_l2vpn_evpn boolean		Варианты: no yes	Рекламировать маршруты evpn.
afi - / обязательно		Варианты: ipv4 ipv6 vpnv4 vpnv6 l2vpn	Идентификатор адресной семьи.
asn - / обязательно			Номер автономной системы BGP. Допустимые значения — строка, целое число в ASPLAIN или ASDOT формате.
client_to_client boolean		Варианты: no yes	Настройка отражения маршрутов клиент-клиент.
dampen_igp_metric -			Указать значение затухания для изменений метрики IGP в секундах. Допустимые значения — целое число и ключевое слово «default».
dampening_half_time -			Указать время полураспада в минутах для затухания маршрутов-флапов. Допустимые значения — целое число и ключевое слово «default».
dampening_max_suppress_time -			Указать максимальное время подавления для затухания маршрутов-флапов устойчивых маршрутов. Допустимые значения — целое число и ключевое слово «default».
dampening_reuse_time -			Указать время повторного использования маршрута для затухания маршрутов-флапов. Допустимые значения — целое число и ключевое слово «default».
dampening_routemap -			Указать карту маршрутизации для затухания маршрутов-флапов. Допустимые значения — строка, определяющая имя карты маршрутизации.
dampening_state boolean		Варианты: no yes	Включить/выключить затухание маршрутов-флапов.
dampening_suppress_time -			Указать время подавления маршрута для затухания маршрутов-флапов. Допустимые значения — целое число и ключевое слово «default».
default_information_originate boolean		Варианты: no yes	Инициализация информации по умолчанию.
default_metric -			Устанавливает метрики по умолчанию для маршрутов, перераспределённых в BGP. Допустимые значения — целое число или ключевое слово «default».
distance_ebgp -			Устанавливает административную дистанцию для маршрутов eBGP. Допустимые значения — целое число или ключевое слово «default».
distance_ibgp -			Устанавливает административную дистанцию для маршрутов iBGP. Допустимые значения — целое число или ключевое слово «default».
distance_local -			Устанавливает административную дистанцию для локальных маршрутов BGP. Допустимые значения — целое число или ключевое слово «default».
inject_map -			Массив имён карт маршрутизации, которые будут определять префиксы для инъекции. Каждый элемент массива должен сначала указать имя карты инъекции, затем имя карты существования и, необязательно, ключевое слово copy-attributes, которое указывает на копирование атрибутов из агрегата. Например [['lax_inject_map', 'lax_exist_map'], ['nyc_inject_map', 'nyc_exist_map', 'copy-attributes'], ['fsd_inject_map', 'fsd_exist_map']].
maximum_paths -			Настраивает максимальное количество путей с равной стоимостью для распределения нагрузки. Допустимое значение — целое число в диапазоне от 1 до 64.
maximum_paths_ibgp -			Настраивает максимальное количество путей ibgp с равной стоимостью для распределения нагрузки. Допустимое значение — целое число в диапазоне от 1 до 64.
networks -			Настраиваемые сети. Допустимое значение — список префиксов сетей для рекламы. Список должен быть представлен в виде массива. Каждый элемент массива должен включать адрес префикса и необязательную карту маршрутизации. Например [['10.0.0.0/16', 'routemap_LA'], ['192.168.1.1', 'Chicago'], ['192.168.2.0/24'], ['192.168.3.0/24', 'routemap_NYC']].
next_hop_route_map -			Настройка карты маршрутизации для допустимых следущих узлов. Допустимые значения — строка, определяющая имя карты маршрутизации.
provider словарь			Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli`. Этот параметр требуется только если вы используете NX-API. Для получения дополнительной информации, обратитесь к руководству NXOS Platform Options. Объект словаря, содержащий детали подключения.
	auth_pass строка добавлено в 2.5.3		Указывает пароль для входа в привилегированный режим на удалённом устройстве. Если authorize ложно, этот аргумент не имеет значения. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_AUTH_PASS`.
	authorize boolean добавлено в 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, это значение игнорируется.
redistribute -			Список директив redistribute. Разрешено несколько записей redistribute. Список должен быть в виде вложенного массива. Первая запись каждого массива определяет исходный протокол для перераспределения; вторая запись определяет имя карты маршрутизации. Карта маршрутизации настоятельно рекомендуется, но может быть необязательной на некоторых платформах, в этом случае она может быть опущена из списка массивов. Например [['direct', 'rm_direct'], ['lisp', 'rm_lisp']].
safi - / обязательно		Варианты: unicast multicast evpn	Идентификатор подсемейства адресов.
state -		Варианты: present ← absent	Определяет, должно ли конфигурация присутствовать на устройстве или нет.
suppress_inactive логическое значение		Варианты: нет да	Рекламирует только активные маршруты peer.
table_map -			Применить таблицу-карту для фильтрации маршрутов, загружаемых в URIB. Допустимые значения — строка.
table_map_filter логическое значение		Варианты: нет да	Фильтровать маршруты, отклоненные картой маршрутизации, и не загружать их в RIB.
vrf - / обязательно			Имя VRF. Имя 'default' является допустимым VRF, представляющим глобальный bgp.

Примечания

Примечание

Проверено на NXOSv 7.3.(0)D1(1) на VIRL
state=absent удаляет всю конфигурацию ASN BGP
По умолчанию, где поддерживается, восстанавливает значения параметров по умолчанию.
Сведения об использовании CLI и NX-API см. в руководстве NXOS Platform Options
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве Ansible Network Guide
Дополнительную информацию об использовании Ansible для управления устройствами Cisco см. на странице интеграции Cisco .

Примеры

# configure a simple address-family
- nxos_bgp_af:
    asn: 65535
    vrf: TESTING
    afi: ipv4
    safi: unicast
    advertise_l2vpn_evpn: true
    state: present

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

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

Ключ	Возвращаемое значение	Описание
commands список	всегда	Команды, отправленные на устройство Пример: ['router bgp 65535', 'vrf TESTING', 'address-family ipv4 unicast', 'advertise l2vpn evpn']

Статус

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

Поддержка Red Hat

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

Авторы

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_bgp_af_module.html