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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install cisco.iosxr.

Чтобы использовать её в плейбуке, укажите: cisco.iosxr.iosxr_bgp_neighbor_address_family.

Добавлено в cisco.iosxr 2.0.0

Краткое описание
Параметры
Примечания
Примеры

Краткое описание

Этот модуль настраивает атрибуты глобальных параметров BGP на платформах Cisco IOS-XR и управляет ими.

Примечание

Этому модулю соответствует модуль действий.

Псевдонимы: bgp_neighbor_address_family

Параметры

Параметр	Комментарии
config dictionary	Настройки адресного семейства BGP-соседа.
as_number string	Номер автономной системы.
neighbors list / elements=dictionary	Список настроек адресных семейств BGP-соседей.
address_family list / elements=dictionary	Включить адресное семейство и перейти в режим его настройки
afi string	Адресное семейство. Варианты: `"ipv4"` `"ipv6"` `"l2vpn"` `"link-state"` `"vpnv4"` `"vpnv6"`
aigp dictionary	Атрибут AIGP
disable boolean	Игнорировать атрибут AIGP. Варианты: `false` `true`
send_cost_community_disable boolean	Отправлять атрибут AIGP. Варианты: `false` `true`
send_med dictionary	Параметры отправки MED.
disable boolean	Отключить передачу значения AIGP в MED. Варианты: `false` `true`
set boolean	Установить передачу значения AIGP в MED. Варианты: `false` `true`
set boolean	Установить атрибут AIGP. Варианты: `false` `true`
allowas_in dictionary	Разрешить AS-path, содержащий номер моей AS.
set boolean	Установить allowas_in Варианты: `false` `true`
value integer	Число вхождений номера AS: 1–10.
as_override dictionary	Заменять совпадающий номер AS при отправке обновления
inheritance_disable boolean	Запретить наследование as-override от родительского элемента. Варианты: `false` `true`
set boolean	Установить as_override Варианты: `false` `true`
bestpath_origin_as_allow_invalid boolean	Изменить критерии выбора маршрута по умолчанию. Разрешить параметры BGP origin-AS. Варианты: `false` `true`
capability_orf_prefix string	Объявить этому соседу возможность ORF для префиксов адресов. Варианты: `"both"` `"send"` `"none"` `"receive"`
default_originate dictionary	Создавать маршрут по умолчанию для этого соседа.
inheritance_disable boolean	Запретить наследование default-originate от родительского элемента. Варианты: `false` `true`
route_policy string	Политика маршрутизации, задающая критерии создания маршрута по умолчанию
set boolean	Установить маршрут по умолчанию. Варианты: `false` `true`
long_lived_graceful_restart dictionary	Включить поддержку длительного graceful restart.
capable boolean	Считать соседа поддерживающим LLGR. Варианты: `false` `true`
stale_time dictionary	Максимальное время ожидания перед удалением устаревших маршрутов длительного хранения.
accept integer	Максимальное время принятия
send integer	Максимальное время отправки
maximum_prefix dictionary	Максимальное количество префиксов, принимаемых от этого соседа.
discard_extra_paths boolean	Отбрасывать дополнительные пути при превышении лимита. Варианты: `false` `true`
max_limit integer	Максимальное количество префиксов. <1-4294967295.
restart integer	Интервал времени до перезапуска.
threshold_value integer	Пороговое значение (%) для выдачи предупреждения <1-100>.
warning_only boolean	Выдавать только предупреждение при превышении лимита. Варианты: `false` `true`
multipath boolean	Пути от этого соседа могут использоваться для многопутевой маршрутизации. Варианты: `false` `true`
next_hop_self dictionary	Отключить вычисление следующего узла для этого соседа.
inheritance_disable boolean	Запретить наследование next_hop_self от родительского элемента. Варианты: `false` `true`
set boolean	Установить собственный следующий узел. Варианты: `false` `true`
next_hop_unchanged dictionary	Отключить вычисление следующего узла для этого соседа.
inheritance_disable boolean	Запретить наследование next_hop_unchanged от родительского элемента. Варианты: `false` `true`
multipath boolean	Не изменять следующий узел перед объявлением нескольких путей. Варианты: `false` `true`
set boolean	Не изменять следующий узел. Варианты: `false` `true`
optimal_route_reflection_group_name string	Настроить группу оптимального отражения маршрутов.
orf_route_policy string	Указать ORF и критерии входящей фильтрации.’
origin_as dictionary	Параметры BGP origin-AS.
validation dictionary	Параметры проверки BGP origin-AS.
disable boolean	Отключить проверку origin-AS с помощью RPKI. Варианты: `false` `true`
remove_private_AS dictionary	Удалять номер частной AS из исходящих обновлений.
entire_aspath boolean	Удалять только в том случае, если все AS в пути являются частными. Варианты: `false` `true`
inbound boolean	Удалять номер частной AS из входящих обновлений. Варианты: `false` `true`
inheritance_disable boolean	Запретить наследование remove-private-AS от родительского элемента. Варианты: `false` `true`
set boolean	Включить удаление частных AS. Варианты: `false` `true`
route_policy dictionary	Применить политику маршрутизации к соседу.
inbound string	Применить политику маршрутизации к входящим маршрутам.
outbound string	Применить политику маршрутизации к исходящим маршрутам.
route_reflector_client dictionary	Настроить соседа в качестве клиента отражателя маршрутов.

