Spec-Zone.ru › Ansible

cisco.iosxr.iosxr_bgp_global модуль – Модуль ресурсов для настройки BGP.

Примечание

Этот модуль входит в состав коллекции cisco.iosxr (версия 9.0.0).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет 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

Задает значение minimum-interval для сессии BFD для соседа.

multiplier

integer

Задает значение multiplier для сессии BFD для соседа.

bgp

dictionary

Параметры BGP.

as_path_loopcheck

boolean

Включить проверку циклов AS-path для пиров iBGP.

Варианты:

  • false
  • true

auto_policy_soft_reset

dictionary

Включить автоматическую мягкую перезагрузку пира при переконфигурации политики.

disable

boolean

Отключить автоматическую мягкую перезагрузку пиров Border Gateway Protocol (BGP).

Варианты:

  • false
  • true

bestpath

dictionary

Выберите алгоритм выбора лучшего пути для маршрутов BGP.

aigp

dictionary

Атрибут AIGP

ignore

boolean

Игнорировать атрибут AIGP.

Варианты:

  • false
  • true

as_path

dictionary

Выберите лучший путь на основе as-path.

ignore

boolean

игнорировать

Варианты:

  • false
  • true

multipath_relax

boolean

multipath-relax

Варианты:

  • false
  • true

compare_routerid

boolean

Сравнивать router-id для идентичных путей EBGP.

Варианты:

  • false
  • true

cost_community

dictionary

Cost community.

ignore

boolean

игнорировать cost_community

Варианты:

  • false
  • true

med

dictionary

Атрибут MED

always

boolean

Разрешить сравнение MED от разных соседей.

Варианты:

  • false
  • true

confed

boolean

Сравнивать MED среди путей конфедерации.

Варианты:

  • false
  • true

missing_as_worst

boolean

Рассматривать отсутствующий MED как наименее предпочтительный.

Варианты:

  • false
  • true

origin_as

dictionary

Параметры BGP origin-AS.

allow

dictionary

Параметры BGP origin-AS.

invalid

boolean

Выбор лучшего пути BGP разрешит ‘invalid’ origin-AS

Choices:

  • false
  • true

use

dictionary

Параметры BGP origin-AS.

validity

boolean

Выбор лучшего пути BGP будет использовать действительность origin-AS

Choices:

  • false
  • true

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

Choices:

  • false
  • true

fast_external_fallover

dictionary

Немедленно сбросить сеанс, если связь с напрямую подключенным внешним пиром прерывается.

disable

boolean

Отключить быстрое переключение на внешний путь.

Choices:

  • false
  • true

graceful_restart

dictionary

Включить поддержку плавного перезапуска.

graceful_reset

boolean

Плавный сброс, если изменение конфигурации приводит к сбросу пира.

Choices:

  • false
  • true

purge_time

integer

Время, прежде чем устаревшие маршруты будут очищены в секундах <1-6000>.

restart_time

integer

Время перезапуска, объявленное соседям в секундах <1-4095>.

set

boolean

Включить плавный перезапуск.

Choices:

  • false
  • true

stalepath_time

integer

Максимальное время ожидания перезапуска пиров с поддержкой GR в секундах <1-4095>.

install

dictionary

Установить обходной путь в RIB/CEF.

diversion

boolean

Установить обходной путь в RIB/CEF.

Choices:

  • false
  • true

log

dictionary

Логирование информации BGP

log_message

dictionary

Логирование входящих/исходящих сообщений соседа.

disable

boolean

Отключить входящие и исходящие сообщения.

Choices:

  • false
  • true

neighbor

dictionary

Регистрировать информацию о состоянии соседа.

changes

dictionary

Регистрировать переходы соседа в состояние «вверх/вниз» и причину сброса.

detail

boolean

detail

Choices:

  • false
  • true

disable

boolean

disable

Choices:

  • false
  • true

maximum

dictionary

Максимальное количество соседей, которые могут быть настроены

neighbor

integer

Максимальное количество соседей <1-15000>.

multipath

dictionary

Изменить критерии выбора многопутевого маршрута

as_path

dictionary

Путь AS

ignore

dictionary

Игнорировать проверку, связанную с путем AS, для выбора многопутевого маршрута.

onwards

boolean

Игнорировать все последующие части пути AS для выбора многопутевого маршрута.

Choices:

  • false
  • true

origin_as

dictionary

Параметры BGP origin-AS.

validation

dictionary

Параметры проверки BGP origin-AS.

disable

boolean

Отключить проверку RPKI origin-AS.

Choices:

  • false
  • true

