Модуль cisco.nxos.nxos_bgp_neighbor_address_family — Модуль ресурсов BGP Neighbor Address Family.

Примечание

Этот модуль является частью коллекции cisco.nxos (версия 8.1.0).

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

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

Для использования в книге задач укажите: cisco.nxos.nxos_bgp_neighbor_address_family.

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

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Этот модуль управляет конфигурацией BGP Neighbor Address Family на устройствах с Cisco NX-OS.

Параметры

Параметр	Комментарии
config dictionary	Конфигурация соседа BGP AF.
as_number string	Номер автономной системы маршрутизатора.
neighbors list / elements=dictionary	Список конфигураций соседа BGP AF.
address_family list / elements=dictionary	Конфигурации, связанные с семейством адресов соседа BGP.
advertise_map dictionary	Укажите route-map для условной рекламы.
exist_map string	Условный route-map для рекламы только тогда, когда префикс в условии существует.
non_exist_map string	Условный route-map для рекламы только тогда, когда префикс в условии не существует.
route_map string / required	Имя route-map.
advertisement_interval integer	Минимальный интервал между отправкой обновлений маршрутизации BGP.
afi string / required	Индикатор семейства адресов. Варианты: `"ipv4"` `"ipv6"` `"link-state"` `"vpnv4"` `"vpnv6"` `"l2vpn"`
allowas_in dictionary	Принимать as-path с моим AS, присутствующим в нём.
max_occurences integer	Количество вхождений номера AS, по умолчанию 3.
set boolean	Активировать свойство allowas-in. Варианты: `false` `true`
as_override boolean	Переопределить совпадающий номер AS при отправке обновления. Варианты: `false` `true`
capability dictionary	Рекламировать возможности пиру.
additional_paths dictionary	Возможность дополнительных путей.
receive string	Возможность получения дополнительных путей. Варианты: `"enable"` `"disable"`
send string	Возможность отправки дополнительных путей. Варианты: `"enable"` `"disable"`
default_originate dictionary	Создавать значение по умолчанию для этого пира.
route_map string	Route-map для указания критериев создания значения по умолчанию.
set boolean	Установить атрибут default-originate. Варианты: `false` `true`
disable_peer_as_check boolean	Отключить проверку номера AS пира при рекламировании. Варианты: `false` `true`

filter_list dictionary	Имя списка фильтров.
inbound string	Применить политику к входящим маршрутам.
outbound string	Применить политику к исходящим маршрутам.
inherit dictionary	Наследовать шаблон.
sequence integer	Номер последовательности.
template string	Имя шаблона.
maximum_prefix dictionary	Максимальное количество префиксов от этого соседа.
generate_warning_threshold integer	Пороговый процент, при достижении которого генерируется предупреждение.
max_prefix_limit integer	Максимальный предел префиксов.
restart_interval integer	Перезапустить соединение bgp после превышения лимита.
warning_only boolean	Выводить только предупреждающее сообщение при превышении лимита. Варианты: `false` `true`
next_hop_self dictionary	Установить наш адрес как next hop (без отражения).
all_routes boolean	Установить наш адрес как next hop для всех маршрутов. Варианты: `false` `true`
set boolean	Установить атрибут next-hop-self. Варианты: `false` `true`
next_hop_third_party boolean	Вычислить next hop третьей стороны, если это возможно. Варианты: `false` `true`
prefix_list dictionary	Применить список префиксов.
inbound string	Применить политику к входящим маршрутам.
outbound string	Применить политику к исходящим маршрутам.
rewrite_evpn_rt_asn boolean	Автоматически генерировать RT для соседа EBGP. Варианты: `false` `true`
rewrite_rt_asn boolean	Автоматически генерировать RT для соседа EBGP. Варианты: `false` `true`
route_map dictionary	Применить карту маршрутов к соседу.
inbound string	Применить политику к входящим маршрутам.
outbound string	Применить политику к исходящим маршрутам.

