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	По умолчанию: "none"	Указывает пароль для использования при входе в привилегированный режим на удаленном устройстве. Если authorize имеет значение false, этот аргумент ничего не делает. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_AUTH_PASS`.
	authorize boolean добавлен в 2.5.3	Варианты: no ← yes	Инструктирует модуль войти в привилегированный режим на удаленном устройстве перед отправкой любых команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, будет использовано значение переменной среды `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 - added in 2.3	Default: 10	Указывает тайм-аут в секундах для связи с сетевым устройством при подключении или отправке команд. Если тайм-аут истекает до завершения операции, модуль вернёт ошибку. NX-API может медленно возвращать результат при выполнении длительных команд (sh mac, sh bgp и т.д.).
	transport - / обязательно	Default: "cli"	Настраивает транспортное подключение для использования при подключении к удалённому устройству. Аргумент transport поддерживает подключение к устройству через cli (ssh) или nxapi.
	use_proxy boolean added in 2.5	Choices: no yes ←	Если `no`, переменные окружения `http_proxy` и `https_proxy` будут проигнорированы.
	use_ssl boolean	Choices: no ← yes	Настраивает transport для использования SSL, если значение равно true, только если `transport=nxapi`, в противном случае это значение игнорируется.
	username -		Настраивает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации входа в CLI или аутентификации nxapi в зависимости от используемого транспорта. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `ANSIBLE_NET_USERNAME`.
	validate_certs boolean	Choices: no yes	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на сайтах под собственным контролем, использующих самозаверенные сертификаты. Если аргумент transport не nxapi, это значение игнорируется.
redistribute -			Список директив redistribute. Разрешено несколько записей redistribute. Список должен быть в виде вложенного массива. Первый элемент каждого массива определяет исходный протокол, из которого происходит перераспределение; второй элемент определяет имя карты маршрутизации. Карта маршрутизации настоятельно рекомендуется, но может быть необязательной на некоторых платформах, в таком случае её можно опустить из списка массивов. Например [['direct', 'rm_direct'], ['lisp', 'rm_lisp']].
safi - / обязательно		Choices: unicast multicast evpn	Идентификатор подсемейства адресов.
state -		Choices: present ← absent	Определяет, должна ли конфигурация присутствовать на устройстве или нет.
suppress_inactive boolean		Choices: no yes	Рекламирует только активные маршруты peer'ам.
table_map -			Применение table-map для фильтрации маршрутов, загружаемых в URIB. Допустимые значения — строка.
table_map_filter boolean		Choices: no yes	Фильтрует маршруты, отклоненные картой маршрутизации, и не загружает их в 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
Дополнительную информацию об использовании 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']

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [preview]
Этот модуль поддерживается командой 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.7/modules/nxos_bgp_af_module.html