inheritance_disable boolean	Запретить наследование route-reflector-client от родительского элемента. Варианты: `false` `true`
set boolean	Установить route-reflector-client. Варианты: `false` `true`
safi string	Модификатор семейства адресов Варианты: `"flowspec"` `"mdt"` `"multicast"` `"mvpn"` `"rt-filter"` `"tunnel"` `"unicast"` `"labeled-unicast"`
send_community_ebgp dictionary	Отправлять атрибут community этому внешнему соседу.
inheritance_disable boolean	Запретить наследование send_community_ebgp от родительского элемента. Варианты: `false` `true`
set boolean	Установить send_community_ebgp. Варианты: `false` `true`
send_community_gshut_ebgp dictionary	Разрешить отправку community g-shut этому внешнему соседу.
inheritance_disable boolean	Запретить наследование send_community_gshut_ebgp от родительского элемента. Варианты: `false` `true`
set boolean	Установить send_community_gshut_ebgp. Варианты: `false` `true`
send_extended_community_ebgp dictionary	Отправлять атрибут extended community этому внешнему соседу.
inheritance_disable boolean	Запретить наследование send_extended_community_ebgp от родительского элемента. Варианты: `false` `true`
set boolean	Установить send_extended_community_ebgp. Варианты: `false` `true`
send_multicast_attributes dictionary	Отправлять атрибуты multicast этому соседу.
disable boolean	Отключить отправку атрибутов multicast. Варианты: `false` `true`
set boolean	Установить send_multicast_attributes. Варианты: `false` `true`
soft_reconfiguration dictionary	Мягкая реконфигурация для каждого соседа.
inbound dictionary	Входящая мягкая реконфигурация
always boolean	Разрешить входящую мягкую реконфигурацию для этого соседа. Всегда использовать мягкую реконфигурацию, даже если поддерживается обновление маршрутов. Варианты: `false` `true`
inheritance_disable boolean	Запретить наследование soft_reconfiguration от родительского элемента. Варианты: `false` `true`
set boolean	Установить inbound Варианты: `false` `true`
validation dictionary	Проверка Flowspec для этого соседа.
disable boolean	Отключить проверку. Варианты: `false` `true`
redirect boolean	Проверка следующего узла перенаправления Flowspec. Варианты: `false` `true`
set boolean	Установить validation. Варианты: `false` `true`
weight integer	Задать вес по умолчанию для маршрутов от этого соседа.
neighbor_address string / обязательный	Адрес маршрутизатора-соседа.
vrfs list / elements=dictionary	Настройка соседства BGP для VRF.
neighbors list / elements=dictionary	Список конфигураций семейств адресов соседей BGP.
address_family list / elements=dictionary	Включить семейство адресов и перейти в режим его настройки
afi string	Семейство адресов. Варианты: `"ipv4"` `"ipv6"`
aigp dictionary	Атрибут AIGP
disable boolean	Игнорировать атрибут AIGP. Варианты: `false` `true`
send_cost_community_disable boolean	Отправлять атрибут AIGP. Варианты: `false` `true`
send_med dictionary	Параметры отправки MED.
disable boolean	Отключить отправку значения AIGP в MED. Варианты: `false` `true`
set boolean	Установить отправку значения AIGP в MED. Варианты: `false` `true`
set boolean	Установить атрибут AIGP. Варианты: `false` `true`
allowas_in dictionary	Разрешить путь AS, содержащий номер моей AS.
set boolean	Установить allowas_in Варианты: `false` `true`
value integer	Количество вхождений номера AS: от 1 до 10.
as_override псевдонимы: as_overrride dictionary	Заменять совпадающий номер AS при отправке обновления
inheritance_disable boolean	Запретить наследование as-override от родительского элемента. Варианты: `false` `true`
set boolean	Установить as_override Варианты: `false` `true`
capability_orf_prefix string	Объявлять этому соседу возможность ORF для префиксов адресов. Варианты: `"both"` `"send"` `"none"` `"receive"`
default_originate dictionary	Анонсировать маршрут по умолчанию этому соседу.
inheritance_disable boolean	Запретить наследование default-originate от родительского элемента. Варианты: `false` `true`
route_policy string	Политика маршрутизации для задания критериев анонсирования маршрута по умолчанию
set boolean	Установить маршрут по умолчанию. Варианты: `false` `true`
long_lived_graceful_restart dictionary	Включить поддержку длительного graceful restart.
capable boolean	Считать соседа поддерживающим LLGR. Варианты: `false` `true`
stale_time dictionary	Максимальное время ожидания перед удалением устаревших маршрутов длительного хранения.
accept integer	Максимальное время приема
send integer	Максимальное время отправки
maximum_prefix dictionary	Максимальное число префиксов, принимаемых от этого узла.