route_reflector_client boolean	Настроить соседа как клиента отражателя маршрутов. Варианты: `false` `true`
safi string	Индикатор подсемейства адресов. Варианты: `"unicast"` `"multicast"` `"mvpn"` `"evpn"`
send_community dictionary	Отправлять атрибут Community этому соседу.
both boolean	Отправлять стандартные и расширенные атрибуты Community. Варианты: `false` `true`
extended boolean	Отправлять атрибут Extended Community. Варианты: `false` `true`
set boolean	Установить атрибут send-community. Варианты: `false` `true`
standard boolean	Отправлять атрибут Standard Community. Варианты: `false` `true`
soft_reconfiguration_inbound dictionary	Мягкая переконфигурация.
always boolean	Всегда выполнять мягкую переконфигурацию по входящим данным. Варианты: `false` `true`
set boolean	Установить атрибут soft-reconfiguration inbound. Варианты: `false` `true`
soo string	Указать extcommunity источника сайта.
suppress_inactive boolean	Рекламировать только активные маршруты соседу. Варианты: `false` `true`
unsuppress_map string	Карта маршрутов для выборочной отмены подавления маршрутов.
weight integer	Установить значение по умолчанию для весов маршрутов от этого соседа.
neighbor_address string / обязательно	IP/IPv6 адрес соседа.
vrfs list / элементы=словарь	Виртуальный контекст маршрутизатора.
neighbors list / элементы=словарь	Список конфигурации BGP соседа AF.
address_family list / элементы=словарь	Конфигурации, связанные с BGP соседом Address Family.
advertise_map dictionary	Укажите карту маршрутов для условной рекламы.
exist_map string	Условие карты маршрутов для рекламы только тогда, когда префикс в условии существует.
non_exist_map string	Условие карты маршрутов для рекламы только тогда, когда префикс в условии не существует.

route_map string / required	Имя маршрутного плана.
advertisement_interval integer	Минимальный интервал между отправкой обновлений маршрутизации BGP.
afi string / required	Индикатор семейства адресов. Choices: `"ipv4"` `"ipv6"` `"link-state"` `"vpnv4"` `"vpnv6"` `"l2vpn"`
allowas_in dictionary	Принимать as-path с моим AS, присутствующим в нем.
max_occurences integer	Количество вхождений номера AS, по умолчанию 3.
set boolean	Активировать свойство allowas-in. Choices: `false` `true`
as_override boolean	Переопределить совпадающий номер AS при отправке обновления. Choices: `false` `true`
capability dictionary	Объявить о возможности пиру.
additional_paths dictionary	Возможность дополнительных путей.
receive string	Возможность приема дополнительных путей. Choices: `"enable"` `"disable"`
send string	Возможность отправки дополнительных путей. Choices: `"enable"` `"disable"`
default_originate dictionary	Генерировать значение по умолчанию для этого пира.
route_map string	Маршрутный план для указания критериев для генерации значения по умолчанию.
set boolean	Установить атрибут default-originate. Choices: `false` `true`
disable_peer_as_check boolean	Отключить проверку номера AS пира при рекламировании. Choices: `false` `true`
filter_list dictionary	Имя списка фильтров.
inbound string	Применить политику к входящим маршрутам.
outbound string	Применить политику к исходящим маршрутам.
inherit dictionary	Наследовать шаблон.
sequence integer	Порядковый номер.
template string	Имя шаблона.
maximum_prefix dictionary	Максимальное количество префиксов от этого соседа.

generate_warning_threshold integer	Пороговый процент, при достижении которого генерируется предупреждение.
max_prefix_limit integer	Максимальный предел префиксов.
restart_interval integer	Перезапустить соединение bgp после превышения предела.
warning_only boolean	Выводить только предупреждающее сообщение при превышении предела. Choices: `false` `true`
next_hop_self dictionary	Установить наш адрес как next-hop (без отражения).
all_routes boolean	Установить наш адрес как next-hop для всех маршрутов. Choices: `false` `true`
set boolean	Установить атрибут next-hop-self. Choices: `false` `true`
next_hop_third_party boolean	Вычислить next-hop третьей стороны, если возможно. Choices: `false` `true`
prefix_list dictionary	Применить список префиксов.
inbound string	Применить политику к входящим маршрутам.
outbound string	Применить политику к исходящим маршрутам.
rewrite_evpn_rt_asn boolean	Автоматически генерировать RT для соседа EBGP. Choices: `false` `true`
rewrite_rt_asn boolean	Автоматически генерировать RT для соседа EBGP. Choices: `false` `true`
route_map dictionary	Применить карту маршрутов к соседу.
inbound string	Применить политику к входящим маршрутам.
outbound string	Применить политику к исходящим маршрутам.
route_reflector_client boolean	Настроить соседа как клиента отражателя маршрутов. Choices: `false` `true`
safi string	Индикатор дополнительного семейства адресов. Choices: `"unicast"` `"multicast"` `"mvpn"` `"evpn"`
send_community dictionary	Отправить атрибут сообщества этому соседу.
both boolean	Отправить атрибуты стандартного и расширенного сообщества. Choices: `false` `true`
extended boolean	Отправить атрибут расширенного сообщества. Choices: `false` `true`

