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

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

Описание
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
- Поддержка
- Автор

Описание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
additional_paths_install		Варианты: true false Значение по умолчанию: None	Устанавливает резервный путь в таблице маршрутизации и обеспечивает независимую от префикса конвергенцию (PIC) в случае отказа канала PE-CE.
additional_paths_receive		Варианты: true false Значение по умолчанию: None	Включает возможность приема дополнительных путей для всех соседей в рамках этой адресной семьи, для которых эта возможность не отключена.
additional_paths_selection		Значение по умолчанию: None	Настраивает возможность выбора дополнительных путей для префикса. Допустимые значения — строка, определяющая имя карты маршрутизации.
additional_paths_send		Варианты: true false Значение по умолчанию: None	Включает возможность отправки дополнительных путей для всех соседей в рамках этой адресной семьи, для которых эта возможность не отключена.
advertise_l2vpn_evpn		Варианты: true false Значение по умолчанию: None	Объявлять маршруты evpn.
afi обязательно		Варианты: ipv4 ipv6 vpnv4 vpnv6 l2vpn	Идентификатор адресной семьи.
asn обязательно			Номер автономной системы BGP. Допустимые значения — строка, целое число в ASPLAIN или ASDOT формате.
client_to_client		Варианты: true false Значение по умолчанию: None	Настройка отражения маршрутов клиент-клиент.
dampen_igp_metric		Значение по умолчанию: None	Укажите значение затухания для изменений метрики IGP в секундах. Допустимые значения — целое число и ключевое слово 'default'.
dampening_half_time		Значение по умолчанию: None	Укажите время полураспада в минутах для затухания переключений маршрутов. Допустимые значения — целое число и ключевое слово 'default'.
dampening_max_suppress_time		Значение по умолчанию: None	Укажите максимальное время подавления для стабилизации маршрута при затухании переключений маршрутов. Допустимые значения — целое число и ключевое слово 'default'.
dampening_reuse_time			Укажите время повторного использования маршрута при затухании переключений маршрутов. Допустимые значения — целое число и ключевое слово 'default'.
dampening_routemap		Значение по умолчанию: None	Укажите карту маршрутизации для затухания переключений маршрутов. Допустимые значения — строка, определяющая имя карты маршрутизации.
dampening_state		Варианты: true false Значение по умолчанию: None	Включить/выключить затухание переключений маршрутов.
dampening_suppress_time		Значение по умолчанию: None	Укажите время подавления маршрута при затухании переключений маршрутов. Допустимые значения — целое число и ключевое слово 'default'.
default_information_originate		Варианты: true false Значение по умолчанию: None	Объявление информации по умолчанию.
default_metric		Значение по умолчанию: None	Устанавливает значения метрик по умолчанию для маршрутов, перераспределённых в BGP. Допустимые значения — целое число или ключевое слово 'default'.
distance_ebgp		Значение по умолчанию: None	Устанавливает административную дистанцию для маршрутов eBGP. Допустимые значения — целое число или ключевое слово 'default'.
distance_ibgp		Значение по умолчанию: None	Устанавливает административную дистанцию для маршрутов iBGP. Допустимые значения — целое число или ключевое слово 'default'.
distance_local		Значение по умолчанию: None	Устанавливает административную дистанцию для локальных маршрутов BGP. Допустимые значения — целое число или ключевое слово 'default'.
inject_map		Значение по умолчанию: None	Массив имён карт маршрутизации, которые будут указывать префиксы для вставки. Каждый элемент массива должен сначала указывать имя inject-карты, затем имя exist-карты и необязательно ключевое слово copy-attributes, указывающее на то, что атрибуты должны быть скопированы из агрегата. Например [['lax_inject_map', 'lax_exist_map'], ['nyc_inject_map', 'nyc_exist_map', 'copy-attributes'], ['fsd_inject_map', 'fsd_exist_map']].
maximum_paths		Значение по умолчанию: None	Настраивает максимальное количество путей с одинаковой стоимостью для распределения нагрузки. Допустимое значение — целое число в диапазоне 1-64.
maximum_paths_ibgp		Значение по умолчанию: None	Настраивает максимальное количество путей ibgp с одинаковой стоимостью для распределения нагрузки. Допустимое значение — целое число в диапазоне 1-64.
networks		Значение по умолчанию: None	Настраиваемые сети. Допустимое значение — список префиксов сетей для объявления. Список должен быть в формате массива. Каждый элемент массива должен содержать адрес префикса и необязательную карту маршрутизации. Например [['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		Значение по умолчанию: None	Настройка карты маршрутизации для допустимых ближайших узлов. Допустимые значения — строка, определяющая имя карты маршрутизации.
provider		Значение по умолчанию: None	Устаревший Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli`. Этот параметр требуется только при использовании NX-API. Для получения дополнительной информации см. руководство NXOS Platform Options. Объект словаря, содержащий детали подключения.
	username		Настраивает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации входа в CLI или аутентификации nxapi в зависимости от используемого транспорта. Если значение не указано в задании, используется значение переменной окружения `ANSIBLE_NET_USERNAME`.
	authorize (добавлен в 2.5.3)	Варианты: нет ← да	Указывает модулю войти в привилегированный режим на удаленном устройстве перед отправкой любых команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задании, используется значение переменной окружения `ANSIBLE_NET_AUTHORIZE`.
	ssh_keyfile		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Этот параметр используется только для транспорта cli. Если значение не указано в задании, используется значение переменной окружения `ANSIBLE_NET_SSH_KEYFILE`.
	use_proxy (добавлен в 2.5)	Варианты: да ← нет	Если `no`, переменные окружения `http_proxy` и `https_proxy` будут игнорироваться.
	auth_pass (добавлен в 2.5.3)	Значение по умолчанию: none	Указывает пароль для входа в привилегированный режим на удаленном устройстве, если это необходимо. Если authorize имеет значение false, этот параметр ничего не делает. Если значение не указано в задании, используется значение переменной окружения `ANSIBLE_NET_AUTH_PASS`.
	host обязательно		Указывает имя хоста DNS или адрес для подключения к удаленному устройству по указанному транспорту. Значение host используется в качестве адреса назначения для транспорта.
	timeout (добавлен в 2.3)	Значение по умолчанию: 10	Устанавливает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истекает до завершения операции, модуль вернёт ошибку. NX-API может медленно отвечать на длительные команды (sh mac, sh bgp и т.д.).
	use_ssl	Варианты: да нет ←	Настраивает транспорт на использование SSL, если значение равно true, только когда `transport=nxapi`, в противном случае это значение игнорируется.
	password	Значение по умолчанию: None	Указывает пароль для аутентификации подключения к удалённому устройству. Это распространённый параметр, используемый как для транспорта cli, так и для nxapi. Если значение не указано в задании, используется значение переменной окружения `ANSIBLE_NET_PASSWORD`.

	validate_certs	Варианты: да нет По умолчанию: Нет	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с использованием самозаверяющих сертификатов. Если аргумент transport не равен nxapi, это значение игнорируется.
	port	По умолчанию: 0 (использовать стандартный порт)	Указывает порт, который необходимо использовать при установлении подключения к удалённому устройству. Это значение применимо как к cli, так и к nxapi. Значение порта по умолчанию будет соответствовать стандартному порту для выбранного транспорта, если оно не указано в задании. (cli=22, http=80, https=443).
	transport обязательно	По умолчанию: cli	Настраивает транспортное подключение, которое необходимо использовать при подключении к удалённому устройству. Аргумент transport поддерживает подключение к устройству по протоколам cli (ssh) или nxapi.
redistribute		По умолчанию: Нет	Список директив перераспределения. Разрешено несколько записей перераспределения. Список должен быть представлен в виде вложенного массива. Первый элемент каждого массива определяет исходный протокол для перераспределения, второй элемент определяет имя карты маршрутизации. Карта маршрутизации настоятельно рекомендуется, но может быть необязательной на некоторых платформах, в таком случае её можно опустить из списка массивов. Например [['direct', 'rm_direct'], ['lisp', 'rm_lisp']].
safi обязательно		Варианты: unicast multicast evpn	Идентификатор подсемейства адресов.
state		Варианты: present ← absent	Определяет, должно ли конфигурация присутствовать на устройстве или нет.
suppress_inactive		Варианты: true false По умолчанию: Нет	Опубликовывает только активные маршруты для пэров.
table_map		По умолчанию: Нет	Применить table-map для фильтрации маршрутов, загружаемых в URIB. Допустимые значения — строка.
table_map_filter		Варианты: true false По умолчанию: Нет	Фильтровать маршруты, отклоненные картой маршрутизации, и не загружать их в 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 Cisco integration page.

Примеры

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

Статус

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

Поддержка

Дополнительная информация о поддержке этого модуля 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.5/modules/nxos_bgp_af_module.html