discard_extra_paths boolean	Отбрасывать дополнительные пути при превышении лимита. Варианты: `false` `true`
max_limit integer	Максимальное количество префиксов. <1-4294967295.
restart integer	Интервал времени до перезапуска.
threshold_value integer	Значение порога (%) для создания предупреждения <1-100>.
warning_only boolean	Выдавать только предупреждение при превышении лимита. Варианты: `false` `true`
multipath boolean	Пути от этого соседа могут использоваться для многопутевой маршрутизации. Варианты: `false` `true`
next_hop_self dictionary	Отключить вычисление следующего узла для этого соседа.
inheritance_disable boolean	Запретить наследование next_hop_self от родительского объекта. Варианты: `false` `true`
set boolean	Задать следующий узел как собственный. Варианты: `false` `true`
next_hop_unchanged dictionary	Отключить вычисление следующего узла для этого соседа.
inheritance_disable boolean	Запретить наследование next_hop_unchanged от родительского объекта. Варианты: `false` `true`
multipath boolean	Не заменять next-hop перед анонсированием нескольких путей. Варианты: `false` `true`
set boolean	Оставить следующий узел без изменений. Варианты: `false` `true`
optimal_route_reflection_group_name string	Настроить группу оптимального отражения маршрутов.
orf_route_policy string	Указать ORF и критерии входящей фильтрации.’
remove_private_AS dictionary	Удалить номер частной AS из исходящих обновлений.
entire_aspath boolean	Удалять только в том случае, если все AS в пути являются частными. Варианты: `false` `true`
inbound boolean	Удалить номер частной AS из входящих обновлений. Варианты: `false` `true`
inheritance_disable boolean	Запретить наследование remove-private-AS от родительского объекта. Варианты: `false` `true`
set boolean	Задать удаление частных AS. Варианты: `false` `true`
route_policy dictionary	Применить политику маршрутизации к соседу.
inbound string	Применить политику маршрутизации к входящим маршрутам.
outbound string	Применить политику маршрутизации к исходящим маршрутам.
route_reflector_client dictionary	Настроить соседа в качестве клиента Route Reflector.
inheritance_disable boolean	Запретить наследование route-reflector-client от родительского объекта. Варианты: `false` `true`
set boolean	Задать route-reflector-client. Варианты: `false` `true`
safi string	Модификатор семейства адресов Варианты: `"flowspec"` `"multicast"` `"mvpn"` `"unicast"` `"labeled-unicast"`
send_community_ebgp dictionary	Отправлять атрибут community этому внешнему соседу.
inheritance_disable boolean	Запретить наследование send_community_ebgp от родительского объекта. Варианты: `false` `true`
set boolean	Задать send_community_ebgp. Варианты: `false` `true`
send_community_gshut_ebgp dictionary	Разрешить отправку community g-shut этому внешнему соседу.
inheritance_disable boolean	Запретить наследование send_community_gshut_ebgp от родительского объекта. Варианты: `false` `true`
set boolean	Задать send_community_gshut_ebgp. Варианты: `false` `true`
send_extended_community_ebgp dictionary	Отправлять атрибут extended community этому внешнему соседу.
inheritance_disable boolean	Запретить наследование send_extended_community_ebgp от родительского объекта. Варианты: `false` `true`
set boolean	Задать send_extended_community_ebgp. Варианты: `false` `true`
site_of_origin string	Расширенный атрибут community Site-of-Origin, связанный с соседом.
soft_reconfiguration dictionary	Мягкая реконфигурация для каждого соседа.
inbound dictionary	Входящая мягкая реконфигурация
always boolean	Разрешить входящую мягкую реконфигурацию для этого соседа. Всегда использовать мягкую реконфигурацию, даже если поддерживается обновление маршрутов. Варианты: `false` `true`
inheritance_disable boolean	Запретить наследование soft_reconfiguration от родительского объекта. Варианты: `false` `true`
set boolean	Задать inbound Варианты: `false` `true`
validation dictionary	Проверка Flowspec для этого соседа.
disable boolean	Отключить проверку. Варианты: `false` `true`
redirect boolean	Проверка next-hop перенаправления Flowspec. Варианты: `false` `true`
set boolean	Задать проверку. Варианты: `false` `true`
weight integer	Задать вес по умолчанию для маршрутов от этого соседа.
neighbor_address string / обязательный	Адрес соседнего маршрутизатора.
vrf string	Имя VRF.
running_config string	Этот параметр используется только при состоянии parsed. Значением этого параметра должен быть вывод, полученный с устройства Iosxr при выполнении команды show running-config router bgp. Состояние parsed считывает конфигурацию из параметра `running_config` и преобразует её в структурированные данные Ansible в соответствии со спецификацией аргументов модуля ресурса, после чего значение возвращается в ключе parsed результата.
state string	Состояние, в котором должна остаться конфигурация. Варианты: `"deleted"` `"merged"` ← (по умолчанию) `"overridden"` `"replaced"` `"gathered"` `"rendered"` `"parsed"`

