nxos_bgp_af — Управляет конфигурацией семейств адресов BGP.

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

Описание
Параметры
Примеры
Возвращаемые значения
Примечания
- Статус
- Информация о техническом обслуживании

Описание

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

Параметры

Параметр	Обязательно	По умолчанию	Варианты	Комментарии
additional_paths_install	нет		true false	Устанавливает резервный путь в таблицу перенаправления и обеспечивает независимую от префикса конвергенцию (PIC) в случае отказа канала PE-CE.
additional_paths_receive	нет		true false	Включает возможность приема дополнительных путей для всех соседей в этой адресной семье, для которых эта возможность не отключена.
additional_paths_selection	нет			Настраивает возможность выбора дополнительных путей для префикса. Допустимые значения — строка, определяющая имя карты маршрутов.
additional_paths_send	нет		true false	Включает возможность отправки дополнительных путей для всех соседей в этой адресной семье, для которых эта возможность не отключена.
advertise_l2vpn_evpn	нет		true false	Рекламировать маршруты evpn.
afi	да		ipv4 ipv6 vpnv4 vpnv6 l2vpn	Идентификатор адресной семьи.
asn	да			Номер автономной системы BGP. Допустимые значения — строка, целое число в обозначении ASPLAIN или ASDOT.
auth_pass (добавлен в 2.4.4)	нет	none		Указывает пароль для входа в привилегированный режим на удаленном устройстве, если это необходимо. Если authorize равно false, этот аргумент не имеет значения. Если значение не указано в задании, используется значение переменной среды `ANSIBLE_NET_AUTH_PASS`.
authorize (добавлен в 2.4.4)	нет		да нет	Указывает модулю войти в привилегированный режим на удаленном устройстве перед отправкой любых команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задании, используется значение переменной среды `ANSIBLE_NET_AUTHORIZE`.
client_to_client	нет		true false	Настройка отражения маршрутов клиент-клиент.
dampen_igp_metric	нет			Укажите значение ослабления для изменений метрики IGP в секундах. Допустимые значения — целое число и ключевое слово 'default'.
dampening_half_time	нет			Укажите время полураспада в минутах для ослабления маршрутов с помехами. Допустимые значения — целое число и ключевое слово 'default'.
dampening_max_suppress_time	нет			Укажите максимальное время подавления для стабильного маршрута с помехами в маршруте. Допустимые значения — целое число и ключевое слово 'default'.
dampening_reuse_time	нет			Укажите время повторного использования маршрута для ослабления маршрута с помехами. Допустимые значения — целое число и ключевое слово 'default'.
dampening_routemap	нет			Укажите карту маршрутов для ослабления маршрутов с помехами. Допустимые значения — строка, определяющая имя карты маршрутов.
dampening_state	нет		true false	Включить/выключить ослабление маршрутов с помехами.
dampening_suppress_time	нет			Укажите время подавления маршрута для ослабления маршрута с помехами. Допустимые значения — целое число и ключевое слово 'default'.
default_information_originate	нет		true false	Происхождение информации по умолчанию.
default_metric	нет			Устанавливает значения метрик по умолчанию для маршрутов, перераспределенных в BGP. Допустимые значения — целое число или ключевое слово 'default'.
distance_ebgp	нет			Устанавливает административную дистанцию для маршрутов eBGP. Допустимые значения — целое число или ключевое слово 'default'.
distance_ibgp	нет			Устанавливает административную дистанцию для маршрутов iBGP. Допустимые значения — целое число или ключевое слово 'default'.
distance_local	нет			Устанавливает административную дистанцию для локальных маршрутов BGP. Допустимые значения — целое число или ключевое слово 'default'.
host	да			Указывает имя хоста DNS или адрес для подключения к удаленному устройству через указанный транспорт. Значение host используется в качестве адреса назначения для транспорта.
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	нет			Настройка карты маршрутов для допустимых следующего хоста. Допустимые значения — строка, определяющая имя карты маршрутов.
password	нет			Указывает пароль для аутентификации подключения к удаленному устройству. Этот аргумент обычно используется для транспортов cli или nxapi. Если значение не указано в задании, используется значение переменной среды `ANSIBLE_NET_PASSWORD`.
port	нет	0 (использовать общий порт)		Указывает порт для подключения к удаленному устройству. Это значение относится к транспорту cli или nxapi. Значение порта по умолчанию — соответствующий общий порт транспорта, если он не указан в задании (cli=22, http=80, https=443).
provider	нет			Удобный метод, позволяющий передавать все аргументы nxos в виде объекта словаря. Все ограничения (обязательность, варианты и т. д.) должны быть выполнены либо отдельными аргументами, либо значениями в этом словаре.
redistribute	нет			Список директив перераспределения. Разрешается несколько записей перераспределения. Список должен иметь вид вложенного массива. Первый элемент каждого массива определяет исходный протокол для перераспределения; второй элемент определяет имя карты маршрутов. Карта маршрутов настоятельно рекомендуется, но может быть необязательной на некоторых платформах, в этом случае она может быть опущена из списка массивов. Например [['direct', 'rm_direct'], ['lisp', 'rm_lisp']].
safi	да		unicast multicast evpn	Идентификатор подадресной семьи.
ssh_keyfile	нет			Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспорта cli. Если значение не указано в задании, используется значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
state	нет	present	present absent	Определяет, должен ли конфиг присутствовать на устройстве или нет.
suppress_inactive	нет		true false	Рекламировать только активные маршруты peer'ам.
table_map	нет			Применить table-map для фильтрации маршрутов, загружаемых в URIB. Допустимые значения — строка.
table_map_filter	нет		true false	Фильтрует маршруты, отклоненные картой маршрутов, и не загружает их в RIB.
timeout (добавлен в 2.3)	нет	10		Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истекает до завершения операции, модуль выдаст ошибку. NX-API может медленно возвращать результаты при выполнении длительных команд (sh mac, sh bgp и т. д.).
transport	да	cli		Настройка транспортного подключения для подключения к удаленному устройству. Аргумент transport поддерживает подключение к устройству через cli (ssh) или nxapi.
use_ssl	нет		да нет	Настройка транспорта transport на использование SSL, если значение равно true, только когда `transport=nxapi`, в противном случае это значение игнорируется.
username	нет			Настраивает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации входа в CLI или аутентификации nxapi в зависимости от используемого транспорта. Если значение не указано в задании, используется значение переменной среды `ANSIBLE_NET_USERNAME`.
validate_certs	нет		да нет	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых вами сайтах, использующих самозаверяющие сертификаты. Если аргумент transport не равен nxapi, это значение игнорируется.
vrf	да			Имя VRF. Имя 'default' — допустимое VRF, представляющее глобальный bgp.

Примеры

# 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']

Примечания

Примечание

Тестировано на NXOSv 7.3.(0)D1(1) на VIRL
state=absent удаляет всю конфигурацию ASN BGP
По умолчанию, где поддерживается, восстанавливает значения параметров по умолчанию.

Статус

Этот модуль помечен как превью, что означает, что гарантии обратной совместимости нет.

Информация о техническом обслуживании

Для получения дополнительной информации о поддержке данного модуля компанией Red Hat, пожалуйста, обратитесь к этому knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>

Для получения помощи в разработке модулей, если это необходимо, пожалуйста, прочитайте Информацию о сообществе и участии, Тестирование Ansible и Разработка модулей.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/nxos_bgp_af_module.html