set boolean	Установить атрибут send-community. Варианты: `false` `true`
standard boolean	Отправлять атрибут Standard Community. Варианты: `false` `true`
soft_reconfiguration_inbound dictionary	Мягкая переконфигурация.
always boolean	Всегда выполнять мягкую переконфигурацию по входящим данным. Варианты: `false` `true`
set boolean	Установить атрибут soft-reconfiguration inbound. Варианты: `false` `true`
soo string	Указать extcommunity Site-of-origin.
suppress_inactive boolean	Рекламировать только активные маршруты соседу. Варианты: `false` `true`
unsuppress_map string	Карта маршрутов для выборочного снятия подавления подавленных маршрутов.
weight integer	Установить значение веса по умолчанию для маршрутов от этого соседа.
neighbor_address string / обязательно	IP/IPv6 адрес соседа.
vrf string	Имя VRf.
running_config string	Этот параметр используется только со state parsed. Значение этого параметра должно быть выводом, полученным от устройства NX-OS выполнением команды show running-config \| section ‘^router bgp’. State parsed считывает конфигурацию из параметра `running_config` и преобразует ее в структурированные данные Ansible в соответствии с argspec модуля ресурсов, а затем возвращает значение в ключе parsed в результате.
state string	Состояние, в котором должна оставаться конфигурация. Состояние deleted удаляет только атрибуты BGP, которые управляет этот модуль, и не полностью отменяет процесс BGP. См. примеры для получения дополнительной информации. Варианты: `"merged"` ← (по умолчанию) `"replaced"` `"overridden"` `"deleted"` `"parsed"` `"gathered"` `"rendered"`

Примечания

Примечание

Проверено на NX-OS 9.3.6.
Не поддерживается для Cisco MDS
Для управления конфигурациями семейства адресов BGP используйте модуль cisco.nxos.nxos_bgp_address_family.
Этот модуль работает с подключением network_cli и httpapi.

Примеры

# Using merged

# Before state:
# -------------
# Nexus9000v# show running-config | section "^router bgp"
# Nexus9000v#

- name: Merge the provided configuration with the existing running configuration
  cisco.nxos.nxos_bgp_neighbor_address_family: &id001
    config:
      as_number: 65536
      neighbors:
        - neighbor_address: 192.0.2.32
          address_family:
            - afi: ipv4
              safi: unicast
              maximum_prefix:
                max_prefix_limit: 20
                generate_warning_threshold: 75
              weight: 100
              prefix_list:
                inbound: rmap1
                outbound: rmap2
            - afi: ipv6
              safi: unicast
        - neighbor_address: 192.0.2.33
          address_family:
            - afi: ipv4
              safi: multicast
              inherit:
                template: BasePolicy
                sequence: 200
      vrfs:
        - vrf: site-1
          neighbors:
            - neighbor_address: 203.0.113.1
              address_family:
                - afi: ipv4
                  safi: unicast
                  suppress_inactive: true
                  next_hop_self:
                    set: true
            - neighbor_address: 203.0.113.2
              address_family:
                - afi: ipv6
                  safi: unicast
                - afi: ipv4
                  safi: multicast
                  send_community:
                    set: true

# Task output:
# ------------
#  before: {}
#
#  commands:
#  - router bgp 65536
#  - neighbor 192.0.2.32
#  - address-family ipv4 unicast
#  - maximum-prefix 20 75
#  - weight 100
#  - prefix-list rmap1 in
#  - prefix-list rmap2 out
#  - address-family ipv6 unicast
#  - neighbor 192.0.2.33
#  - address-family ipv4 multicast
#  - inherit peer-policy BasePolicy 200
#  - vrf site-1
#  - neighbor 203.0.113.1
#  - address-family ipv4 unicast
#  - suppress-inactive
#  - next-hop-self
#  - neighbor 203.0.113.2
#  - address-family ipv6 unicast
#  - address-family ipv4 multicast
#  - send-community
#
#  after:
#    as_number: "65536"
#    neighbors:
#      - neighbor_address: 192.0.2.32
#        address_family:
#          - afi: ipv4
#            safi: unicast
#            maximum_prefix:
#              max_prefix_limit: 20
#              generate_warning_threshold: 75
#            weight: 100
#            prefix_list:
#              inbound: rmap1
#              outbound: rmap2
#          - afi: ipv6
#            safi: unicast
#      - neighbor_address: 192.0.2.33
#        address_family:
#          - afi: ipv4
#            safi: multicast
#            inherit:
#              template: BasePolicy
#              sequence: 200
#    vrfs:
#      - vrf: site-1
#        neighbors:
#          - neighbor_address: 203.0.113.1
#            address_family:
#              - afi: ipv4
#                safi: unicast
#                suppress_inactive: true
#                next_hop_self:
#                  set: true
#          - neighbor_address: 203.0.113.2
#            address_family:
#              - afi: ipv4
#                safi: multicast
#                send_community:
#                  set: true
#              - afi: ipv6
#                safi: unicast