Примечания

Примечание

Этот модуль работает с подключением network_cli.

Примеры

# Using merged
# Before state:
# -------------
# RP/0/0/CPU0:iosxr-02#show running-config router bgp
# Sat Feb 20 03:49:43.618 UTC
# router bgp 65536
#  bgp router-id 192.0.2.1
#  address-family ipv4 unicast
#  address-family vpnv4 unicast
#  neighbor 192.0.2.2
#   remote-as 65537
#  neighbor 192.0.2.3
#   remote-as 65538
#  vrf vrf1
#   rd auto
#   neighbor 192.0.2.4
#    remote-as 65539
#  vrf vrf2
#   rd auto
#   neighbor 192.0.2.5
#    remote-as 65540

- name: Merge the provided configuration with the existing running configuration
  cisco.iosxr.iosxr_bgp_neighbor_address_family:
    state: merged
    config:
      as_number: 65536
      neighbors:
        - neighbor_address: 192.0.2.2
          address_family:
            - afi: ipv4
              safi: unicast
              multipath: true
              default_originate:
                set: true
              weight: 5
        - neighbor_address: 192.0.2.3
          address_family:
            - afi: ipv4
              safi: unicast
              multipath: true
              default_originate:
                set: true
              weight: 4
      vrfs:
        - vrf: vrf1
          neighbors:
            - neighbor_address: 192.0.2.4
              address_family:
                - afi: ipv4
                  safi: unicast
                  multipath: true
                  default_originate:
                    set: true
                  capability_orf_prefix: both
        - vrf: vrf2
          neighbors:
            - neighbor_address: 192.0.2.5
              address_family:
                - afi: ipv4
                  safi: unicast
                  multipath: true
                  default_originate:
                    set: true
                  capability_orf_prefix: both