signal

dictionary

Сигнализировать о действительности origin-AS для пиров.

ibgp

boolean

Сигнализировать о действительности origin-AS для пиров iBGP

Choices:

  • false
  • true

time

dictionary

Время ожидания между обновлением RPKI и проходом по таблице BGP.

time_in_second

integer

Время проверки префикса (в секундах).

time_off

boolean

Отсутствует автоматическая проверка префикса после обновления RPKI.

Choices:

  • false
  • true

redistribute_internal

boolean

Перераспределять внутренние маршруты BGP.

Choices:

  • false
  • true

router_id

string

Настроить Router-id. Пример: IPv4-адрес A.B.C.D.

scan_time

integer

Настроить интервал сканирования фонового сканера для универсального сканера. Пример: <5-3600>.

unsafe_ebgp_policy

boolean

Заставить eBGP-соседей без политики пропускать все маршруты (cisco-support).

Choices:

  • false
  • true

update_delay

integer

Установите максимальную начальную задержку для отправки обновлений. Пример -<0-3600> в сек.

default_information

dictionary

Управление распределением информации по умолчанию.

originate

boolean

Распространять маршрут по умолчанию

Choices:

  • false
  • true

default_metric

integer

Метрика по умолчанию. Пример -<1-4294967295>.

graceful_maintenance

dictionary

Это позволяет плавно вводить или выводить маршрутизатор из эксплуатации.

activate

string

Все соседи с конфигурацией graceful-maintenance

Choices:

  • "all-neighbors"
  • "retain-routes"
  • "all-neighbors retain-routes"
  • ""

ibgp

dictionary

Установите параметры для iBGP-пиров.

policy

dictionary

Установите параметры для политики маршрутизации.

out

dictionary

Установите параметры для исходящей политики.

enforce_modifications

boolean

Разрешить политике изменять все атрибуты.

Choices:

  • false
  • true

mpls

dictionary

Включить параметры mpls.

activate

dictionary

Введите интерфейсы mpls в режим активации BGP mpls.

interface

string

Имя интерфейса для включения mpls.

mvpn

boolean

Подключение к PIM/PIM6.

Choices:

  • false
  • true

neighbors

list / elements=dictionary

Укажите соседний маршрутизатор.

advertisement_interval

integer

Минимальный интервал между отправкой обновлений маршрутизации BGP. Пример -<0-600>.

bfd

dictionary

Настройте параметры BFD.

fast_detect

dictionary

Включить быстрое обнаружение

disable

boolean

Предотвратить наследование параметров bfd от родительского элемента.

Choices:

  • false
  • true

set

boolean

установить fast-detect

Choices:

  • false
  • true

strict_mode

boolean

Удерживать сеанс соседа до установления сессии BFD

Choices:

  • false
  • true

minimum_interval

integer

Указывает значение minimum-interval для сессии BFD соседа.

multiplier

integer

Указывает значение multiplier для сессии BFD соседа.

bmp_activate

dictionary

Включить журналирование BMP для этого соседа.

сервер

целое число

Включить соединение BMP с конкретным сервером. Пример -<1-8>.

возможность

словарь

Рекламировать возможность пиру.

дополнительные_пути

словарь

Команды BGP дополнительных путей.

получать

словарь

Возможность получения дополнительных путей

отключить

логический

установить возможность приема

Варианты:

  • false
  • true

установить

логический

установить возможность приема

Варианты:

  • false
  • true

отправить

словарь

Возможность отправки дополнительных путей

отключить

логический

установить возможность отправки

Варианты:

  • false
  • true

установить

логический

установить возможность отправки

Варианты:

  • false
  • true

подавить

словарь

Подавить рекламу возможности пиру.

все

словарь

все возможности

отключение_наследия

логический

Не наследовать данную конфигурацию из родительской группы.

Варианты:

  • false
  • true

установить

логический

установить все.

Варианты:

  • false
  • true

четырёхбайтовый_AS

словарь

Возможность 4-байтового AS

установить

логический

установить 4_byte_as.

Варианты:

  • false
  • true

id_кластера

строка

Идентификатор кластера этого маршрутизатора, действующего как отражатель маршрутов.

описание

строка

Описание, специфичное для соседа.

пропускная_способность_связи_демз

словарь

Распространять пропускную способность канала DMZ.

отключение_наследия

логический

Не наследовать данную конфигурацию из родительской группы.

Варианты:

  • false
  • true

установить

логический

установить пропускную способность dmz-link.

Варианты:

  • false
  • true

dscp

строка