# After state:
# ------------
# Nexus9000v# show running-config | section "^router bgp"
# router bgp 65536
#   neighbor 192.0.2.32
#     address-family ipv4 unicast
#       maximum-prefix 20 75
#       weight 100
#       prefix-list rmap1 in
#       prefix-list rmap2 out
#     address-family ipv6 unicast
#   neighbor 192.0.2.33
#     address-family ipv4 multicast
#       inherit peer-policy BasePolicy 200
#   vrf site-1
#     neighbor 203.0.113.1
#       address-family ipv4 unicast
#         suppress-inactive
#         next-hop-self
#     neighbor 203.0.113.2
#       address-family ipv4 multicast
#         send-community
#       address-family ipv6 unicast
#

# Using replaced

# Before state:
# -------------
# Nexus9000v# show running-config | section "^router bgp"
# router bgp 65536
#   neighbor 192.0.2.32
#     address-family ipv4 unicast
#       maximum-prefix 20 75
#       weight 100
#       prefix-list rmap1 in
#       prefix-list rmap2 out
#     address-family ipv6 unicast
#   neighbor 192.0.2.33
#     address-family ipv4 multicast
#       inherit peer-policy BasePolicy 200
#   vrf site-1
#     neighbor 203.0.113.1
#       address-family ipv4 unicast
#         suppress-inactive
#         next-hop-self
#     neighbor 203.0.113.2
#       address-family ipv4 multicast
#         send-community
#       address-family ipv6 unicast
#

- name: Replace specified neighbor AFs with given configuration
  cisco.nxos.nxos_bgp_neighbor_address_family: &replaced
    config:
      as_number: 65536
      neighbors:
        - neighbor_address: 192.0.2.32
          address_family:
            - afi: ipv4
              safi: unicast
              weight: 110
            - afi: ipv6
              safi: unicast
        - neighbor_address: 192.0.2.33
          address_family:
            - afi: ipv4
              safi: multicast
              inherit:
                template: BasePolicy
                sequence: 200
      vrfs:
        - vrf: site-1
          neighbors:
            - neighbor_address: 203.0.113.1
              address_family:
                - afi: ipv4
                  safi: unicast
            - neighbor_address: 203.0.113.2
              address_family:
                - afi: ipv6
                  safi: unicast
                - afi: ipv4
                  safi: multicast
                  send_community:
                    set: true
    state: replaced