# Task output
# -------------
# commands:
# - router bgp 65536
# - neighbor 192.0.2.2
# - address-family ipv4 unicast
# - default-originate
# - multipath
# - weight 5
# - neighbor 192.0.2.3
# - address-family ipv4 unicast
# - default-originate
# - multipath
# - weight 4
# - vrf vrf1
# - neighbor 192.0.2.4
# - address-family ipv4 unicast
# - capability orf prefix both
# - default-originate
# - multipath
# - vrf vrf2
# - neighbor 192.0.2.5
# - address-family ipv4 unicast
# - capability orf prefix both
# - default-originate
# - multipath
#
#
# after:
#   as_number: 65536
#   neighbors:
#     - neighbor_address: 192.0.2.2
#       address_family:
#         - afi: "ipv4"
#           safi: "unicast"
#           multipath: true
#           default_originate:
#             set: true
#           weight: 5
#     - neighbor_address: 192.0.2.3
#       address_family:
#         - afi: "ipv4"
#           safi: "unicast"
#           multipath: true
#           default_originate:
#             set: true
#           weight: 4
#   vrfs:
#     - vrf: vrf1
#       neighbors:
#         - neighbor_address: 192.0.2.4
#           address_family:
#             - afi: "ipv4"
#               safi: "unicast"
#               multipath: true
#               default_originate:
#                 set: true
#               capability_orf_prefix: both
#     - vrf: vrf2
#       neighbors:
#         - neighbor_address: 192.0.2.5
#           address_family:
#             - afi: "ipv4"
#               safi: "unicast"
#               multipath: true
#               default_originate:
#                 set: true
#               capability_orf_prefix: both
#
#
# After state:
# -------------
# RP/0/0/CPU0:iosxr-02#show running-config router bgp
# Sat Feb 20 03:49:43.618 UTC
# router bgp 65536
#  bgp router-id 192.0.1.1
#  address-family ipv4 unicast
#  address-family vpnv4 unicast
#  neighbor 192.0.2.2
#   remote-as 65537
#   address-family ipv4 unicast
#     multipath
#     weight 5
#     default-originate
#  neighbor 1.1.1.2
#   remote-as 65538
#   address-family ipv4 unicast
#     multipath
#     weight 5
#     default-originate
#  vrf vrf1
#   rd auto
#   neighbor 192.0.2.4
#    remote-as 65539
#    address-family ipv4 unicast
#     multipath
#     capability orf prefix both
#     default-originate
#  vrf vrf2
#   rd auto
#   neighbor 192.0.2.5
#    remote-as 65540
#    address-family ipv4 unicast
#     multipath
#     capability orf prefix both
#     default-originate
#
#
# Using delete
# Before state:
# -------------
#
# RP/0/0/CPU0:iosxr-02#show running-config router bgp
# Sat Feb 20 03:49:43.618 UTC
# router bgp 65536
#  bgp router-id 192.0.1.1
#  address-family ipv4 unicast
#  address-family vpnv4 unicast
#  neighbor 192.0.2.2
#   remote-as 65537
#   address-family ipv4 unicast
#     multipath
#     weight 5
#     default-originate
#  neighbor 192.0.2.3
#   remote-as 65538
#   address-family ipv4 unicast
#     multipath
#     weight 5
#     default-originate
#  vrf vrf1
#   rd auto
#   neighbor 192.0.2.4
#    remote-as 65539
#    address-family ipv4 unicast
#     multipath
#     capability orf prefix both
#     default-originate
#  vrf vrf2
#   rd auto
#   neighbor 192.0.2.5
#    remote-as 65540
#    address-family ipv4 unicast
#     multipath
#     capability orf prefix both
#     default-originate

- name: Delete the provided configuration
  cisco.iosxr.iosxr_bgp_neighbor_address_family:
    state: deleted
    config:
      as_number: 65536
      neighbors:
        - neighbor_address: 192.0.2.2
          address_family:
            - afi: ipv4
              safi: unicast
              multipath: true
              default_originate:
                set: true
              weight: 5