Установить IP DSCP (DiffServ CodePoint). Обратитесь к документу поставщика для получения допустимых значений.

ebgp_многопрыжковый

словарь

Разрешить EBGP соседей, не находящихся на непосредственно подключенных сетях.

mpls

логический

Отключить BGP MPLS пересылку.

Варианты:

  • false
  • true
END_OF_DOCUMENT_MARKER

value

integer

максимальное количество переходов. Пример -<1-255>.

ebgp_recv_extcommunity_dmz

dictionary

Получение extcommunity dmz пропускной способности канала от соседа ebgp.

inheritance_disable

boolean

Предотвращение наследования ebgp-recv-community-dmz от родительского элемента

Choices:

  • false
  • true

set

boolean

установить ebgp-recv-community-dmz.

Choices:

  • false
  • true

ebgp_send_extcommunity_dmz

dictionary

Отправка extcommunity dmz пропускной способности канала от соседа ebgp.

cumulatie

boolean

Отправить кумулятивную community dmz пропускную способность всех мультипутей соседу ebgp.

Choices:

  • false
  • true

inheritance_disable

boolean

Предотвращение наследования ebgp-send-community-dmz от родительского элемента

Choices:

  • false
  • true

set

boolean

установить ebgp-send-community-dmz.

Choices:

  • false
  • true

egress_engineering

dictionary

Включить настройку исходящего пира для этого соседа.

inheritance_disable

boolean

Предотвращение наследования egress-engineering от родительского элемента

Choices:

  • false
  • true

set

boolean

установить egress-engineering.

Choices:

  • false
  • true

enforce_first_as

dictionary

Применить первый AS для маршрутов EBGP

disable

boolean

отключить принудительное применение 1-го as

Choices:

  • false
  • true

graceful_maintenance

dictionary

Атрибуты для плавного обслуживания. Это приведет к тому, что соседи будут понижать приоритет маршрутов от этого маршрутизатора и выбирать альтернативные. Это позволяет плавно вводить или выводить маршрутизатор из строя.

activate

dictionary

Маршруты будут объявлены с атрибутами плавного обслуживания при активации здесь или в конфигурации маршрутизатора bgp.

inheritance_disable

boolean

Предотвращение наследования activate от родительского элемента.

Choices:

  • false
  • true

set

boolean

активировать.

Choices:

  • false
  • true

as_prepends

dictionary

Количество раз для добавления номера локального AS к пути AS маршрутов. По умолчанию = 0

inheritance_disable

boolean

Предотвращение наследования as prepends от родительского элемента.

Choices:

  • false
  • true

value

integer

Диапазон значений для as prepends. Пример -<0-6>.

local_preference

dictionary

Локальная преференция, с которой объявлять маршруты ibgp-соседям. По умолчанию=Без изменений

inheritance_disable

boolean

Запретить наследование локальной преференции от родителя.

Choices:

  • false
  • true

value

integer

Диапазон значений для локальной преференции. Пример - <0-4294967295>.

set

boolean

Установить режим щадящего обслуживания.

Choices:

  • false
  • true

graceful_restart

dictionary

Включить поддержку щадящего перезапуска для этого соседа.

restart_time

integer

Время перезапуска, объявляемое соседям в секундах <1-4095>.

stalepath_time

integer

Максимальное время ожидания перезапуска одноранговых узлов с поддержкой GR в секундах <1-4095>.

ignore_connected_check

dictionary

Пропустить проверку непосредственно подключенного nexthop для одношагового eBGP-пиринга

inheritance_disable

boolean

Запретить наследование ignore-connected-check от родителя

Choices:

  • false
  • true

set

boolean

Установить ignore-connected-check.

Choices:

  • false
  • true

keychain

dictionary

Установить аутентификацию на основе keychain.

inheritance_disable

boolean

Запретить наследование keychain от родителя.

Choices:

  • false
  • true

name

string

Имя цепочки ключей - максимум 32 символа.

local

dictionary

Настроить локальный параметр

address

dictionary

IPv4-адрес

inheritance_disable

boolean

Запретить наследование локального адреса от родителя.

Choices:

  • false
  • true

ipv4_address

string

IPv4-адрес <A.B.C.D>.

local_as

dictionary

Указать локальный номер AS.

inheritance_disable

boolean

Запретить наследование локального AS от родителя.

Choices:

  • false
  • true

no_prepend

dictionary

Не добавлять локальный AS к объявлениям от этого соседа.

replace_as

dictionary

Добавлять только локальный AS к объявлениям для этого соседа.

dual_as

boolean

Режим Dual-AS.