# Task output:
# ------------
#  before:
#    as_number: "65536"
#    neighbors:
#      - neighbor_address: 192.0.2.32
#        address_family:
#          - afi: ipv4
#            safi: unicast
#            maximum_prefix:
#              max_prefix_limit: 20
#              generate_warning_threshold: 75
#            weight: 100
#            prefix_list:
#              inbound: rmap1
#              outbound: rmap2
#          - afi: ipv6
#            safi: unicast
#      - neighbor_address: 192.0.2.33
#        address_family:
#          - afi: ipv4
#            safi: multicast
#            inherit:
#              template: BasePolicy
#              sequence: 200
#    vrfs:
#      - vrf: site-1
#        neighbors:
#          - neighbor_address: 203.0.113.1
#            address_family:
#              - afi: ipv4
#                safi: unicast
#                suppress_inactive: true
#                next_hop_self:
#                  set: true
#          - neighbor_address: 203.0.113.2
#            address_family:
#              - afi: ipv4
#                safi: multicast
#                send_community:
#                  set: true
#              - afi: ipv6
#                safi: unicast
#
#  commands:
#    - router bgp 65536
#    - neighbor 192.0.2.32
#    - address-family ipv4 unicast
#    - no maximum-prefix 20 75
#    - weight 110
#    - no prefix-list rmap1 in
#    - no prefix-list rmap2 out
#    - vrf site-1
#    - neighbor 203.0.113.1
#    - address-family ipv4 unicast
#    - no suppress-inactive
#    - no next-hop-self
#
#  after:
#    as_number: "65536"
#    neighbors:
#      - neighbor_address: 192.0.2.32
#        address_family:
#          - afi: ipv4
#            safi: unicast
#            weight: 110
#          - afi: ipv6
#            safi: unicast
#      - neighbor_address: 192.0.2.33
#        address_family:
#          - afi: ipv4
#            safi: multicast
#            inherit:
#              template: BasePolicy
#              sequence: 200
#    vrfs:
#      - vrf: site-1
#        neighbors:
#          - neighbor_address: 203.0.113.1
#            address_family:
#              - afi: ipv4
#                safi: unicast
#          - neighbor_address: 203.0.113.2
#            address_family:
#              - afi: ipv4
#                safi: multicast
#                send_community:
#                  set: true
#              - afi: ipv6
#                safi: unicast

# After state:
# ------------
# Nexus9000v# show running-config | section "^router bgp"
# router bgp 65536
#   neighbor 192.0.2.32
#     address-family ipv4 unicast
#       weight 110
#     address-family ipv6 unicast
#   neighbor 192.0.2.33
#     address-family ipv4 multicast
#       inherit peer-policy BasePolicy 200
#   vrf site-1
#     neighbor 203.0.113.1
#       address-family ipv4 unicast
#     neighbor 203.0.113.2
#       address-family ipv4 multicast
#         send-community
#       address-family ipv6 unicast
#

# Using overridden

# Before state:
# -------------
# Nexus9000v# show running-config | section "^router bgp"
# router bgp 65536
#   neighbor 192.0.2.32
#     address-family ipv4 unicast
#       maximum-prefix 20 75
#       weight 100
#       prefix-list rmap1 in
#       prefix-list rmap2 out
#     address-family ipv6 unicast
#   neighbor 192.0.2.33
#     address-family ipv4 multicast
#       inherit peer-policy BasePolicy 200
#   vrf site-1
#     neighbor 203.0.113.1
#       address-family ipv4 unicast
#         suppress-inactive
#         next-hop-self
#     neighbor 203.0.113.2
#       address-family ipv4 multicast
#         send-community
#       address-family ipv6 unicast
#

- name: Override all BGP AF configuration with provided configuration
  cisco.nxos.nxos_bgp_neighbor_address_family:
    config:
      as_number: 65536
      neighbors:
        - neighbor_address: 192.0.2.32
          address_family:
            - afi: ipv4
              safi: unicast
      vrfs:
        - vrf: site-1
          neighbors:
            - neighbor_address: 203.0.113.1
              address_family:
                - afi: ipv4
                  safi: unicast
                  suppress_inactive: true
                  next_hop_self:
                    set: true
    state: overridden

# Task output:
# ------------
#  before:
#    as_number: "65536"
#    neighbors:
#      - neighbor_address: 192.0.2.32
#        address_family:
#          - afi: ipv4
#            safi: unicast
#            maximum_prefix:
#              max_prefix_limit: 20
#              generate_warning_threshold: 75
#            weight: 100
#            prefix_list:
#              inbound: rmap1
#              outbound: rmap2
#          - afi: ipv6
#            safi: unicast
#      - neighbor_address: 192.0.2.33
#        address_family:
#          - afi: ipv4
#            safi: multicast
#            inherit:
#              template: BasePolicy
#              sequence: 200
#    vrfs:
#      - vrf: site-1
#        neighbors:
#          - neighbor_address: 203.0.113.1
#            address_family:
#              - afi: ipv4
#                safi: unicast
#                suppress_inactive: true
#                next_hop_self:
#                  set: true
#          - neighbor_address: 203.0.113.2
#            address_family:
#              - afi: ipv4
#                safi: multicast
#                send_community:
#                  set: true
#              - afi: ipv6
#                safi: unicast
#
#  commands:
#    - router bgp 65536
#    - neighbor 192.0.2.32
#    - address-family ipv4 unicast
#    - no maximum-prefix 20 75
#    - no weight 100
#    - no prefix-list rmap1 in
#    - no prefix-list rmap2 out
#    - no address-family ipv6 unicast
#    - neighbor 192.0.2.33
#    - no address-family ipv4 multicast
#    - vrf site-1
#    - neighbor 203.0.113.2
#    - no address-family ipv4 multicast
#    - no address-family ipv6 unicast
#
#  after:
#    as_number: "65536"
#    neighbors:
#      - neighbor_address: 192.0.2.32
#        address_family:
#          - afi: ipv4
#            safi: unicast
#    vrfs:
#      - vrf: site-1
#        neighbors:
#          - neighbor_address: 203.0.113.1
#            address_family:
#              - afi: ipv4
#                safi: unicast
#                suppress_inactive: true
#                next_hop_self:
#                  set: true

