Модуль cisco.iosxr.iosxr_bgp_global — модуль ресурсов для настройки BGP.
Примечание
Этот модуль входит в коллекцию cisco.iosxr (версия 12.3.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install cisco.iosxr.
Чтобы использовать коллекцию в плейбуке, укажите: cisco.iosxr.iosxr_bgp_global.
Добавлено в cisco.iosxr 2.0.0
Краткое описание
- Этот модуль настраивает атрибуты глобальной конфигурации BGP и управляет ими на платформах Cisco IOS-XR.
Примечание
Этому модулю соответствует плагин действий.
Псевдонимы: bgp_global
Параметры
Параметр | Комментарии |
|---|---|
config dictionary | Список конфигураций для глобальных параметров BGP. |
|
as_number string |
Номер автономной системы маршрутизатора. |
|
bfd dictionary |
Настройка параметров BFD. |
|
minimum_interval integer |
Задает минимальный интервал сеанса BFD для соседа. |
|
multiplier integer |
Задает значение множителя сеанса BFD для соседа. |
|
bgp dictionary |
Параметры BGP. |
|
as_path_loopcheck boolean |
Включить проверку циклов AS-path для соседей iBGP. Варианты:
|
|
auto_policy_soft_reset dictionary |
Включить автоматический мягкий сброс соседей при изменении политики. |
|
disable boolean |
Отключить автоматический мягкий сброс соседей протокола BGP. Варианты:
|
|
bestpath dictionary |
Выбрать алгоритм определения наилучшего пути для маршрутов BGP. |
|
aigp dictionary |
Атрибут AIGP |
|
ignore boolean |
Игнорировать атрибут AIGP. Варианты:
|
|
as_path dictionary |
Выбирать наилучший путь на основе AS-path. |
|
ignore boolean |
Игнорировать Варианты:
|
|
multipath_relax boolean |
Ослабление критериев multipath Варианты:
|
|
compare_routerid boolean |
Сравнивать router-id для идентичных путей EBGP. Варианты:
|
|
cost_community dictionary |
Сообщество стоимости. |
|
ignore boolean |
Игнорировать cost_community Варианты:
|
|
med dictionary |
Атрибут MED |
|
always boolean |
Разрешить сравнение MED от разных соседей. Варианты:
|
|
confed boolean |
Сравнивать MED для путей конфедерации. Варианты:
|
|
missing_as_worst boolean |
Считать отсутствующий MED наименее предпочтительным. Варианты:
|
|
origin_as dictionary |
Параметры origin-AS для BGP. |
|
allow dictionary |
Параметры origin-AS для BGP. |
|
invalid boolean |
При выборе наилучшего пути BGP будет разрешен недействительный origin-AS. Варианты:
|
|
use dictionary |
Параметры origin-AS для BGP. |
|
validity boolean |
При выборе наилучшего пути BGP будет учитываться достоверность origin-AS. Варианты:
|
|
cluster_id string |
Идентификатор кластера этого маршрутизатора, работающего в качестве рефлектора маршрутов. |
|
confederation dictionary |
Конфедерация. |
|
identifier integer |
Задать AS конфедерации для домена маршрутизации. |
|
peers list / elements=integer |
Указать AS соседей в режиме конфедерации BGP. |
|
default dictionary |
Настроить значение по умолчанию. |
|
local_preference integer |
Локальное предпочтение. Допустимые значения см. в документации поставщика. |
|
enforce_first_as dictionary |
Обязательное использование первой AS для маршрутов EBGP. |
|
disable boolean |
Отключить проверку первой AS. Варианты:
|
|
fast_external_fallover dictionary |
Немедленно сбросить сеанс при разрыве связи с непосредственно подключенным внешним соседом. |
|
disable boolean |
Отключить быстрое переключение внешнего соединения. Варианты:
|
|
graceful_restart dictionary |
Включить поддержку плавного перезапуска. |
|
graceful_reset boolean |
Выполнить плавный сброс, если изменение конфигурации требует сброса соседнего узла. Варианты:
|
|
purge_time integer |
Время до удаления устаревших маршрутов в секундах <1-6000>. |
|
restart_time integer |
Время перезапуска, объявляемое соседям, в секундах <1-4095>. |
|
set boolean |
Включить graceful-restart. Варианты:
|
|
stalepath_time integer |
Максимальное время ожидания перезапуска соседей с поддержкой GR в секундах <1-4095>. |
|
install dictionary |
Установить путь перенаправления в RIB/CEF. |
|
diversion boolean |
Установить путь перенаправления в RIB/CEF. Варианты:
|
|
log dictionary |
Записывать сведения BGP в журнал |
|
log_message dictionary |
Записывать в журнал входящие и исходящие сообщения соседей. |
|
disable boolean |
Отключить запись входящих и исходящих сообщений. Варианты:
|
|
neighbor dictionary |
Записывать в журнал сведения о состоянии соседей. |
|
changes dictionary |
Записывать в журнал события подключения и отключения соседей, а также причину сброса. |
|
detail boolean |
Подробности Варианты:
|
|
disable boolean |
Отключить Варианты:
|
|
maximum dictionary |
Максимальное количество соседей, которое можно настроить |
|
neighbor integer |
Максимальное количество соседей <1-15000>. |
|
multipath dictionary |
Изменить критерии выбора multipath |
|
as_path dictionary |
Путь AS |
|
ignore dictionary |
Игнорировать проверки, связанные с AS-path, при выборе multipath. |
|
onwards boolean |
Игнорировать все последующие элементы AS-path при выборе multipath. Варианты:
|
|
origin_as dictionary |
Параметры origin-AS для BGP. |
|
validation dictionary |
Параметры проверки origin-AS для BGP. |
|
disable boolean |
Отключить проверку origin-AS с помощью RPKI. Варианты:
|
|
signal dictionary |
Передавать соседям сведения о достоверности origin-AS. |
|
ibgp boolean |
Передавать сведения о достоверности origin-AS соседям iBGP. Варианты:
|
|
time dictionary |
Время ожидания между обновлением RPKI и обходом таблицы BGP. |
|
time_in_second integer |
Время проверки префикса (в секундах). |
|
time_off boolean |
Не выполнять автоматическую проверку префиксов после обновления RPKI. Варианты:
|
|
redistribute_internal boolean |
Перераспределять внутренние маршруты BGP. Варианты:
|
|
router_id string |
Настроить идентификатор маршрутизатора. Например, IPv4-адрес A.B.C.D. |
|
scan_time integer |
Настроить интервал фонового сканирования для универсального сканера. Например, <5-3600>. |
|
unsafe_ebgp_policy boolean |
Разрешить соседям eBGP без политики передавать все маршруты (поддержка Cisco). Варианты:
|
|
update_delay integer |
Задать максимальную начальную задержку перед отправкой обновлений. Например, <0-3600> секунд. |
|
default_information dictionary |
Управление распространением информации о маршруте по умолчанию. |
|
originate boolean |
Распространять маршрут по умолчанию Варианты:
|
|
default_metric integer |
Метрика по умолчанию. Например, <1-4294967295>. |
|
graceful_maintenance dictionary |
Позволяет плавно вводить маршрутизатор в эксплуатацию или выводить его из эксплуатации. |
|
activate string |
Все соседи с конфигурацией graceful-maintenance Варианты:
|
|
ibgp dictionary |
Настройка параметров для соседей iBGP. |
|
policy dictionary |
Настройка параметров политики маршрутизации. |
|
out dictionary |
Настройка параметров исходящей политики. |
|
enforce_modifications boolean |
Разрешить политике изменять все атрибуты. Варианты:
|
|
mpls dictionary |
Включить параметры MPLS. |
|
activate dictionary |
Перевести интерфейсы MPLS в режим активации MPLS в BGP. |
|
interface string |
Имя интерфейса, на котором нужно включить MPLS. |
|
mvpn boolean |
Подключиться к PIM/PIM6. Варианты:
|
|
neighbors list / elements=dictionary |
Указать соседний маршрутизатор. |
|
advertisement_interval integer |
Минимальный интервал между отправкой обновлений маршрутизации BGP. Например, <0-600>. |
|
bfd dictionary |
Настроить параметры BFD. |
|
fast_detect dictionary |
Включить быстрое обнаружение |
|
disable boolean |
Запретить наследование параметров BFD от родительского объекта. Варианты:
|
|
set boolean |
Включить fast-detect Варианты:
|
|
strict_mode boolean |
Удерживать сеанс с соседом до установления сеанса BFD Варианты:
|
|
minimum_interval integer |
Задает значение минимального интервала сеанса BFD для соседа. |
|
multiplier integer |
Задает значение множителя сеанса BFD для соседа. |
|
bmp_activate dictionary |
Включить ведение журнала BMP для этого соседа. |
|
server integer |
Включить соединение BMP с указанным сервером. Например, <1-8>. |
|
capability dictionary |
Объявить возможности соседу. |
|
additional_paths dictionary |
Команды BGP additional-paths. |
|
receive dictionary |
Возможность приема дополнительных путей |
|
disable boolean |
Настроить возможность приема Варианты:
|
|
set boolean |
Настроить возможность приема Варианты:
|
|
send dictionary |
Возможность отправки дополнительных путей |
|
disable boolean |
Настроить возможность отправки Варианты:
|
|
set boolean |
Настроить возможность отправки Варианты:
|
|
suppress dictionary |
Не объявлять возможности соседу. |
|
all dictionary |
Все возможности |
|
inheritance_disable boolean |
Не наследовать эту конфигурацию от родительской группы. Варианты:
|
|
set boolean |
Настроить все. Варианты:
|
|
four_byte_AS dictionary |
Возможность для 4-байтового номера AS |
|
set boolean |
Настроить 4_byte_as. Варианты:
|
|
cluster_id string |
Идентификатор кластера этого маршрутизатора, выступающего в роли маршрутного рефлектора. |
|
description string |
Описание конкретного соседа. |
|
dmz_link_bandwidth dictionary |
Распространять пропускную способность канала DMZ. |
|
inheritance_disable boolean |
Не наследовать эту конфигурацию от родительской группы. Варианты:
|
|
set boolean |
Настроить dmz-link-bandwidth. Варианты:
|
|
dscp string |
Задать IP DSCP (кодовую точку DiffServ). Допустимые значения см. в документации производителя. |
|
ebgp_multihop dictionary |
Разрешить соседей EBGP, находящихся не в непосредственно подключенных сетях. |
|
mpls boolean |
Отключить пересылку BGP MPLS. Варианты:
|
|
value integer |
Максимальное число переходов. Например, <1-255>. |
|
ebgp_recv_extcommunity_dmz dictionary |
Принимать от соседа ebgp расширенное сообщество с пропускной способностью канала DMZ. |
|
inheritance_disable boolean |
Запретить наследование ebgp-recv-community-dmz от родительского объекта Варианты:
|
|
set boolean |
Настроить ebgp-recv-community-dmz. Варианты:
|
|
ebgp_send_extcommunity_dmz dictionary |
Отправлять соседу ebgp расширенное сообщество с пропускной способностью канала DMZ. |
|
cumulatie boolean |
Отправлять соседу ebgp накопленную пропускную способность канала DMZ из сообщества для всех многопутевых маршрутов. Варианты:
|
|
inheritance_disable boolean |
Запретить наследование ebgp-send-community-dmz от родительского объекта Варианты:
|
|
set boolean |
Настроить ebgp-send-community-dmz. Варианты:
|
|
egress_engineering dictionary |
Включить управление исходящим трафиком для этого соседа. |
|
inheritance_disable boolean |
Запретить наследование egress-engineering от родительского объекта Варианты:
|
|
set boolean |
установить egress-engineering. Варианты:
|
|
enforce_first_as dictionary |
Требовать указание первой AS для маршрутов EBGP |
|
disable boolean |
отключить требование 1-й AS Варианты:
|
|
graceful_maintenance dictionary |
Атрибуты для режима Graceful Maintenance. Это заставит соседние устройства отдавать предпочтение другим маршрутам, а не маршрутам от этого маршрутизатора. Это позволяет плавно выводить маршрутизатор из обслуживания и возвращать его в работу. |
|
activate dictionary |
При активации здесь или в конфигурации маршрутизатора BGP маршруты будут анонсироваться с атрибутами Graceful Maintenance. |
|
inheritance_disable boolean |
Запретить наследование activate от родительского элемента. Варианты:
|
|
set boolean |
активировать. Варианты:
|
|
as_prepends dictionary |
Количество добавлений номера локальной AS к пути AS маршрутов. По умолчанию=0 |
|
inheritance_disable boolean |
Запретить наследование параметра as prepends от родительского элемента. Варианты:
|
|
value integer |
Диапазон значений для as prepends. Пример: <0-6> . |
|
local_preference dictionary |
Значение local preference, с которым маршруты анонсируются соседям iBGP. По умолчанию=не изменять |
|
inheritance_disable boolean |
Запретить наследование local preference от родительского элемента. Варианты:
|
|
value integer |
Диапазон значений для Local Preference. Пример: <0-4294967295> . |
|
set boolean |
включить режим graceful maintenance. Варианты:
|
|
graceful_restart dictionary |
Включить поддержку graceful restart для этого соседа. |
|
restart_time integer |
Время перезапуска, объявляемое соседям, в секундах <1-4095>. |
|
stalepath_time integer |
Максимальное время ожидания перезапуска узлов, поддерживающих GR, в секундах <1-4095>. |
|
ignore_connected_check dictionary |
Отключить проверку непосредственно подключенного следующего перехода для однохопового пиринга eBGP |
|
inheritance_disable boolean |
Запретить наследование ignore-connected-check от родительского элемента Варианты:
|
|
set boolean |
установить ignore-connected-check. Варианты:
|
|
keychain dictionary |
Настроить аутентификацию на основе цепочки ключей. |
|
inheritance_disable boolean |
Запретить наследование цепочки ключей от родительского элемента. Варианты:
|
|
name string |
Имя цепочки ключей — не более 32 символов. |
|
local dictionary |
Настроить локальный параметр |
|
address dictionary |
Адрес IPv4 |
|
inheritance_disable boolean |
Запретить наследование локального адреса от родительского элемента. Варианты:
|
|
ipv4_address string |
Адрес IPv4 <A.B.C.D>. |
|
local_as dictionary |
Указать номер локальной AS. |
|
inheritance_disable boolean |
Запретить наследование локальной AS от родительского элемента. Варианты:
|
|
no_prepend dictionary |
Не добавлять локальную AS к анонсам от этого соседа. |
|
replace_as dictionary |
Добавлять к анонсам этому соседу только локальную AS. |
|
dual_as boolean |
Режим Dual-AS. Варианты:
|
|
set boolean |
Добавлять к анонсам этому соседу только локальную AS. Варианты:
|
|
set boolean |
Не добавлять локальную AS к анонсам от этого соседа. Варианты:
|
|
value integer |
Номер AS из 2 или 4 байт |
|
log dictionary |
Регистрация сообщений об обновлении для каждого соседа. |
|
log_message dictionary |
Регистрация сообщений об обновлении/уведомлении для каждого соседа. |
|
in dictionary |
Входящие сообщения журнала |
|
disable boolean |
Отключить регистрацию входящих сообщений. Варианты:
|
|
inheritance_disable boolean |
Запретить наследование журнала сообщений от родительского элемента. Варианты:
|
|
value integer |
Диапазон размера буфера журнала сообщений <1-100>. |
|
out dictionary |
Исходящие сообщения журнала |
|
disable boolean |
Отключить регистрацию входящих сообщений. Варианты:
|
|
inheritance_disable boolean |
Запретить наследование журнала сообщений от родительского элемента. Варианты:
|
|
value integer |
Диапазон размера буфера журнала сообщений <1-100>. |
|
neighbor_address псевдонимы: neighbor string / обязательный |
Адрес маршрутизатора-соседа. |
|
origin_as dictionary |
Параметры BGP origin-AS. |
|
validation dictionary |
Параметры проверки BGP origin-AS. |
|
disable boolean |
Отключить проверку origin-AS с помощью RPKI. Варианты:
|
|
password dictionary |
Задать пароль. |
|
encrypted string |
Указывает, что далее будет указан ЗАШИФРОВАННЫЙ пароль. |
|
inheritance_disable boolean |
Запретить наследование пароля от родительского элемента. Варианты:
|
|
receive_buffer_size integer |
Задать размер буфера приема сокета и BGP. Пример: <512-131072>. |
|
remote_as string |
Автономная система соседа. |
|
send_buffer_size integer |
Задать размер буфера отправки сокета и BGP. Пример: <4096-131072>. |
|
session_open_mode string |
Установить сеанс BGP, используя этот режим открытия TCP. Варианты:
|
|
shutdown dictionary |
Административно отключить этого соседа. |
|
inheritance_disable boolean |
Запретить наследование состояния shutdown от родительского элемента Варианты:
|
|
set boolean |
отключить. Варианты:
|
|
tcp dictionary |
Команды настройки сеанса TCP. |
|
mss dictionary |
Максимальный размер сегмента. |
|
inheritance_disable boolean |
Запретить наследование MSS от родительского элемента Варианты:
|
|
value integer |
Начальный максимальный размер сегмента TCP. |
|
timers dictionary |
Таймеры BGP для каждого соседа. |
|
holdtime integer |
Время удержания <3-65535> или 0 — отключить время удержания. |
|
keepalive_time integer |
Интервал keepalive <0-65535>. |
|
ttl_security dictionary |
Включить защиту EBGP с помощью TTL. |
|
inheritance_disable boolean |
Запретить наследование настройки ttl-security от родительского элемента Варианты:
|
|
set boolean |
Установить ttl-security Варианты:
|
|
update dictionary |
Конфигурация обновлений BGP. |
|
in dictionary |
Обработка входящих сообщений обновления. |
|
filtering dictionary |
Фильтрация входящих сообщений обновления |
|
attribute_filter dictionary |
Настройка фильтра атрибутов. |
|
group string |
Имя группы. |
|
logging dictionary |
Сообщение syslog о фильтрации обновлений. |
|
disable boolean |
Отключить сообщение syslog о фильтрации обновлений. Варианты:
|
|
update_message dictionary |
Отфильтрованные сообщения обновления. |
|
buffers integer |
Количество буферов для хранения отфильтрованных сообщений обновления. |
|
update_source string |
Источник обновлений маршрутизации. Допустимые значения см. в документации поставщика. |
|
use dictionary |
Использовать шаблон neighbor-group и session-group. |
|
neighbor_group string |
Наследовать конфигурацию из neighbor-group. |
|
session_group string |
Наследовать конфигурацию, независимую от семейства адресов, из session-group |
|
nsr dictionary |
Включить поддержку непрерывной маршрутизации для всех соседей. |
|
disable boolean |
Отключить nsr Варианты:
|
|
set boolean |
Установить nsr Варианты:
|
|
rpki dictionary |
Настроить RPKI. |
|
route dictionary |
Настроить маршрут RPKI. Сеть A.B.C.D/длина или X:X::X/длина/минимальная длина префикса |
|
max integer |
Максимальная длина префикса. Пример: <1-128>. |
|
origin integer |
Номер автономной системы источника (в формате asplain). Пример: <1-4294967295>. |
|
value string |
Сеть A.B.C.D/длина или X:X::X/длина/минимальная длина префикса. |
|
servers list / elements=dictionary |
Настроить серверы кэша RPKI. |
|
name string |
Адрес сервера RPKI. |
|
purge_time integer |
Время ожидания после отключения кэша перед очисткой устаревших маршрутов |
|
refresh_time dictionary |
Интервал между отправкой последовательных запросов к серверу кэша RPKI |
|
time_off boolean |
Не отправлять последовательные запросы периодически Варианты:
|
|
value integer |
Время очистки (в секундах) <30-360> |
|
response_time dictionary |
Время ожидания ответа от сервера кэша RPKI |
|
time_off boolean |
Ожидать ответ неограниченное время Варианты:
|
|
value integer |
Время очистки (в секундах) <15-3600> |
|
shutdown boolean |
Отключить сервер кэша RPKI Варианты:
|
|
transport dictionary |
Указать способ передачи данных для сервера кэша RPKI |
|
ssh dictionary |
Подключиться к серверу кэша RPKI по SSH |
|
port integer |
Указать номер порта для транспортного соединения с сервером кэша RPKI |
|
tcp dictionary |
Подключиться к серверу кэша RPKI по TCP (без шифрования) |
|
port integer |
Указать номер порта для транспортного соединения с сервером кэша RPKI |
|
socket dictionary |
Задать параметры сокета. |
|
receive_buffer_size integer |
Размер буфера приема сокета. Пример: <512-131072>. |
|
send_buffer_size integer |
Размер буфера отправки сокета. Пример: <4096-131072>. |
|
timers dictionary |
Таймеры BGP для каждого соседа. |
|
holdtime integer |
Время удержания <3-65535> или 0 — отключить время удержания. |
|
keepalive_time integer |
Интервал keepalive <0-65535>. |
|
update dictionary |
Конфигурация обновлений BGP. |
|
in dictionary |
Обработка входящих сообщений обновления |
|
error_handling dictionary |
Обработка ошибок во входящих сообщениях обновления. |
|
basic dictionary |
Базовая обработка ошибок во входящих сообщениях обновления |
|
ebgp dictionary |
Базовая обработка ошибок во входящих сообщениях обновления для соседей EBGP |
|
disable boolean |
Отключить Варианты:
|
|
ibgp dictionary |
Базовая обработка ошибок во входящих сообщениях обновления для соседей IBGP |
|
disable boolean |
Отключить Варианты:
|
|
extended dictionary |
Расширенная обработка ошибок во входящих сообщениях обновления |
|
ebgp boolean |
Расширенная обработка ошибок во входящих сообщениях обновления для соседей EBGP Варианты:
|
|
ibgp boolean |
Расширенная обработка ошибок во входящих сообщениях обновления для соседей IBGP Варианты:
|
|
limit integer |
Верхний предел временного использования памяти при формировании обновлений. Пример: <16-2048>. |
|
out dictionary |
Конфигурация формирования обновлений BGP. |
|
logging boolean |
Включить журналирование событий формирования обновлений. Варианты:
|
|
vrfs list / elements=dictionary |
Указать имя VRF. |
|
bfd dictionary |
Настроить параметры BFD. |
|
minimum_interval integer |
Задает минимальный интервал сеанса BFD для соседа. |
|
multiplier integer |
Задает значение множителя сеанса BFD для соседа. |
|
bgp dictionary |
Команды BGP. |
|
auto_policy_soft_reset dictionary |
Включить автоматический мягкий сброс пира при перенастройке политики. |
|
disable boolean |
Отключить автоматический мягкий сброс пиров протокола пограничного шлюза (BGP). Варианты:
|
|
bestpath dictionary |
Выбрать алгоритм выбора наилучшего пути для маршрутов BGP. |
|
aigp dictionary |
Атрибут AIGP |
|
ignore boolean |
Игнорировать атрибут AIGP. Варианты:
|
|
as_path dictionary |
Выбрать наилучший путь на основе AS-path. |
|
ignore boolean |
Игнорировать Варианты:
|
|
multipath_relax boolean |
Ослабленная проверка multipath Варианты:
|
|
compare_routerid boolean |
Сравнивать router-id для идентичных путей EBGP. Варианты:
|
|
cost_community dictionary |
Сообщество стоимости. |
|
ignore boolean |
Игнорировать cost_community Варианты:
|
|
med dictionary |
Атрибут MED |
|
always boolean |
Разрешить сравнение MED от разных соседей. Варианты:
|
|
confed boolean |
Сравнивать MED между путями конфедерации. Варианты:
|
|
missing_as_worst boolean |
Считать отсутствующий MED наименее предпочтительным. Варианты:
|
|
origin_as dictionary |
Параметры origin-AS BGP. |
|
allow dictionary |
Параметры origin-AS BGP. |
|
invalid boolean |
При выборе наилучшего пути BGP допускается «недопустимый» origin-AS Варианты:
|
|
use dictionary |
Параметры origin-AS BGP. |
|
validity boolean |
При выборе наилучшего пути BGP используется проверка допустимости origin-AS Варианты:
|
|
default dictionary |
Настроить значение по умолчанию. |
|
local_preference integer |
Локальное предпочтение. Допустимые значения см. в документации поставщика. |
|
enforce_first_as dictionary |
Требовать указания первой AS для маршрутов EBGP |
|
disable boolean |
Отключить требование первой AS Варианты:
|
|
fast_external_fallover dictionary |
Немедленно сбросить сеанс при отключении линии к напрямую подключенному внешнему пиру. |
|
disable boolean |
Отключить быстрое переключение при потере внешнего соединения. Варианты:
|
|
log dictionary |
Вести журнал сведений BGP |
|
log_message dictionary |
Вести журнал входящих и исходящих сообщений соседа. |
|
disable boolean |
Отключить журналирование входящих и исходящих сообщений. Варианты:
|
|
neighbor dictionary |
Вести журнал сведений о состоянии соседа. |
|
changes dictionary |
Вести журнал событий подключения и отключения соседа, а также причин сброса. |
|
detail boolean |
Подробности Варианты:
|
|
disable boolean |
Отключить Варианты:
|
|
multipath dictionary |
Изменить критерии выбора multipath |
|
as_path dictionary |
Путь AS |
|
ignore dictionary |
Игнорировать проверки, связанные с AS-path, при выборе multipath. |
|
onwards boolean |
Игнорировать все последующие элементы AS-path при выборе multipath. Варианты:
|
|
redistribute_internal boolean |
Перераспределять внутренние маршруты BGP. Варианты:
|
|
router_id string |
Настроить идентификатор маршрутизатора. Пример: IPv4-адрес A.B.C.D. |
|
unsafe_ebgp_policy boolean |
Разрешить соседям eBGP без политики передавать все маршруты (поддержка Cisco). Варианты:
|
|
default_information dictionary |
Управлять распространением информации о маршруте по умолчанию. |
|
originate boolean |
Распространять маршрут по умолчанию Варианты:
|
|
default_metric integer |
Метрика по умолчанию. Пример: <1-4294967295>. |
|
mpls dictionary |
Включить параметры MPLS. |
|
activate dictionary |
Перейти в режим активации MPLS BGP на интерфейсах MPLS. |
|
interface string |
Имя интерфейса, на котором нужно включить MPLS. |
|
neighbors list / elements=dictionary |
Указать соседний маршрутизатор. |
|
advertisement_interval integer |
Минимальный интервал между отправкой обновлений маршрутизации BGP. Пример: <0-600>. |
|
bfd dictionary |
Настроить параметры BFD. |
|
fast_detect dictionary |
Включить быстрое обнаружение |
|
disable boolean |
Запретить наследование параметров BFD от родительского объекта. Варианты:
|
|
set boolean |
Включить fast-detect Варианты:
|
|
strict_mode boolean |
Удерживать сеанс соседа до установления сеанса BFD Варианты:
|
|
minimum_interval integer |
Задает минимальный интервал сеанса BFD для соседа. |
|
multiplier integer |
Задает значение множителя сеанса BFD для соседа. |
|
bmp_activate dictionary |
Включить ведение журнала BMP для этого соседа. |
|
server integer |
Включить подключение BMP к указанному серверу. Пример: <1-8>. |
|
capability dictionary |
Объявить пиру о поддерживаемых возможностях. |
|
additional_paths dictionary |
Команды BGP для дополнительных путей. |
|
receive dictionary |
Возможность приема дополнительных путей |
|
disable boolean |
Отключить возможность приема Варианты:
|
|
set boolean |
Включить возможность приема Варианты:
|
|
send dictionary |
Возможность отправки дополнительных путей |
|
disable boolean |
установить возможность отправки Варианты:
|
|
set boolean |
установить возможность отправки Варианты:
|
|
suppress dictionary |
Не объявлять соседу возможности. |
|
all dictionary |
все возможности |
|
inheritance_disable boolean |
Не наследовать эту конфигурацию от родительской группы. Варианты:
|
|
set boolean |
установить все. Варианты:
|
|
four_byte_AS dictionary |
возможность использования 4-байтового AS |
|
set boolean |
установить 4_byte_as. Варианты:
|
|
cluster_id string |
Идентификатор кластера этого маршрутизатора, выполняющего роль отражателя маршрутов. |
|
description string |
Описание конкретного соседа. |
|
dmz_link_bandwidth dictionary |
Передавать пропускную способность канала DMZ. |
|
inheritance_disable boolean |
Не наследовать эту конфигурацию от родительской группы. Варианты:
|
|
set boolean |
установить dmz-link-bandwidth. Варианты:
|
|
dscp string |
Задать IP DSCP (кодовую точку DiffServ). Допустимые значения см. в документации производителя. |
|
ebgp_multihop dictionary |
Разрешить соседей EBGP, находящихся не в непосредственно подключённых сетях. |
|
mpls boolean |
Отключить пересылку BGP MPLS. Варианты:
|
|
value integer |
Максимальное количество переходов. Пример: <1-255>. |
|
ebgp_recv_extcommunity_dmz dictionary |
Получать от соседа ebgp расширенное сообщество с пропускной способностью канала DMZ. |
|
inheritance_disable boolean |
Запретить наследование ebgp-recv-community-dmz от родительского элемента. Варианты:
|
|
set boolean |
установить ebgp-recv-community-dmz. Варианты:
|
|
ebgp_send_extcommunity_dmz dictionary |
Отправлять соседу ebgp расширенное сообщество с пропускной способностью канала DMZ. |
|
cumulatie boolean |
Отправлять соседу ebgp накопленную пропускную способность канала DMZ в community для всех путей multipath. Варианты:
|
|
inheritance_disable boolean |
Запретить наследование ebgp-send-community-dmz от родительского элемента. Варианты:
|
|
set boolean |
установить ebgp-send-community-dmz. Варианты:
|
|
egress_engineering dictionary |
Включить инженерное управление исходящими соединениями для этого соседа. |
|
inheritance_disable boolean |
Запретить наследование egress-engineering от родительского элемента. Варианты:
|
|
set boolean |
установить egress-engineering. Варианты:
|
|
enforce_first_as dictionary |
Требовать совпадения первого AS для маршрутов EBGP. |
|
disable boolean |
отключить проверку первого AS Варианты:
|
|
graceful_maintenance dictionary |
Параметры плавного обслуживания. Они заставят соседей считать маршруты от этого маршрутизатора менее предпочтительными и выбирать альтернативы. Это позволяет плавно выводить маршрутизатор из обслуживания и возвращать его в работу. |
|
activate dictionary |
При включении здесь или в конфигурации маршрутизатора BGP маршруты будут объявляться с атрибутами плавного обслуживания. |
|
inheritance_disable boolean |
Запретить наследование activate от родительского элемента. Варианты:
|
|
set boolean |
активировать. Варианты:
|
|
as_prepends dictionary |
Количество добавлений номера локальной AS в начало пути AS маршрутов. По умолчанию: 0. |
|
inheritance_disable boolean |
Запретить наследование as prepends от родительского элемента. Варианты:
|
|
value integer |
Диапазон значений для as prepends. Пример: <0-6>. |
|
local_preference dictionary |
Значение local preference, используемое для объявления маршрутов соседям ibgp. По умолчанию: без изменений. |
|
inheritance_disable boolean |
Запретить наследование local preference от родительского элемента. Варианты:
|
|
value integer |
Диапазон значений Local Preference. Пример: <0-4294967295>. |
|
set boolean |
установить плавное обслуживание. Варианты:
|
|
graceful_restart dictionary |
Включить поддержку плавного перезапуска для этого соседа. |
|
restart_time integer |
Время перезапуска, объявляемое соседям, в секундах <1-4095>. |
|
stalepath_time integer |
Максимальное время ожидания перезапуска соседей с поддержкой GR, в секундах <1-4095>. |
|
ignore_connected_check dictionary |
Обходить проверку непосредственно подключённого следующего узла для одношагового пиринга eBGP. |
|
inheritance_disable boolean |
Запретить наследование ignore-connected-check от родительского элемента. Варианты:
|
|
set boolean |
установить ignore-connected-check. Варианты:
|
|
keychain dictionary |
Настроить аутентификацию на основе связки ключей. |
|
inheritance_disable boolean |
Запретить наследование keychain от родительского элемента. Варианты:
|
|
name string |
Имя связки ключей — не более 32 символов. |
|
local dictionary |
Настроить локальный параметр |
|
address dictionary |
Адрес IPv4 |
|
inheritance_disable boolean |
Запретить наследование локального адреса от родительского элемента. Варианты:
|
|
ipv4_address string |
Адрес IPv4 <A.B.C.D>. |
|
local_as dictionary |
Указать номер локальной AS. |
|
inheritance_disable boolean |
Запретить наследование локальной AS от родительского элемента. Варианты:
|
|
no_prepend dictionary |
Не добавлять локальную AS в начало объявлений от этого соседа. |
|
replace_as dictionary |
Добавлять в начало объявлений этому соседу только локальную AS. |
|
dual_as boolean |
Режим Dual-AS. Варианты:
|
|
set boolean |
Добавлять в начало объявлений этому соседу только локальную AS. Варианты:
|
|
set boolean |
Не добавлять локальный AS к объявлениям от этого соседа. Варианты:
|
|
value integer |
Номер AS длиной 2 или 4 байта |
|
log dictionary |
Журналирование сообщений обновления для каждого соседа. |
|
log_message dictionary |
Журналирование сообщений обновления/уведомления для каждого соседа. |
|
in dictionary |
Входящие сообщения журнала |
|
disable boolean |
Отключить журналирование входящих сообщений. Варианты:
|
|
inheritance_disable boolean |
Запретить наследование журнала сообщений от родительского элемента. Варианты:
|
|
value integer |
Диапазон размера буфера журнала сообщений <1-100>. |
|
out dictionary |
Исходящие сообщения журнала |
|
disable boolean |
Отключить журналирование входящих сообщений. Варианты:
|
|
inheritance_disable boolean |
Запретить наследование журнала сообщений от родительского элемента. Варианты:
|
|
value integer |
Диапазон размера буфера журнала сообщений <1-100>. |
|
neighbor_address псевдонимы: neighbor string / обязательный |
Адрес соседнего маршрутизатора. |
|
origin_as dictionary |
Параметры BGP origin-AS. |
|
validation dictionary |
Параметры проверки BGP origin-AS. |
|
disable boolean |
Отключить проверку origin-AS с помощью RPKI. Варианты:
|
|
password dictionary |
Задать пароль. |
|
encrypted string |
Указывает, что далее будет задан ЗАШИФРОВАННЫЙ пароль. |
|
inheritance_disable boolean |
Запретить наследование пароля от родительского элемента. Варианты:
|
|
receive_buffer_size integer |
Задать размер буфера приема сокета и BGP. Пример: <512-131072>. |
|
remote_as string |
Автономная система соседа. |
|
send_buffer_size integer |
Задать размер буфера отправки сокета и BGP. Пример: <4096-131072>. |
|
session_open_mode string |
Установить сеанс BGP, используя этот режим открытия TCP. Варианты:
|
|
shutdown dictionary |
Административно отключить этого соседа. |
|
inheritance_disable boolean |
Запретить наследование отключения от родительского элемента Варианты:
|
|
set boolean |
Отключение. Варианты:
|
|
tcp dictionary |
Команды настройки сеанса TCP. |
|
mss dictionary |
Максимальный размер сегмента. |
|
inheritance_disable boolean |
Запретить наследование MSS от родительского элемента Варианты:
|
|
value integer |
Начальный максимальный размер сегмента TCP. |
|
timers dictionary |
Таймеры BGP для каждого соседа. |
|
holdtime integer |
Время удержания <3-65535> или 0 для отключения времени удержания. |
|
keepalive_time integer |
Интервал keepalive <0-65535>. |
|
ttl_security dictionary |
Включить защиту TTL для EBGP. |
|
inheritance_disable boolean |
Запретить наследование защиты TTL от родительского элемента Варианты:
|
|
set boolean |
Включить защиту TTL Варианты:
|
|
update dictionary |
Настройка обновлений BGP. |
|
in dictionary |
Обработка входящих сообщений обновления. |
|
filtering dictionary |
Фильтрация входящих сообщений обновления |
|
attribute_filter dictionary |
Настройка фильтра атрибутов. |
|
group string |
Имя группы. |
|
logging dictionary |
Сообщения syslog о фильтрации обновлений. |
|
disable boolean |
Отключить сообщения syslog о фильтрации обновлений. Варианты:
|
|
update_message dictionary |
Отфильтрованные сообщения обновления. |
|
buffers integer |
Количество буферов для хранения отфильтрованных сообщений обновления. |
|
update_source string |
Источник обновлений маршрутизации. Допустимые значения см. в документации производителя. |
|
use dictionary |
Использовать шаблон neighbor-group и session-group. |
|
neighbor_group string |
Наследовать конфигурацию из neighbor-group. |
|
session_group string |
Наследовать конфигурацию, не зависящую от семейства адресов, из session-group |
|
rd dictionary |
Различитель маршрутов. |
|
auto boolean |
Автоматический различитель маршрутов. Варианты:
|
|
socket dictionary |
Задать параметры сокета. |
|
receive_buffer_size integer |
Размер буфера приема сокета. Пример: <512-131072>. |
|
send_buffer_size integer |
Размер буфера отправки сокета. Пример: <4096-131072>. |
|
timers dictionary |
Таймеры BGP для каждого соседа. |
|
holdtime integer |
Время удержания <3-65535> или 0 для отключения времени удержания. |
|
keepalive_time integer |
Интервал keepalive <0-65535>. |
|
vrf string |
Имя VRF. |
running_config string | Состояние, в котором должна остаться конфигурация. — Состояние purged удаляет все конфигурации BGP с целевого устройства. Используйте это состояние с осторожностью. — Состояние deleted удаляет только атрибуты BGP, которыми управляет этот модуль, и не отменяет процесс BGP полностью. Таким образом, сохраняются конфигурации, связанные с семейством адресов, в контексте BGP. — Выполнение операций в состояниях deleted и replaced приведет к ошибке, если в контексте соседа или VRF, который требуется удалить, имеются строки конфигурации семейства адресов. Для предварительной очистки используйте модули cisco.iosxr.iosxr_bgp_address_family или cisco.iosxr.iosxr_bgp_neighbor_address_family. — Дополнительные сведения см. в примерах. |
state string | Состояние, в котором должна остаться конфигурация. Варианты:
|
Примечания
Примечание
- Этот модуль работает с подключением
network_cli.
Примеры
# Using merged
#
# Before state
# ------------
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 09:38:36.245 UTC
# % No such configuration item(s)
# RP/0/0/CPU0:10#
- name: Merge the following BGP global configuration
cisco.iosxr.iosxr_bgp_global:
config:
as_number: 65536
default_metric: 5
socket:
receive_buffer_size: 514
send_buffer_size: 4098
bgp:
confederation:
identifier: 4
bestpath:
med:
confed: true
cluster_id: 5
router_id: 192.0.2.10
neighbors:
- neighbor: 192.0.2.13
remote_as: 65538
bfd:
fast_detect:
strict_mode: true
multiplier: 6
minimum_interval: 20
vrfs:
- vrf: vrf1
default_metric: 5
#
# Task Output:
# ---------------
#
# before: {}
# commands:
# - router bgp 65536
# - bgp cluster-id 5
# - bgp router-id 192.0.2.10
# - bgp bestpath med confed
# - bgp confederation identifier 4
# - default-metric 5
# - socket receive-buffer-size 514
# - socket send-buffer-size 4098
# - neighbor 192.0.2.13
# - bfd fast-detect strict-mode
# - bfd minimum-interval 20
# - bfd multiplier 6
# - remote-as 65538
# - vrf vrf1
# - default-metric 5
#
# after:
# as_number: '65536'
# bgp:
# bestpath:
# med:
# confed: true
# cluster_id: '5'
# confederation:
# identifier: 4
# router_id: 192.0.2.10
# default_metric: 5
# neighbors:
# - bfd:
# fast_detect:
# strict_mode: true
# minimum_interval: 20
# multiplier: 6
# neighbor_address: 192.0.2.13
# remote_as: 65538
# socket:
# receive_buffer_size: 514
# send_buffer_size: 4098
# vrfs:
# - default_metric: 5
# vrf: vrf1
#
# After state
# -----------
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 09:44:32.480 UTC
# router bgp 65536
# bgp confederation identifier 4
# bgp router-id 192.0.2.10
# bgp cluster-id 5
# default-metric 5
# socket send-buffer-size 4098
# bgp bestpath med confed
# socket receive-buffer-size 514
# neighbor 192.0.2.13
# remote-as 65538
# bfd fast-detect strict-mode
# bfd multiplier 6
# bfd minimum-interval 20
# !
# vrf vrf1
# default-metric 5
# !
# !
# Using replaced
#
# Before state
# ------------
#
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 09:44:32.480 UTC
# router bgp 65536
# bgp confederation identifier 4
# bgp router-id 192.0.2.10
# bgp cluster-id 5
# default-metric 5
# socket send-buffer-size 4098
# bgp bestpath med confed
# socket receive-buffer-size 514
# neighbor 192.0.2.13
# remote-as 65538
# bfd fast-detect strict-mode
# bfd multiplier 6
# bfd minimum-interval 20
# !
# vrf vrf1
# default-metric 5
# !
# !
- name: Replace the following configuration
cisco.iosxr.iosxr_bgp_global:
state: replaced
config:
as_number: 65536
default_metric: 4
socket:
receive_buffer_size: 514
send_buffer_size: 4098
bgp:
confederation:
identifier: 4
bestpath:
med:
confed: true
cluster_id: 5
router_id: 192.0.2.10
neighbors:
- neighbor: 192.0.2.14
remote_as: 65538
bfd:
fast_detect:
strict_mode: true
multiplier: 6
minimum_interval: 20
vrfs:
- vrf: vrf1
default_metric: 5
#
# Task Output:
# -------------
#
# before:
# as_number: '65536'
# bgp:
# bestpath:
# med:
# confed: true
# cluster_id: '5'
# confederation:
# identifier: 4
# router_id: 192.0.2.10
# default_metric: 5
# neighbors:
# - bfd:
# fast_detect:
# strict_mode: true
# minimum_interval: 20
# multiplier: 6
# neighbor_address: 192.0.2.13
# remote_as: 65538
# socket:
# receive_buffer_size: 514
# send_buffer_size: 4098
# vrfs:
# - default_metric: 5
# vrf: vrf1
#
# commands:
# - router bgp 65536
# - default-metric 4
# - neighbor 192.0.2.14
# - bfd fast-detect strict-mode
# - bfd minimum-interval 20
# - bfd multiplier 6
# - remote-as 65538
# - no neighbor 192.0.2.13
#
# after:
# as_number: '65536'
# bgp:
# bestpath:
# med:
# confed: true
# cluster_id: '5'
# confederation:
# identifier: 4
# router_id: 192.0.2.10
# default_metric: 4
# neighbors:
# - bfd:
# fast_detect:
# strict_mode: true
# minimum_interval: 20
# multiplier: 6
# neighbor_address: 192.0.2.14
# remote_as: 65538
# socket:
# receive_buffer_size: 514
# send_buffer_size: 4098
# vrfs:
# - default_metric: 5
# vrf: vrf1
#
# After state
# -----------
#
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 09:54:11.161 UTC
# router bgp 65536
# bgp confederation identifier 4
# bgp router-id 192.0.2.10
# bgp cluster-id 5
# default-metric 4
# socket send-buffer-size 4098
# bgp bestpath med confed
# socket receive-buffer-size 514
# neighbor 192.0.2.14
# remote-as 65538
# bfd fast-detect strict-mode
# bfd multiplier 6
# bfd minimum-interval 20
# !
# vrf vrf1
# default-metric 5
# !
# !
# Using overridden
#
# Before state
# ------------
#
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 09:44:32.480 UTC
# router bgp 65536
# bgp confederation identifier 4
# bgp router-id 192.0.2.10
# bgp cluster-id 5
# default-metric 5
# socket send-buffer-size 4098
# bgp bestpath med confed
# socket receive-buffer-size 514
# neighbor 192.0.2.13
# remote-as 65538
# bfd fast-detect strict-mode
# bfd multiplier 6
# bfd minimum-interval 20
# !
# vrf vrf1
# default-metric 5
# !
# !
- name: Override running config with provided configuration
cisco.iosxr.iosxr_bgp_global:
state: overridden
config:
as_number: 65536
default_metric: 4
socket:
receive_buffer_size: 514
send_buffer_size: 4098
bgp:
confederation:
identifier: 4
bestpath:
med:
confed: true
cluster_id: 5
router_id: 192.0.2.10
neighbors:
- neighbor: 192.0.2.14
remote_as: 65538
bfd:
fast_detect:
strict_mode: true
multiplier: 6
minimum_interval: 20
vrfs:
- vrf: vrf1
default_metric: 5
#
# Task Output:
# -------------
#
# before:
# as_number: '65536'
# bgp:
# bestpath:
# med:
# confed: true
# cluster_id: '5'
# confederation:
# identifier: 4
# router_id: 192.0.2.10
# default_metric: 5
# neighbors:
# - bfd:
# fast_detect:
# strict_mode: true
# minimum_interval: 20
# multiplier: 6
# neighbor_address: 192.0.2.13
# remote_as: 65538
# socket:
# receive_buffer_size: 514
# send_buffer_size: 4098
# vrfs:
# - default_metric: 5
# vrf: vrf1
#
# commands:
# - router bgp 65536
# - default-metric 4
# - neighbor 192.0.2.14
# - bfd fast-detect strict-mode
# - bfd minimum-interval 20
# - bfd multiplier 6
# - remote-as 65538
# - no neighbor 192.0.2.13
#
# after:
# as_number: '65536'
# bgp:
# bestpath:
# med:
# confed: true
# cluster_id: '5'
# confederation:
# identifier: 4
# router_id: 192.0.2.10
# default_metric: 4
# neighbors:
# - bfd:
# fast_detect:
# strict_mode: true
# minimum_interval: 20
# multiplier: 6
# neighbor_address: 192.0.2.14
# remote_as: 65538
# socket:
# receive_buffer_size: 514
# send_buffer_size: 4098
# vrfs:
# - default_metric: 5
# vrf: vrf1
# After state
# -----------
#
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 09:54:11.161 UTC
# router bgp 65536
# bgp confederation identifier 4
# bgp router-id 192.0.2.10
# bgp cluster-id 5
# default-metric 4
# socket send-buffer-size 4098
# bgp bestpath med confed
# socket receive-buffer-size 514
# neighbor 192.0.2.14
# remote-as 65538
# bfd fast-detect strict-mode
# bfd multiplier 6
# bfd minimum-interval 20
# !
# vrf vrf1
# default-metric 5
# !
# !
# Using deleted
#
# Before state
# ------------
#
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 09:54:11.161 UTC
# router bgp 65536
# bgp confederation identifier 4
# bgp router-id 192.0.2.10
# bgp cluster-id 5
# default-metric 4
# socket send-buffer-size 4098
# bgp bestpath med confed
# socket receive-buffer-size 514
# neighbor 192.0.2.14
# remote-as 65538
# bfd fast-detect strict-mode
# bfd multiplier 6
# bfd minimum-interval 20
# !
# vrf vrf1
# default-metric 5
# !
# !
#
- name: Delete BGP configurations handled by this module
cisco.iosxr.iosxr_bgp_global:
config:
as_number: 65536
state: deleted
#
# Task Output:
# -------------
#
# before:
# as_number: '65536'
# bgp:
# bestpath:
# med:
# confed: true
# cluster_id: '5'
# confederation:
# identifier: 4
# router_id: 192.0.2.10
# default_metric: 4
# neighbors:
# - bfd:
# fast_detect:
# strict_mode: true
# minimum_interval: 20
# multiplier: 6
# neighbor_address: 192.0.2.14
# remote_as: 65538
# socket:
# receive_buffer_size: 514
# send_buffer_size: 4098
# vrfs:
# - default_metric: 5
# vrf: vrf1
#
# commands:
# - router bgp 65536
# - no bgp cluster-id 5
# - no bgp router-id 192.0.2.10
# - no bgp bestpath med confed
# - no bgp confederation identifier 4
# - no default-metric 4
# - no socket receive-buffer-size 514
# - no socket send-buffer-size 4098
# - no neighbor 192.0.2.14
# - no vrf vrf1
#
# after:
# as_number: '65536'
#
# After state
# -----------
#
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 10:01:08.232 UTC
# router bgp 65536
# !
#
# Using purged
#
# Before state
# ------------
#
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 09:54:11.161 UTC
# router bgp 65536
# bgp confederation identifier 4
# bgp router-id 192.0.2.10
# bgp cluster-id 5
# default-metric 5
# socket send-buffer-size 4098
# bgp bestpath med confed
# socket receive-buffer-size 514
# neighbor 192.0.2.13
# remote-as 65538
# bfd fast-detect strict-mode
# bfd multiplier 6
# bfd minimum-interval 20
# !
# vrf vrf1
# default-metric 5
# !
# !
#
- name: Purge all BGP configurations from the device
cisco.iosxr.iosxr_bgp_global:
state: purged
#
# Task Output:
# -------------
#
# before:
# as_number: '65536'
# bgp:
# bestpath:
# med:
# confed: true
# cluster_id: '5'
# confederation:
# identifier: 4
# router_id: 192.0.2.10
# default_metric: 5
# neighbors:
# - bfd:
# fast_detect:
# strict_mode: true
# minimum_interval: 20
# multiplier: 6
# neighbor_address: 192.0.2.13
# remote_as: 65538
# socket:
# receive_buffer_size: 514
# send_buffer_size: 4098
# vrfs:
# - default_metric: 5
# vrf: vrf1
#
# commands:
# - no router bgp 65536
#
# after: {}
#
# After state
# -----------
#
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 09:38:36.245 UTC
# % No such configuration item(s)
# RP/0/0/CPU0:10#
#
#
# Using Rendered
# -----------------
#
- name: >-
Render platform specific configuration lines (without connecting to the
device)
cisco.iosxr.iosxr_bgp_global:
state: rendered
config:
as_number: 1
default_metric: 4
vrfs:
- vrf: vrf3
bfd:
minimum_interval: 20
multiplier: 10
bgp:
fast_external_fallover:
disable: true
router_id: 1.2.3.4
auto_policy_soft_reset:
disable: true
timers:
keepalive_time: 20
holdtime: 30
- vrf: vrf2
bgp:
enforce_first_as:
disable: true
default_metric: 4
neighbors:
- neighbor: 1.1.1.3
remote_as: 2
graceful_maintenance:
set: true
activate:
inheritance_disable: true
local_preference:
value: 1
as_prepends:
value: 2
#
# Task output
# -----------------------
# rendered:
# - router bgp 1
# - default-metric 4
# - vrf vrf3
# - bfd multiplier 10
# - bfd minimum-interval 20
# - bgp auto-policy-soft-reset disable
# - bgp fast-external-fallover disable
# - bgp router-id 1.2.3.4
# - timers bgp 20 30
# - vrf vrf2
# - neighbor 1.1.1.3
# - remote-as 2
# - graceful-maintenance
# - graceful-maintenance activate inheritance-disable
# - graceful-maintenance local-preference 1
# - graceful-maintenance as-prepends 2
# - bgp enforce-first-as disable
# - default-metric 4
# Using parsed
#
# parsed.cfg
# ------------
# router bgp 65536
# bgp confederation identifier 4
# bgp router-id 192.0.2.10
# bgp cluster-id 5
# default-metric 4
# socket send-buffer-size 4098
# bgp bestpath med confed
# socket receive-buffer-size 514
# neighbor 192.0.2.11
# remote-as 65537
# cluster-id 3
# !
# neighbor 192.0.2.14
# remote-as 65538
# bfd fast-detect strict-mode
# bfd multiplier 6
# bfd minimum-interval 20
# !
# !
#
- name: Parse externally provided BGP config
cisco.iosxr.iosxr_bgp_global:
running_config: "{{ lookup('file', 'parsed.cfg') }}"
state: parsed
# Task output
# -----------------------
# parsed:
# as_number: '65536'
# bgp:
# bestpath:
# med:
# confed: true
# cluster_id: '5'
# confederation:
# identifier: 4
# router_id: 192.0.2.10
# default_metric: 4
# neighbors:
# - cluster_id: '3'
# neighbor_address: 192.0.2.11
# remote_as: 65537
# - bfd:
# fast_detect:
# strict_mode: true
# minimum_interval: 20
# multiplier: 6
# neighbor_address: 192.0.2.14
# remote_as: 65538
# socket:
# receive_buffer_size: 514
# send_buffer_size: 4098
# Using gathered
#
# Before state
# ------------
#
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 09:38:36.245 UTC
# router bgp 65536
# bgp confederation identifier 4
# bgp router-id 192.0.2.10
# bgp cluster-id 5
# default-metric 5
# socket send-buffer-size 4098
# bgp bestpath med confed
# socket receive-buffer-size 514
# neighbor 192.0.2.13
# remote-as 65538
# bfd fast-detect strict-mode
# bfd multiplier 6
# bfd minimum-interval 20
# !
# vrf vrf1
# default-metric 5
# !
# !
- name: Gather bgp global facts
cisco.iosxr.iosxr_bgp_global:
state: gathered
# Task Output:
# ------------
#
# gathered:
# as_number: '65536'
# bgp:
# bestpath:
# med:
# confed: true
# cluster_id: '5'
# confederation:
# identifier: 4
# router_id: 192.0.2.10
# default_metric: 5
# neighbors:
# - bfd:
# fast_detect:
# strict_mode: true
# minimum_interval: 20
# multiplier: 6
# neighbor_address: 192.0.2.13
# remote_as: 65538
# socket:
# receive_buffer_size: 514
# send_buffer_size: 4098
# vrfs:
# - default_metric: 5
# vrf: vrf1
Возвращаемые значения
Общие возвращаемые значения описаны здесь, ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
after dictionary | Результирующий вызов модели конфигурации. Возвращается: при изменении Пример: |
before dictionary | Конфигурация до вызова модели. Возвращается: всегда Пример: |
commands list / elements=string | Набор команд, отправленных на удалённое устройство. Возвращается: всегда Пример: |
gathered list / elements=string | Сведения о сетевом ресурсе, собранные с удалённого устройства в виде структурированных данных. Возвращается: когда state имеет значение Пример: |
parsed list / elements=string | Собственная конфигурация устройства, переданная в параметре running_config, преобразованная в структурированные данные в соответствии со спецификацией аргументов модуля. Возвращается: когда state имеет значение Пример: |
rendered list / elements=string | Предоставленная в задаче конфигурация, преобразованная в собственный формат устройства (без подключения к устройству). Возвращается: когда state имеет значение Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/cisco/iosxr/iosxr_bgp_global_module.html