Choices:

  • false
  • true

set

boolean

Добавлять только локальный AS к объявлениям для этого соседа.

Choices:

  • false
  • true

set

boolean

Не добавлять локальный AS к объявлениям от этого соседа.

Choices:

  • false
  • true

value

integer

2-байтовое, 4-байтовое число AS

log

dictionary

Регистрация сообщений обновления для каждого соседа.

log_message

dictionary

Регистрация сообщений обновления/уведомления для каждого соседа.

in

dictionary

Входящие сообщения журнала

disable

boolean

Отключить регистрацию входящих сообщений.

Choices:

  • false
  • true

inheritance_disable

boolean

Предотвращает наследование журнала сообщений от родителя.

Choices:

  • false
  • true

value

integer

Диапазон для размера буфера журнала сообщений <1-100>.

out

dictionary

Исходящие сообщения журнала

disable

boolean

Отключить регистрацию входящих сообщений.

Choices:

  • false
  • true

inheritance_disable

boolean

Предотвращает наследование журнала сообщений от родителя.

Choices:

  • false
  • true

value

integer

Диапазон для размера буфера журнала сообщений <1-100>.

neighbor_address

aliases: neighbor

string / required

Адрес маршрутизатора-соседа.

origin_as

dictionary

Параметры BGP origin-AS.

validation

dictionary

Параметры проверки BGP origin-AS.

disable

boolean

Отключить проверку BGP origin-AS с помощью RPKI.

Choices:

  • false
  • true

password

dictionary

Установить пароль.

encrypted

string

Указывает, что следует зашифрованный пароль.

inheritance_disable

boolean

Предотвратить наследование пароля от родителя.

Choices:

  • false
  • true

receive_buffer_size

integer

Установить размер буфера приема сокета и BGP. Пример <512-131072>.

remote_as

integer

Автономная система соседа.

send_buffer_size

integer

Установить размер буфера отправки сокета и BGP. Пример <4096-131072>.

session_open_mode

string

Установить сеанс BGP с использованием этого режима открытия TCP.

Варианты:

  • "active-only"
  • "both"
  • "passive-only"

shutdown

dictionary

Административно отключить этого соседа.

inheritance_disable

boolean

Запретить наследование отключения от родителя

Варианты:

  • false
  • true

set

boolean

Отключение.

Варианты:

  • false
  • true

tcp

dictionary

Команды конфигурации сеанса TCP.

mss

dictionary

Максимальный размер сегмента.

inheritance_disable

boolean

Запретить наследование mss от родителя

Варианты:

  • false
  • true

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-security от родителя

Варианты:

  • false
  • true

set

boolean

Установить ttl-security

Варианты:

  • false
  • true

update

dictionary

Конфигурация обновления BGP.

in

dictionary

Обработка входящих сообщений обновления.

filtering

dictionary

Фильтрация входящих сообщений обновления

attribute_filter

dictionary

Конфигурация фильтра атрибутов.

group

string

Имя группы.

logging

dictionary

Сообщение syslog о фильтрации обновлений.

disable

boolean

Отключить сообщение syslog о фильтрации обновлений.

Варианты:

  • false
  • true

update_message

dictionary

Отфильтрованные сообщения обновления.

buffers

integer

Количество буферов для хранения отфильтрованных сообщений обновления.

update_source

string

Источник маршрутизирующих обновлений. См. документацию поставщика для допустимых значений.

use

dictionary

Использовать шаблон группы соседей и группы сеансов.

neighbor_group

string

Наследовать конфигурацию от группы соседей.

session_group

string

Наследовать независимую от семейства адресов конфигурацию от группы сеансов

nsr

dictionary

Включить поддержку непрерывной маршрутизации для всех соседей.

disable

boolean

disable nsr

Choices:

  • false
  • true

set

boolean

set nsr

Choices:

  • false
  • true

rpki

dictionary

Настроить RPKI.

route

dictionary

Настроить маршрут RPKI. A.B.C.D/length или X:X::X/length Сеть/Минимальная длина префикса

max

integer

Максимальная длина префикса. Пример - <1-128>.

origin

integer

Номер автономной системы происхождения (в формате asplain) Пример - <1-4294967295>.

value

string

A.B.C.D/length или X:X::X/length Сеть/Минимальная длина префикса.

servers

list / elements=dictionary

Настроить серверы кэша RPKI.

name

string

адрес сервера rpki.

purge_time

integer

Время ожидания после выхода из строя кэша для очистки устаревших маршрутов

refresh_time

dictionary

Время между отправкой последовательных запросов для сервера кэша RPKI