# After state:
# ------------
# Nexus9000v# show running-config | section "^router bgp"
# router bgp 65536
#   neighbor 192.0.2.32
#     address-family ipv4 unicast
#   vrf site-1
#     neighbor 203.0.113.1
#       address-family ipv4 unicast
#         suppress-inactive
#         next-hop-self

# Using deleted to remove specified neighbor AFs

# Before state:
# -------------
# Nexus9000v# show running-config | section "^router bgp"
# router bgp 65536
#   neighbor 192.0.2.32
#     address-family ipv4 unicast
#       maximum-prefix 20 75
#       weight 100
#       prefix-list rmap1 in
#       prefix-list rmap2 out
#     address-family ipv6 unicast
#   neighbor 192.0.2.33
#     address-family ipv4 multicast
#       inherit peer-policy BasePolicy 200
#   vrf site-1
#     neighbor 203.0.113.1
#       address-family ipv4 unicast
#         suppress-inactive
#         next-hop-self
#     neighbor 203.0.113.2
#       address-family ipv4 multicast
#         send-community
#       address-family ipv6 unicast
#

- name: Delete BGP configs handled by this module
  cisco.nxos.nxos_bgp_neighbor_address_family:
    config:
      as_number: 65536
      neighbors:
        - neighbor_address: 192.0.2.32
          address_family:
            - afi: ipv4
              safi: unicast
      vrfs:
        - vrf: site-1
          neighbors:
            - neighbor_address: 203.0.113.2
              address_family:
                - afi: ipv6
                  safi: unicast
    state: deleted

# Task output:
# ------------
#  before:
#    as_number: "65536"
#    neighbors:
#      - neighbor_address: 192.0.2.32
#        address_family:
#          - afi: ipv4
#            safi: unicast
#            maximum_prefix:
#              max_prefix_limit: 20
#              generate_warning_threshold: 75
#            weight: 100
#            prefix_list:
#              inbound: rmap1
#              outbound: rmap2
#          - afi: ipv6
#            safi: unicast
#      - neighbor_address: 192.0.2.33
#        address_family:
#          - afi: ipv4
#            safi: multicast
#            inherit:
#              template: BasePolicy
#              sequence: 200
#    vrfs:
#      - vrf: site-1
#        neighbors:
#          - neighbor_address: 203.0.113.1
#            address_family:
#              - afi: ipv4
#                safi: unicast
#                suppress_inactive: true
#                next_hop_self:
#                  set: true
#          - neighbor_address: 203.0.113.2
#            address_family:
#              - afi: ipv4
#                safi: multicast
#                send_community:
#                  set: true
#              - afi: ipv6
#                safi: unicast
#
#  commands:
#    - router bgp 65536
#    - neighbor 192.0.2.32
#    - no address-family ipv4 unicast
#    - vrf site-1
#    - neighbor 203.0.113.2
#    - no address-family ipv6 unicast
#
#  after:
#    as_number: "65536"
#    neighbors:
#      - neighbor_address: 192.0.2.32
#        address_family:
#          - afi: ipv6
#            safi: unicast
#      - neighbor_address: 192.0.2.33
#        address_family:
#          - afi: ipv4
#            safi: multicast
#            inherit:
#              template: BasePolicy
#              sequence: 200
#    vrfs:
#      - vrf: site-1
#        neighbors:
#          - neighbor_address: 203.0.113.1
#            address_family:
#              - afi: ipv4
#                safi: unicast
#                suppress_inactive: true
#                next_hop_self:
#                  set: true
#          - neighbor_address: 203.0.113.2
#            address_family:
#              - afi: ipv4
#                safi: multicast
#                send_community:
#                  set: true
#
# After state:
# ------------
# Nexus9000v# show running-config | section "^router bgp"
# router bgp 65536
#   neighbor 192.0.2.32
#     address-family ipv6 unicast
#   neighbor 192.0.2.33
#     address-family ipv4 multicast
#       inherit peer-policy BasePolicy 200
#   vrf site-1
#     neighbor 203.0.113.1
#       address-family ipv4 unicast
#         suppress-inactive
#         next-hop-self
#     neighbor 203.0.113.2
#       address-family ipv4 multicast
#         send-community
#