# Task output
# -------------
#
# commands:
# - router bgp 65536
# - neighbor 192.0.2.2
# - no address-family ipv4 unicast
#
#
# after:
#   as_number: 65536
#   neighbors:
#     - neighbor_address: 192.0.2.3
#       address_family:
#         - afi: "ipv4"
#           safi: "unicast"
#           multipath: true
#           default_originate:
#             set: true
#           weight: 4
#   vrfs:
#     - vrf: vrf1
#       neighbors:
#         - neighbor_address: 192.0.2.4
#           address_family:
#             - afi: "ipv4"
#               safi: "unicast"
#               multipath: true
#               default_originate:
#                 set: true
#               capability_orf_prefix: both
#         - neighbor_address: 192.0.2.5
#           address_family:
#             - afi: "ipv4"
#               safi: "unicast"
#               multipath: true
#               default_originate:
#                 set: true
#               capability_orf_prefix: both
#
#
# Using Replaced
# Before state:
# -------------
#
# RP/0/0/CPU0:iosxr-02#show running-config router bgp
# Sat Feb 20 03:49:43.618 UTC
# router bgp 65536
#  bgp router-id 192.0.1.1
#  address-family ipv4 unicast
#  address-family vpnv4 unicast
#  neighbor 192.0.2.2
#   remote-as 65537
#   address-family ipv4 unicast
#     multipath
#     weight 5
#     default-originate
#  neighbor 192.0.2.3
#   remote-as 65538
#   address-family ipv4 unicast
#     multipath
#     weight 5
#     default-originate
#  vrf vrf1
#   rd auto
#   neighbor 192.0.2.4
#    remote-as 65539
#    address-family ipv4 unicast
#     multipath
#     capability orf prefix both
#     default-originate
#  vrf vrf2
#   rd auto
#   neighbor 192.0.2.5
#    remote-as 65540
#    address-family ipv4 unicast
#     multipath
#     capability orf prefix both
#     default-originate

- name: Replace the provided configuration with the existing running configuration
  cisco.iosxr.iosxr_bgp_neighbor_address_family:
    state: replaced
    config:
      as_number: 65536
      neighbors:
        - neighbor_address: 192.0.2.2
          address_family:
            - afi: ipv4
              safi: unicast
              default_originate:
                set: true
              weight: 4
# Task output
# -------------
# commands:
# - router bgp 65536
# - neighbor 192.0.2.2
# - address-family ipv4 unicast
# - no multipath
# - weight 4
#
# after:
#   as_number: 65536
#   neighbors:
#     - neighbor_address: 192.0.2.2
#       address_family:
#         - afi: "ipv4"
#           safi: "unicast"
#           multipath: true
#           default_originate:
#             set: true
#           weight: 4
#     - neighbor_address: 192.0.2.3
#       address_family:
#         - afi: "ipv4"
#           safi: "unicast"
#           multipath: true
#           default_originate:
#             set: true
#           weight: 5
#   vrfs:
#     - vrf: vrf1
#       neighbors:
#         - neighbor_address: 192.0.2.4
#           address_family:
#             - afi: "ipv4"
#               safi: "unicast"
#               multipath: true
#               default_originate:
#                 set: true
#               capability_orf_prefix: both
#         - neighbor_address: 192.0.2.5
#           address_family:
#             - afi: "ipv4"
#               safi: "unicast"
#               multipath: true
#               default_originate:
#                 set: true
#               capability_orf_prefix: both
#
# After state:
# -------------
# Nexus9000v# show running-config router bgp
# router bgp 65536
#  bgp router-id 192.0.1.1
#  address-family ipv4 unicast
#  address-family vpnv4 unicast
#  neighbor 192.0.2.2
#   remote-as 65537
#   address-family ipv4 unicast
#     multipath
#     weight 4
#     default-originate
#  neighbor 192.0.2.3
#   remote-as 65538
#   address-family ipv4 unicast
#     multipath
#     weight 5
#     default-originate
#  vrf vrf1
#   rd auto
#   neighbor 192.0.2.4
#    remote-as 65539
#    address-family ipv4 unicast
#     multipath
#     capability orf prefix both
#     default-originate
#  vrf vrf2
#   rd auto
#   neighbor 192.0.2.5
#    remote-as 65540
#    address-family ipv4 unicast
#     multipath
#     capability orf prefix both
#     default-originate
#
#
# Using overridden
# Before state:
# -------------
# RP/0/0/CPU0:iosxr-02#show running-config router bgp
# Sat Feb 20 03:49:43.618 UTC
# router bgp 65536
#  bgp router-id 192.0.1.1
#  address-family ipv4 unicast
#  address-family vpnv4 unicast
#  neighbor 192.0.2.2
#   remote-as 65537
#   address-family ipv4 unicast
#     multipath
#     weight 5
#     default-originate
#  neighbor 192.0.2.3
#   remote-as 65538
#   address-family ipv4 unicast
#     multipath
#     weight 5
#     default-originate
#  vrf vrf1
#   rd auto
#   neighbor 192.0.2.4
#    remote-as 65539
#    address-family ipv4 unicast
#     multipath
#     capability orf prefix both
#     default-originate
#  vrf vrf2
#   rd auto
#   neighbor 192.0.2.5
#    remote-as 65540
#    address-family ipv4 unicast
#     multipath
#     capability orf prefix both
#     default-originate