time_off

boolean

Не отправлять последовательные запросы периодически

Choices:

  • false
  • true

value

integer

Время очистки (в секундах) <30-360>

response_time

dictionary

Время ожидания ответа от сервера кэша RPKI

time_off

boolean

Бесконечно ожидать ответа

Choices:

  • false
  • true

value

integer

Время очистки (в секундах) <15-3600>

shutdown

boolean

Выключить сервер кэша RPKI

Choices:

  • false
  • true

transport

dictionary

Указать метод транспорта для сервера кэша RPKI

ssh

dictionary

Подключиться к серверу кэша RPKI с помощью SSH

port

integer

Указать номер порта для транспорта сервера кэша RPKI

tcp

dictionary

Подключиться к серверу кэша RPKI с помощью TCP (без шифрования)

port

integer

Укажите номер порта для транспорта RPKI cache-server

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

отключить

Варианты:

  • false
  • true

ibgp

dictionary

Базовая обработка ошибок входящих сообщений обновления для соседей iBGP

disable

boolean

отключить

Варианты:

  • false
  • true

extended

dictionary

Расширенная обработка ошибок входящих сообщений обновления

ebgp

boolean

Расширенная обработка ошибок входящих сообщений обновления для соседей EBGP

Варианты:

  • false
  • true

ibgp

boolean

Расширенная обработка ошибок входящих сообщений обновления для соседей iBGP

Варианты:

  • false
  • true

limit

integer

Верхняя граница использования транзитной памяти для генерации обновлений. Пример - <16-2048>.

out

dictionary

Конфигурация генерации обновлений BGP.

logging

boolean

Включить ведение журнала событий генерации обновлений.

Варианты:

  • false
  • true

vrfs

list / elements=dictionary

Укажите имя vrf.

bfd

dictionary

Настройте параметры BFD.

minimum_interval

integer

Указывает значение minimum-interval сессии BFD для соседа.

multiplier

integer

Указывает значение multiplier сессии BFD для соседа.

bgp

dictionary

Команды BGP.

auto_policy_soft_reset

dictionary

Включить автоматическую мягкую перезагрузку пиров при перенастройке политики.

disable

boolean

Отключить автоматическую мягкую перезагрузку пиров Border Gateway Protocol (BGP).

Choices:

  • false
  • true

bestpath

dictionary

Выберите алгоритм выбора лучшего пути для маршрутов BGP.

aigp

dictionary

Атрибут AIGP

ignore

boolean

Игнорировать атрибут AIGP.

Choices:

  • false
  • true

as_path

dictionary

Выберите лучший путь на основе as-path.

ignore

boolean

игнорировать

Choices:

  • false
  • true

multipath_relax

boolean

multipath-relax

Choices:

  • false
  • true

compare_routerid

boolean

Сравнивать router-id для идентичных путей EBGP.

Choices:

  • false
  • true

cost_community

dictionary

Стоимость сообщества.

ignore

boolean

игнорировать cost_community

Choices:

  • false
  • true

med

dictionary

Атрибут MED

always

boolean

Разрешить сравнение MED от разных соседей.

Choices:

  • false
  • true

confed

boolean

Сравнивать MED среди путей конфедерации.

Choices:

  • false
  • true

missing_as_worst

boolean

Рассматривать отсутствующее значение MED как наименее предпочтительное.

Choices:

  • false
  • true

origin_as

dictionary

Параметры BGP origin-AS.

allow

dictionary

Параметры BGP origin-AS.

invalid

boolean

Выбор лучшего пути BGP позволит использовать «недопустимый» origin-AS

Choices:

  • false
  • true

use

dictionary

Параметры BGP origin-AS.

validity

boolean

Выбор лучшего пути BGP будет использовать валидность origin-AS

Choices:

  • false
  • true

default

dictionary

Настроить значение по умолчанию.

local_preference

integer

Локальное предпочтение.

Пожалуйста, обратитесь к документации поставщика для допустимых значений

enforce_first_as

dictionary

Принудительно использовать первый AS для маршрутов EBGP

disable

boolean

отключить принудительное использование 1-го as

Choices:

  • false
  • true

fast_external_fallover

dictionary

Немедленно сбросить сеанс, если связь с напрямую подключенным внешним пиром прерывается.

disable

boolean

отключить быстрое переключение на внешний маршрут.

Choices:

  • false
  • true

log

dictionary

Регистрировать информацию bgp

log_message

dictionary

Регистрировать входящие/исходящие сообщения соседа.

disable

boolean

отключить входящие/исходящие сообщения.