# Using deleted to remove all neighbor AFs

# Before state:
# -------------
# Nexus9000v# show running-config | section "^router bgp"
# router bgp 65536
#   neighbor 192.0.2.32
#     address-family ipv4 unicast
#       maximum-prefix 20 75
#       weight 100
#       prefix-list rmap1 in
#       prefix-list rmap2 out
#     address-family ipv6 unicast
#   neighbor 192.0.2.33
#     address-family ipv4 multicast
#       inherit peer-policy BasePolicy 200
#   vrf site-1
#     neighbor 203.0.113.1
#       address-family ipv4 unicast
#         suppress-inactive
#         next-hop-self
#     neighbor 203.0.113.2
#       address-family ipv4 multicast
#         send-community
#       address-family ipv6 unicast
#

- name: Delete all BGP neighbor AF configs handled by this module
  cisco.nxos.nxos_bgp_neighbor_address_family:
    state: deleted

# Task output:
# ------------
#  before:
#    as_number: "65536"
#    neighbors:
#      - neighbor_address: 192.0.2.32
#        address_family:
#          - afi: ipv4
#            safi: unicast
#            maximum_prefix:
#              max_prefix_limit: 20
#              generate_warning_threshold: 75
#            weight: 100
#            prefix_list:
#              inbound: rmap1
#              outbound: rmap2
#          - afi: ipv6
#            safi: unicast
#      - neighbor_address: 192.0.2.33
#        address_family:
#          - afi: ipv4
#            safi: multicast
#            inherit:
#              template: BasePolicy
#              sequence: 200
#    vrfs:
#      - vrf: site-1
#        neighbors:
#          - neighbor_address: 203.0.113.1
#            address_family:
#              - afi: ipv4
#                safi: unicast
#                suppress_inactive: true
#                next_hop_self:
#                  set: true
#          - neighbor_address: 203.0.113.2
#            address_family:
#              - afi: ipv4
#                safi: multicast
#                send_community:
#                  set: true
#              - afi: ipv6
#                safi: unicast
#
#  commands:
#    - router bgp 65536
#    - neighbor 192.0.2.32
#    - no address-family ipv4 unicast
#    - no address-family ipv6 unicast
#    - neighbor 192.0.2.33
#    - no address-family ipv4 multicast
#    - vrf site-1
#    - neighbor 203.0.113.1
#    - no address-family ipv4 unicast
#    - neighbor 203.0.113.2
#    - no address-family ipv6 unicast
#    - no address-family ipv4 multicast
#
#  after:
#    as_number: "65536"
#
# After state:
# ------------
# Nexus9000v# show running-config | section "^router bgp"
# router bgp 65536
#   neighbor 192.0.2.32
#   neighbor 192.0.2.33
#   vrf site-1
#     neighbor 203.0.113.1
#     neighbor 203.0.113.2
#

# Using rendered

- name: Render platform specific configuration lines with state rendered (without connecting to the device)
  cisco.nxos.nxos_bgp_neighbor_address_family:
    config:
      as_number: 65536
      neighbors:
        - neighbor_address: 192.0.2.32
          address_family:
            - afi: ipv4
              safi: unicast
              maximum_prefix:
                max_prefix_limit: 20
                generate_warning_threshold: 75
              weight: 100
              prefix_list:
                inbound: rmap1
                outbound: rmap2
            - afi: ipv6
              safi: unicast
        - neighbor_address: 192.0.2.33
          address_family:
            - afi: ipv4
              safi: multicast
              inherit:
                template: BasePolicy
                sequence: 200
      vrfs:
        - vrf: site-1
          neighbors:
            - neighbor_address: 203.0.113.1
              address_family:
                - afi: ipv4
                  safi: unicast
                  suppress_inactive: true
                  next_hop_self:
                    set: true
            - neighbor_address: 203.0.113.2
              address_family:
                - afi: ipv6
                  safi: unicast
                - afi: ipv4
                  safi: multicast
                  send_community:
                    set: true
    state: rendered