- name: override the provided configuration
  cisco.iosxr.iosxr_bgp_neighbor_address_family:
    state: overridden
    config:
      as_number: 65536
      neighbors:
        - neighbor_address: 192.0.2.2
          address_family:
            - afi: ipv4
              safi: unicast
              multipath: true
              default_originate:
                set: true
              weight: 5
# Task output
# -------------
#
# commands:
# - router bgp 65536
# - neighbor 192.0.2.3
# - no address-family ipv4 unicast
# - vrf vrf1
# - neighbor 192.0.2.4
# - no address-family ipv4 unicast
# - vrf vrf1
# - neighbor 192.0.2.5
# - no address-family ipv4 unicast
#
#
#
# after:
#   as_number: 65536
#   neighbors:
#     - neighbor_address: 192.0.2.2
#       address_family:
#         - afi: "ipv4"
#           safi: "unicast"
#           multipath: true
#           default_originate:
#             set: true
#           weight: 5
#
# After state:
# -------------
# RP/0/0/CPU0:iosxr-02#show running-config router bgp
# Sat Feb 20 03:49:43.618 UTC
# router bgp 65536
#  bgp router-id 192.0.1.1
#  address-family ipv4 unicast
#  address-family vpnv4 unicast
#  neighbor 192.0.2.2
#   remote-as 65537
#   address-family ipv4 unicast
#     multipath
#     weight 5
#     default-originate
#
#
#
# Using rendered
# Before state:
# -------------
# RP/0/0/CPU0:iosxr-02#show running-config router bgp
# Sat Feb 20 03:49:43.618 UTC
# router bgp 65536
#  bgp router-id 192.0.2.1
#  address-family ipv4 unicast
#  address-family vpnv4 unicast
#  neighbor 192.0.2.2
#   remote-as 65537
#  neighbor 192.0.2.3
#   remote-as 65538
#  vrf vrf1
#   rd auto
#   neighbor 192.0.2.4
#    remote-as 65539
#  vrf vrf2
#   rd auto
#   neighbor 192.0.2.5
#    remote-as 65540

- name: >-
    Render platform specific configuration lines with state rendered (without
    connecting to the device)
  cisco.iosxr.iosxr_bgp_neighbor_address_family:
    state: rendered
    config:
      as_number: 65536
      neighbors:
        - neighbor_address: 192.0.2.2
          address_family:
            - afi: ipv4
              safi: unicast
              multipath: true
              default_originate:
                set: true
              weight: 5
        - neighbor_address: 192.0.2.3
          address_family:
            - afi: ipv4
              safi: unicast
              multipath: true
              default_originate:
                set: true
              weight: 4
      vrfs:
        - vrf: vrf1
          neighbors:
            - neighbor_address: 192.0.2.4
              address_family:
                - afi: ipv4
                  safi: unicast
                  multipath: true
                  default_originate:
                    set: true
                  capability_orf_prefix: both
        - vrf: vrf2
          neighbors:
            - neighbor_address: 192.0.2.5
              address_family:
                - afi: ipv4
                  safi: unicast
                  multipath: true
                  default_originate:
                    set: true
                  capability_orf_prefix: both
# Task output
# -------------
# commands:
# - router bgp 65536
# - neighbor 192.0.2.2
# - address-family ipv4 unicast
# - default-originate
# - multipath
# - weight 5
# - neighbor 192.0.2.3
# - address-family ipv4 unicast
# - default-originate
# - multipath
# - weight 4
# - vrf vrf1
# - neighbor 192.0.2.4
# - address-family ipv4 unicast
# - capability orf prefix both
# - default-originate
# - multipath
# - vrf vrf2
# - neighbor 192.0.2.5
# - address-family ipv4 unicast
# - capability orf prefix both
# - default-originate
# - multipath
#
# Using parsed
#
# parsed.cfg
# ------------
# router bgp 65536
#  bgp router-id 192.0.1.1
#  address-family ipv4 unicast
#  address-family vpnv4 unicast
#  neighbor 192.0.2.2
#   remote-as 65537
#   address-family ipv4 unicast
#     multipath
#     weight 5
#     default-originate
#  neighbor 1.1.1.2
#   remote-as 65538
#   address-family ipv4 unicast
#     multipath
#     weight 5
#     default-originate
#  vrf vrf1
#   rd auto
#   neighbor 192.0.2.4
#    remote-as 65539
#    address-family ipv4 unicast
#     multipath
#     capability orf prefix both
#     default-originate
#  vrf vrf2
#   rd auto
#   neighbor 192.0.2.5
#    remote-as 65540
#    address-family ipv4 unicast
#     multipath
#     capability orf prefix both
#     default-originate