Choices:

  • false
  • true

neighbor

dictionary

Регистрировать информацию о состоянии соседа.

changes

dictionary

Регистрировать причины перехода соседа в состояние "включен/выключен" и сброса.

detail

boolean

подробно

Choices:

  • false
  • true

disable

boolean

отключить

Choices:

  • false
  • true

multipath

dictionary

Изменить критерии выбора многопутевого маршрута

as_path

dictionary

Путь AS

ignore

dictionary

Игнорировать проверку, связанную с путем AS, для выбора многопутевого маршрута.

onwards

boolean

Игнорировать все последующие пути AS для выбора многопутевого маршрута.

Choices:

  • false
  • true

redistribute_internal

boolean

Перераспределять внутренние маршруты BGP.

Choices:

  • false
  • true

router_id

string

Настроить Router-id. Пример- A.B.C.D IPv4 адрес.

unsafe_ebgp_policy

boolean

Разрешить eBGP-соседям без политики пропускать все маршруты (cisco-support).

Choices:

  • false
  • true

default_information

dictionary

Управление распределением информации по умолчанию.

originate

boolean

Распространять маршрут по умолчанию

Choices:

  • false
  • true

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 от родительского элемента.

Варианты:

  • false
  • true

set

boolean

Установить быстрое обнаружение

Варианты:

  • false
  • true

strict_mode

boolean

Удерживать сеанс соседа, пока сеанс BFD не будет установлен

Варианты:

  • false
  • true

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

Установить возможность получения

Варианты:

  • false
  • true

set

boolean

Установить возможность получения

Варианты:

  • false
  • true

send

dictionary

Возможность отправки дополнительных путей

disable

boolean

Установить возможность отправки

Варианты:

  • false
  • true

set

boolean

Установить возможность отправки

Варианты:

  • false
  • true

suppress

dictionary

Подавить объявление возможностей пиру.

all

dictionary

все возможности

inheritance_disable

boolean

Не наследовать эту конфигурацию от родительской группы.

Варианты:

  • false
  • true

set

boolean

установить все.

Варианты:

  • false
  • true

four_byte_AS

dictionary

Возможность 4-байтового AS

set

boolean

Установить 4_byte_as.

Choices:

  • false
  • true

cluster_id

string

Идентификатор кластера этого маршрутизатора, действующего как отражатель маршрутов.

description

string

Описание, специфичное для соседа.

dmz_link_bandwidth

dictionary

Распространять пропускную способность канала DMZ.

inheritance_disable

boolean

Не наследовать эту конфигурацию от родительской группы.

Choices:

  • false
  • true

set

boolean

Установить dmz-link-bandwidth.

Choices:

  • false
  • true

dscp

string

Установить IP DSCP (DiffServ CodePoint). Пожалуйста, обратитесь к документации поставщика для допустимых значений.

ebgp_multihop

dictionary

Разрешить соседей EBGP, не находящихся в непосредственно подключенных сетях.

mpls

boolean

Отключить переадресацию BGP MPLS.

Choices:

  • false
  • true

value

integer

максимальное количество переходов. Пример -<1-255>.

ebgp_recv_extcommunity_dmz

dictionary

Получать extcommunity dmz link bandwidth от соседа ebgp.

inheritance_disable

boolean

Предотвратить наследование ebgp-recv-community-dmz от родителя

Choices:

  • false
  • true

set

boolean

установить ebgp-recv-community-dmz.

Choices:

  • false
  • true

ebgp_send_extcommunity_dmz

dictionary

Отправить extcommunity dmz link bandwidth от соседа ebgp.

cumulatie

boolean

Отправить кумулятивную community dmz link bandwidth всех мультипутей соседу ebgp.

Choices:

  • false
  • true

inheritance_disable

boolean

Предотвратить наследование ebgp-send-community-dmz от родителя

Choices:

  • false
  • true

set

boolean

установить ebgp-send-community-dmz.

Choices:

  • false
  • true

egress_engineering

dictionary

Включить настройку исходящего пира для этого соседа.

inheritance_disable

boolean

Предотвратить наследование egress-engineering от родителя

Choices:

  • false
  • true

set

boolean

установить egress-engineering.

Choices:

  • false
  • true

enforce_first_as

dictionary

Принудительно устанавливать первый AS для маршрутов EBGP

disable

boolean

Отключить принудительную установку 1-го AS

Choices:

  • false
  • true

graceful_maintenance

dictionary

Атрибуты для плавного обслуживания. Это приведет к тому, что соседи будут отдавать предпочтение маршрутам от другого маршрутизатора и выбирать альтернативные. Это позволяет плавно вводить или выводить маршрутизатор из строя.