# Task output:
# ------------
#  rendered:
#    - router bgp 65536
#    - neighbor 192.0.2.32
#    - address-family ipv4 unicast
#    - maximum-prefix 20 75
#    - weight 100
#    - prefix-list rmap1 in
#    - prefix-list rmap2 out
#    - address-family ipv6 unicast
#    - neighbor 192.0.2.33
#    - address-family ipv4 multicast
#    - inherit peer-policy BasePolicy 200
#    - vrf site-1
#    - neighbor 203.0.113.1
#    - address-family ipv4 unicast
#    - suppress-inactive
#    - next-hop-self
#    - neighbor 203.0.113.2
#    - address-family ipv6 unicast
#    - address-family ipv4 multicast
#    - send-community

# Using parsed

# parsed.cfg
# ------------
# router bgp 65536
#   neighbor 192.0.2.32
#     address-family ipv4 unicast
#       maximum-prefix 20 75
#       weight 100
#       prefix-list rmap1 in
#       prefix-list rmap2 out
#     address-family ipv6 unicast
#   neighbor 192.0.2.33
#     address-family ipv4 multicast
#       inherit peer-policy BasePolicy 200
#   vrf site-1
#     neighbor 203.0.113.1
#       address-family ipv4 unicast
#         suppress-inactive
#         next-hop-self
#     neighbor 203.0.113.2
#       address-family ipv4 multicast
#         send-community
#       address-family ipv6 unicast

- name: Parse externally provided BGP neighbor AF config
  register: result
  cisco.nxos.nxos_bgp_neighbor_address_family:
    running_config: "{{ lookup('file', 'parsed.cfg') }}"
    state: parsed

# Task output:
# ------------
#  parsed:
#    as_number: "65536"
#    neighbors:
#      - neighbor_address: 192.0.2.32
#        address_family:
#          - afi: ipv4
#           safi: unicast
#           maximum_prefix:
#              max_prefix_limit: 20
#              generate_warning_threshold: 75
#           weight: 100
#            prefix_list:
#              inbound: rmap1
#              outbound: rmap2
#          - afi: ipv6
#            safi: unicast
#      - neighbor_address: 192.0.2.33
#        address_family:
#          - afi: ipv4
#            safi: multicast
#            inherit:
#              template: BasePolicy
#              sequence: 200
#    vrfs:
#      - vrf: site-1
#        neighbors:
#          - neighbor_address: 203.0.113.1
#            address_family:
#              - afi: ipv4
#                safi: unicast
#                suppress_inactive: true
#                next_hop_self:
#                  set: true
#          - neighbor_address: 203.0.113.2
#            address_family:
#              - afi: ipv4
#                safi: multicast
#                send_community:
#                  set: true
#              - afi: ipv6
#                safi: unicast

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

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

Ключ	Описание
after словарь	Результирующая конфигурация после выполнения модуля. Возвращается: при изменении Пример: `"This output will always be in the same format as the module argspec.\n"`
before словарь	Конфигурация до выполнения модуля. Возвращается: когда состояние равно `merged`, `replaced`, `overridden`, `deleted` или `purged` Пример: `"This output will always be in the same format as the module argspec.\n"`
commands список / элементы=строка	Набор команд, отправленных на удалённое устройство. Возвращается: когда состояние равно `merged`, `replaced`, `overridden`, `deleted` или `purged` Пример: `["router bgp 65536", "neighbor 192.0.2.32", "address-family ipv4 unicast"]`
gathered словарь	Факты о сетевом ресурсе, собранные с удалённого устройства в виде структурированных данных. Возвращается: когда состояние равно `gathered` Пример: `"This output will always be in the same format as the module argspec.\n"`
parsed словарь	Родная конфигурация устройства, предоставленная в опции running_config, разобранная в структурированные данные в соответствии с argspec модуля. Возвращается: когда состояние равно `parsed` Пример: `"This output will always be in the same format as the module argspec.\n"`
rendered список / элементы=строка	Предоставленная конфигурация в задаче, представленная в формате, родном для устройства (офлайн). Возвращается: когда состояние равно `rendered` Пример: `["router bgp 65536", "neighbor 192.0.2.32", "address-family ipv4 unicast"]`

Авторы

Nilashish Chakraborty (@NilashishC)

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

© 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/nxos/nxos_bgp_neighbor_address_family_module.html