- name: Parse externally provided BGP neighbor AF config
  cisco.iosxr.iosxr_bgp_neighbor_address_family:
    running_config: "{{ lookup('file', 'parsed.cfg') }}"
    state: parsed
# Task output (redacted)
# -----------------------
# parsed:
#   as_number: 65536
#   neighbors:
#     - neighbor_address: 192.0.2.2
#       address_family:
#         - afi: "ipv4"
#           safi: "unicast"
#           multipath: true
#           default_originate:
#             set: true
#           weight: 5
#     - neighbor_address: 192.0.2.3
#       address_family:
#         - afi: "ipv4"
#           safi: "unicast"
#           multipath: true
#           default_originate:
#             set: true
#           weight: 4
#   vrfs:
#     - vrf: vrf1
#       neighbors:
#         - neighbor_address: 192.0.2.4
#           address_family:
#             - afi: "ipv4"
#               safi: "unicast"
#               multipath: true
#               default_originate:
#                 set: true
#               capability_orf_prefix: both
#     - vrf: vrf2
#       neighbors:
#         - neighbor_address: 192.0.2.5
#           address_family:
#             - afi: "ipv4"
#               safi: "unicast"
#               multipath: true
#               default_originate:
#                 set: true
#               capability_orf_prefix: both
#
#
# Using Gathered
# -----------------
# Before state state:
# -------------
# RP/0/0/CPU0:iosxr-02#show running-config router bgp
# Sat Feb 20 03:49:43.618 UTC
# router bgp 65536
#  bgp router-id 192.0.1.1
#  address-family ipv4 unicast
#  address-family vpnv4 unicast
#  neighbor 192.0.2.2
#   remote-as 65537
#   address-family ipv4 unicast
#     multipath
#     weight 5
#     default-originate
#  neighbor 1.1.1.2
#   remote-as 65538
#   address-family ipv4 unicast
#     multipath
#     weight 5
#     default-originate
#  vrf vrf1
#   rd auto
#   neighbor 192.0.2.4
#    remote-as 65539
#    address-family ipv4 unicast
#     multipath
#     capability orf prefix both
#     default-originate
#  vrf vrf2
#   rd auto
#   neighbor 192.0.2.5
#    remote-as 65540
#    address-family ipv4 unicast
#     multipath
#     capability orf prefix both
#     default-originate
#
#
#
- name: Gathered the provided configuration with the existing running configuration
  cisco.iosxr.iosxr_bgp_neighbor_address_family:
    config:
    state: gathered


# Task output
# -----------------------
# gathered:
#   as_number: 65536
#   neighbors:
#     - neighbor_address: 192.0.2.2
#       address_family:
#         - afi: "ipv4"
#           safi: "unicast"
#           multipath: true
#           default_originate:
#             set: true
#           weight: 5
#     - neighbor_address: 192.0.2.3
#       address_family:
#         - afi: "ipv4"
#           safi: "unicast"
#           multipath: true
#           default_originate:
#             set: true
#           weight: 4
#   vrfs:
#     - vrf: vrf1
#       neighbors:
#         - neighbor_address: 192.0.2.4
#           address_family:
#             - afi: "ipv4"
#               safi: "unicast"
#               multipath: true
#               default_originate:
#                 set: true
#               capability_orf_prefix: both
#     - vrf: vrf2
#       neighbors:
#         - neighbor_address: 192.0.2.5
#           address_family:
#             - afi: "ipv4"
#               safi: "unicast"
#               multipath: true
#               default_originate:
#                 set: true
#               capability_orf_prefix: both
#

Авторы

Ashwini Mhatre (@amhatre)

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

© 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_neighbor_address_family_module.html