activate

dictionary

Маршруты будут объявлены с атрибутами плавного обслуживания при активации здесь или в конфигурации маршрутизатора bgp.

inheritance_disable

boolean

Запретить наследование activate от родителя.

Choices:

  • false
  • true

set

boolean

activate.

Choices:

  • false
  • true

as_prepends

dictionary

Количество раз для добавления локального номера AS к пути AS маршрутов. По умолчанию=0

inheritance_disable

boolean

Запретить наследование as prepends от родителя.

Choices:

  • false
  • true

value

integer

Диапазон значений для as prepends. Пример-<0-6>.

local_preference

dictionary

локальный приоритет, с которым объявлять маршруты ibgp соседям. По умолчанию=Без изменений

inheritance_disable

boolean

Запретить наследование local preference от родителя.

Choices:

  • false
  • true

value

integer

Диапазон значений для Local Preference. Пример-<0-4294967295>.

set

boolean

установить плавное обслуживание.

Choices:

  • false
  • true

graceful_restart

dictionary

Включить поддержку плавного перезапуска для этого соседа.

restart_time

integer

Время перезапуска, объявленное соседям в секундах <1-4095>.

stalepath_time

integer

Максимальное время ожидания перезапуска сопоставимых пар GR в секундах <1-4095>.

ignore_connected_check

dictionary

Пропустить проверку непосредственно подключенного nexthop для одношагового соединения eBGP

inheritance_disable

boolean

Запретить наследование ignore-connected-check от родителя

Choices:

  • false
  • true

set

boolean

установить ignore-connected-check.

Choices:

  • false
  • true

keychain

dictionary

Установить аутентификацию на основе keychain.

inheritance_disable

boolean

Запретить наследование keychain от родителя.

Choices:

  • false
  • true

name

string

Имя цепочки ключей — максимум 32 символа.

local

dictionary

Настройка локального параметра

address

dictionary

IPv4-адрес

inheritance_disable

boolean

Запретить наследование локального адреса от родительского.

Choices:

  • false
  • true

ipv4_address

string

IPv4-адрес <A.B.C.D>.

local_as

dictionary

Укажите локальный номер AS.

inheritance_disable

boolean

Запретить наследование локального AS от родительского.

Choices:

  • false
  • true

no_prepend

dictionary

Не добавлять локальный AS к объявлениям от этого соседа.

replace_as

dictionary

Добавлять только локальный AS к объявлениям этому соседу.

dual_as

boolean

Режим Dual-AS.

Choices:

  • false
  • true

set

boolean

Добавлять только локальный AS к объявлениям этому соседу.

Choices:

  • false
  • true

set

boolean

Не добавлять локальный AS к объявлениям от этого соседа.

Choices:

  • false
  • true

value

integer

2-байтовое, 4-байтовое число AS

log

dictionary

Регистрация сообщений обновления для каждого соседа.

log_message

dictionary

Регистрация сообщений обновления/уведомления для каждого соседа.

in

dictionary

Входящие сообщения журнала

disable

boolean

Отключить регистрацию входящих сообщений.

Choices:

  • false
  • true

inheritance_disable

boolean

Предотвращает наследование журнала сообщений от родительского элемента.

Choices:

  • false
  • true

value

integer

Диапазон для размера буфера журнала сообщений <1-100>.

out

dictionary

Исходящие сообщения журнала

disable

boolean

Отключить регистрацию входящих сообщений.

Choices:

  • false
  • true

inheritance_disable

boolean

Предотвращает наследование журнала сообщений от родительского элемента.

Choices:

  • false
  • true

value

integer

Диапазон для размера буфера журнала сообщений <1-100>.

neighbor_address

aliases: neighbor

string / required

Адрес маршрутизатора-соседа.

origin_as

dictionary

Параметры BGP origin-AS.

validation

dictionary

Параметры проверки BGP origin-AS.

disable

boolean

Отключить проверку RPKI origin-AS.

Choices:

  • false
  • true

password

dictionary

Установить пароль.

encrypted

string

Указывает, что будет следовать ЗАШИФРОВАННЫЙ пароль.

inheritance_disable

boolean

Запретить наследование пароля от родительского элемента.

Choices:

  • false
  • true

receive_buffer_size

integer

Установить размер буфера приема сокета и BGP. Пример <512-131072>.

remote_as

integer

Автономная система соседа.

send_buffer_size

integer

Установить размер буфера отправки сокета и BGP. Пример <4096-131072>.

session_open_mode

string

Установить сеанс BGP с использованием этого режима открытия TCP.

Choices:

  • "active-only"
  • "both"
  • "passive-only"

shutdown

dictionary

Административно отключить этого соседа.

inheritance_disable

boolean

Запретить наследование отключения от родительского элемента

Choices:

  • false
  • true

set

boolean

отключение.

Choices:

  • false
  • true

tcp

dictionary

Команды конфигурации сеанса TCP.

mss

dictionary

Максимальный размер сегмента.

inheritance_disable

boolean

Запретить наследование MSS от родительского элемента

Choices:

  • false
  • true

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-security от родительского элемента

Choices:

  • false
  • true

set

boolean

установить ttl-безопасность

Варианты:

  • false
  • true

update

dictionary

Конфигурация BGP обновления.

in

dictionary

Обработка входящих сообщений об обновлении.

filtering

dictionary

Фильтрация входящих сообщений об обновлении.

attribute_filter

dictionary

Настройка фильтра атрибутов.

group

string

Имя группы.

logging

dictionary

Сообщение syslog фильтрации обновлений.

disable

boolean

Отключить сообщение syslog фильтрации обновлений.

Варианты:

  • false
  • true

update_message

dictionary

Отфильтрованные сообщения об обновлениях.

buffers

integer

Количество буферов для хранения отфильтрованных сообщений об обновлениях.

update_source

string

Источник маршрутных обновлений. Для допустимых значений обратитесь к документации производителя.

use

dictionary

Использовать шаблон группы соседей и группы сессий.

neighbor_group

string

Наследовать конфигурацию из группы соседей.

session_group

string

Наследовать конфигурацию, независимую от семейства адресов, из группы сессий.

rd

dictionary

Дискриминатор маршрута.

auto

boolean

Автоматический дискриминатор маршрута.

Варианты:

  • false
  • true

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

Имя ВРФ.

running_config

string

Состояние, в котором должна быть оставлена конфигурация. - Состояние purged удаляет все конфигурации BGP с целевого устройства. Используйте с осторожностью. - Состояние deleted удаляет только атрибуты BGP, которые управляет этот модуль, и не отменяет процесс BGP полностью. Тем самым сохраняются конфигурации, относящиеся к семейству адресов, в контексте BGP. - Состояния deleted и replaced приведут к ошибке, если существуют строки конфигурации семейств адресов в контексте соседа или ВРФ, которые должны быть удалены. Используйте модули cisco.iosxr.iosxr_bgp_address_family или cisco.iosxr.iosxr_bgp_neighbor_address_family для предварительной очистки. - Обратитесь к примерам для получения более подробной информации.

состояние

строка

Состояние, в котором должна остаться конфигурация.

Варианты:

  • "deleted"
  • "merged" ← (по умолчанию)
  • "replaced"
  • "gathered"
  • "rendered"
  • "parsed"
  • "purged"
  • "overridden"

Примечания

Примечание

  • Этот модуль работает с подключением 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

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

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

Ключ

Описание

после

словарь

Вызов результата модели конфигурации.

Возвращается: при изменении

Пример: "The configuration returned will always be in the same format\n of the parameters above.\n"

перед

словарь

Конфигурация перед вызовом модели.

Возвращается: всегда

Пример: "The configuration returned will always be in the same format\n of the parameters above.\n"

команды

список / элементы=строка

Набор команд, отправленных на удаленное устройство.

Возвращается: всегда

Пример: ["router bgp 65536", "bgp cluster-id 5", "bgp router-id 192.0.2.10", "bgp bestpath med confed"]

собрано

список / элементы=строка

Данные о сетевом ресурсе, собранные с удаленного устройства в виде структурированных данных.

Возвращается: при состоянии равном gathered

Пример: ["This output will always be in the same format as the module argspec.\n"]

разбор

список / элементы=строка

Родная конфигурация устройства, предоставленная в параметре running_config, распарсенная в структурированные данные согласно спецификации аргументов модуля.

Возвращается: при состоянии равном parsed

Пример: ["This output will always be in the same format as the module argspec.\n"]

отображено

список / элементы=строка

Предоставленная конфигурация в задаче, отображенная в формате, родном для устройства (офлайн).

Возвращается: при состоянии равном rendered

Пример: ["router bgp 1", "default-metric 4", "vrf vrf3"]

Авторы

  • Ashwini Mhatre (@amhatre)

Ссылки на коллекцию

  • Система отслеживания ошибок
  • Репозиторий (источники)

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/iosxr/iosxr_bgp_global_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API