Модуль cisco.nxos.nxos_ospfv3 — модуль ресурсов OSPFv3

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install cisco.nxos.

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

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

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

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

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

Примечание

Для этого модуля существует соответствующий плагин действий.

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

Параметры

Параметр	Комментарии
config dictionary	Список конфигураций процессов OSPFv3.
processes list / elements=dictionary	Список конфигураций экземпляров OSPFv3.
address_family dictionary	Параметры OSPFv3 для семейства адресов IPv6 unicast.
afi string	Настройка параметров OSPFv3 в семействе адресов IPv6. Варианты: `"ipv6"`
areas list / elements=dictionary	Настройка свойств областей OSPF в семействе адресов.
area_id string / обязательный	Идентификатор области в формате IP-адреса.
default_cost integer	Укажите стоимость по умолчанию.
filter_list list / elements=dictionary	Фильтрация префиксов между областями OSPF.
direction string / обязательный	Направление применения карты маршрутов. Варианты: `"in"` `"out"`
route_map string / обязательный	Имя карты маршрутов.
ranges list / elements=dictionary	Настройка диапазона адресов для области.
cost integer	Стоимость, используемая для диапазона.
not_advertise boolean	Запретить анонсирование указанного диапазона. Варианты: `false` `true`
prefix string / обязательный	IP-адрес в формате префикса (x.x.x.x/len)
default_information dictionary	Управление распространением маршрутов по умолчанию.
originate dictionary	Распространение маршрута по умолчанию.
always boolean	Всегда анонсировать маршрут по умолчанию. Варианты: `false` `true`
route_map string	Политика управления распространением маршрутов по умолчанию
set boolean	Включить распространение маршрута по умолчанию. Варианты: `false` `true`
distance integer	Настройка административного расстояния OSPF.
maximum_paths integer	Максимальное количество путей к одному назначению.
redistribute list / elements=dictionary	Перераспределение информации из другого протокола маршрутизации.
id string	Идентификатор указанного протокола.
protocol string / обязательный	Название протокола. Варианты: `"bgp"` `"direct"` `"eigrp"` `"isis"` `"lisp"` `"ospfv3"` `"rip"` `"static"`
route_map string / обязательный	Политика карты маршрутов для ограничения перераспределения.
safi string	Настройка параметров OSPFv3 в семействе адресов IPv6 unicast. Варианты: `"unicast"`
summary_address list / elements=dictionary	Настройка суммирования маршрутов для перераспределения.
not_advertise boolean	Запретить анонсирование указанного суммарного маршрута. Варианты: `false` `true`
prefix string / обязательный	Формат префикса IPv6: ‘xxxx:xxxx/ml’, ‘xxxx:xxxx::/ml’ или ‘xxxx::xx/128’
tag integer	32-разрядное значение метки.
table_map dictionary	Политика фильтрации или изменения маршрутов OSPF перед их передачей в RIB.
filter boolean	Блокировать передачу маршрутов OSPF в RIB. Варианты: `false` `true`
name string / обязательный	Имя карты маршрутов.
timers dictionary	Настройка параметров таймеров.
throttle dictionary	Настройка параметров ограничения частоты операций.
spf dictionary	Настройка таймеров SPF для OSPF.
initial_spf_delay integer	Начальная задержка планирования SPF в миллисекундах.
max_wait_time integer	Максимальное время ожидания между вычислениями SPF.
min_hold_time integer	Минимальное время ожидания между вычислениями SPF.
areas list / elements=dictionary	Настройка свойств областей OSPF.
area_id string / обязательный	Идентификатор области в формате IP-адреса.
nssa dictionary	Параметры NSSA для области.
default_information_originate boolean	Создать LSA типа 7 маршрута по умолчанию в области NSSA. Варианты: `false` `true`
no_redistribution boolean	Не отправлять перераспределяемые LSA в область NSSA. Варианты: `false` `true`
no_summary boolean	Не отправлять суммарные LSA в область NSSA. Варианты: `false` `true`
route_map string	Политика управления распространением маршрута по умолчанию.
set boolean	Настроить область как NSSA. Варианты: `false` `true`
translate dictionary	Преобразование LSA.
type7 dictionary	Преобразование из типа 7 в тип 5.
always boolean	Всегда преобразовывать LSA Варианты: `false` `true`
never boolean	Никогда не преобразовывать LSA Варианты: `false` `true`
supress_fa boolean	Подавлять адрес пересылки в преобразованных LSA. Варианты: `false` `true`
stub dictionary	Параметры настройки области как тупиковой.
no_summary boolean	Запретить ABR отправлять суммарные LSA в тупиковую область. Варианты: `false` `true`
set boolean	Настроить область как тупиковую. Варианты: `false` `true`
auto_cost dictionary	Вычислять стоимость OSPF на основе пропускной способности.
reference_bandwidth integer / обязательный	Эталонная пропускная способность, используемая для назначения стоимости OSPF.
unit string / обязательный	Укажите единицу измерения эталонной пропускной способности. Варианты: `"Gbps"` `"Mbps"`
flush_routes boolean	Удалять маршруты при контролируемом перезапуске без сохранения состояния. Варианты: `false` `true`
graceful_restart dictionary	Настройка корректного перезапуска.
grace_period integer	Настройка максимального интервала для корректного перезапуска.
helper_disable boolean	Включить или отключить режим помощника. Варианты: `false` `true`

planned_only boolean	Включить graceful restart только для запланированного перезапуска Варианты: `false` `true`
set boolean	Включить graceful restart. Варианты: `false` `true`
isolate boolean	Изолировать этот маршрутизатор с точки зрения OSPF. Варианты: `false` `true`
log_adjacency_changes dictionary	Записывать изменения состояния смежности в журнал.
detail boolean	Уведомлять обо всех изменениях состояния. Варианты: `false` `true`
log boolean	Включить или отключить запись изменений состояния смежности в журнал. Варианты: `false` `true`
max_lsa dictionary	Функция ограничения количества не созданных данным маршрутизатором LSA.
ignore_count integer	Задать количество случаев, в которых смежности могут быть подавлены.
ignore_time integer	Задать период, в течение которого все смежности подавляются.
max_non_self_generated_lsa integer / обязательный	Задать максимальное количество LSA, созданных не этим маршрутизатором.
reset_time integer	Задать количество минут, по истечении которых счетчик ignore-count обнуляется.
threshold integer	Пороговое значение (%), при достижении которого создается предупреждение.
warning_only boolean	Записывать предупреждение в журнал при превышении лимита. Варианты: `false` `true`
max_metric dictionary	Установить максимальное значение метрики стоимости.
router_lsa dictionary	Настройка Router LSA.
external_lsa dictionary	Настройка внешних LSA.
max_metric_value integer	Задать максимальное значение метрики для внешних LSA.
set boolean	Установить атрибут external-lsa. Варианты: `false` `true`
inter_area_prefix_lsa dictionary	Настройка межзональных LSA с префиксами.
max_metric_value integer	Максимальное значение метрики для суммарных LSA.
set boolean	Установить атрибут summary-lsa. Варианты: `false` `true`
on_startup dictionary	Действует только при запуске.
set boolean	Установить атрибут on-startup. Варианты: `false` `true`
wait_for_bgp_asn integer	ASN BGP, которого следует ожидать.
wait_period integer	Период ожидания в секундах после запуска.
set boolean	Установить атрибут router-lsa. Варианты: `false` `true`
stub_prefix_lsa boolean	Анонсировать максимальную метрику также для Stub-соединений. Варианты: `false` `true`
name_lookup boolean	Отображать идентификаторы маршрутизаторов OSPF в виде DNS-имен. Варианты: `false` `true`
passive_interface dictionary	Подавить обновления маршрутизации на интерфейсе.
default boolean	По умолчанию интерфейсы являются пассивными. Варианты: `false` `true`
process_id string / обязательный	Тег процесса OSPF.
router_id string	Задать идентификатор маршрутизатора для процесса OSPF.
shutdown boolean	Отключить экземпляр протокола OSPF. Варианты: `false` `true`
timers dictionary	Настроить параметры, связанные с таймерами.
lsa_arrival integer	Минимальный интервал между получением LSA.
lsa_group_pacing integer	Интервал обновления/максимального срока действия группы LSA.
throttle dictionary	Настроить параметры, связанные с ограничением частоты.
lsa dictionary	Настроить ограничение частоты создания LSA.
hold_interval integer	Интервал удержания.
max_interval integer	Максимальный интервал.
start_interval integer	Начальный интервал.
vrfs list / elements=dictionary	Настроить параметры OSPF для конкретных VRF.
areas list / elements=dictionary	Настроить свойства областей OSPF.
area_id string / обязательный	Идентификатор области в формате IP-адреса.
nssa dictionary	Параметры NSSA для области.
default_information_originate boolean	Создавать LSA типа 7 по умолчанию в области NSSA. Варианты: `false` `true`
no_redistribution boolean	Не отправлять перераспределенные LSA в область NSSA. Варианты: `false` `true`
no_summary boolean	Не отправлять суммарные LSA в область NSSA. Варианты: `false` `true`
route_map string	Политика управления распространением маршрута по умолчанию.
set boolean	Настроить область как NSSA. Варианты: `false` `true`
translate dictionary	Преобразовывать LSA.
type7 dictionary	Преобразовывать тип 7 в тип 5.
always boolean	Всегда преобразовывать LSA Варианты: `false` `true`
never boolean	Никогда не преобразовывать LSA Варианты: `false` `true`
supress_fa boolean	Подавлять адрес пересылки в преобразованных LSA. Варианты: `false` `true`
stub dictionary	Параметры настройки области как Stub.
no_summary boolean	Запретить ABR отправлять суммарные LSA в область Stub. Варианты: `false` `true`
set boolean	Настроить область как Stub. Варианты: `false` `true`
auto_cost dictionary	Вычислять стоимость OSPF на основе пропускной способности.
reference_bandwidth integer / обязательный	Эталонная пропускная способность, используемая для назначения стоимости OSPF.
unit string / обязательный	Указать единицу измерения эталонной пропускной способности. Варианты: `"Gbps"` `"Mbps"`
graceful_restart dictionary	Настроить graceful restart.
grace_period integer	Настроить максимальный интервал для graceful restart.

helper_disable boolean	Включить или отключить режим помощника. Варианты: `false` `true`
planned_only boolean	Включить graceful restart только для запланированного перезапуска Варианты: `false` `true`
set boolean	Включить graceful restart. Варианты: `false` `true`
log_adjacency_changes dictionary	Записывать в журнал изменения состояния смежности.
detail boolean	Уведомлять обо всех изменениях состояния. Варианты: `false` `true`
log boolean	Включить или отключить запись изменений состояния смежности в журнал. Варианты: `false` `true`
max_lsa dictionary	Функция ограничения количества LSА, созданных не этим маршрутизатором.
ignore_count integer	Задать количество раз, которое можно подавлять смежности.
ignore_time integer	Задать время, в течение которого подавляются все смежности.
max_non_self_generated_lsa integer / обязательный	Задать максимальное количество LSА, созданных не этим маршрутизатором.
reset_time integer	Задать время в минутах, по истечении которого ignore-count сбрасывается до нуля.
threshold integer	Пороговое значение (%) для формирования предупреждения.
warning_only boolean	Записывать предупреждение в журнал при превышении ограничения. Варианты: `false` `true`
max_metric dictionary	Установить максимальное значение метрики стоимости.
router_lsa dictionary	Настройка Router LSA.
external_lsa dictionary	Настройка внешних LSA.
max_metric_value integer	Задать максимальное значение метрики для внешних LSA.
set boolean	Задать атрибут external-lsa. Варианты: `false` `true`
inter_area_prefix_lsa dictionary	Настройка межобластных LSA префиксов.
max_metric_value integer	Максимальное значение метрики для суммарных LSA.
set boolean	Задать атрибут summary-lsa. Варианты: `false` `true`
on_startup dictionary	Действует только при запуске.
set boolean	Задать атрибут on-startup. Варианты: `false` `true`
wait_for_bgp_asn integer	ASN BGP, ожидание которого требуется.
wait_period integer	Время ожидания в секундах после запуска.
set boolean	Задать атрибут router-lsa. Варианты: `false` `true`
stub_prefix_lsa boolean	Также объявлять максимальную метрику для stub-соединений. Варианты: `false` `true`
name_lookup boolean	Отображать идентификаторы маршрутизаторов OSPF в виде DNS-имен. Варианты: `false` `true`
passive_interface dictionary	Отключить отправку обновлений маршрутизации через интерфейс.
default boolean	По умолчанию интерфейсы являются пассивными. Варианты: `false` `true`
router_id string	Задать router-id процесса OSPF.
shutdown boolean	Завершить работу экземпляра протокола OSPF. Варианты: `false` `true`
timers dictionary	Настроить параметры таймеров.
lsa_arrival integer	Минимальный интервал между получением LSA.
lsa_group_pacing integer	Интервал обновления или maxage для группы LSA.
throttle dictionary	Настроить параметры ограничения частоты.
lsa dictionary	Настроить ограничение частоты генерации LSA.
hold_interval integer	Интервал удержания.
max_interval integer	Максимальный интервал.
start_interval integer	Начальный интервал.
vrf string / обязательный	Имя или идентификатор VRF.
running_config string	Этот параметр используется только при состоянии parsed. Значением этого параметра должен быть вывод, полученный с устройства NX-OS при выполнении команды show running-config \| section “^router ospfv3”. Состояние parsed считывает конфигурацию из параметра `running_config` и преобразует её в структурированные данные Ansible в соответствии со спецификацией аргументов модуля ресурса, после чего значение возвращается в ключе parsed в составе результата.
state string	Состояние, в котором должна остаться конфигурация. Варианты: `"merged"` ← (по умолчанию) `"replaced"` `"overridden"` `"deleted"` `"gathered"` `"parsed"` `"rendered"`

Примечания

Примечание

Проверено на NX-OS 7.0(3)I5(1).
Не поддерживается на Cisco MDS
Этот модуль работает с подключениями network_cli и httpapi.

Примеры

# Using merged

# Before state:
# -------------
# nxos-9k-rdo# sh running-config | section "^router ospfv3"
# nxos-9k-rdo#

- name: Merge the provided configuration with the existing running configuration
  cisco.nxos.nxos_ospfv3:
    config:
      processes:
        - process_id: 100
          router_id: 203.0.113.20
        - process_id: 102
          router_id: 198.51.100.1
          address_family:
            afi: ipv6
            safi: unicast
            areas:
              - area_id: 0.0.0.100
                filter_list:
                  - route_map: rmap_1
                    direction: in
                  - route_map: rmap_2
                    direction: out
                ranges:
                  - prefix: '2001:db2::/32'
                    not_advertise: true
                  - prefix: '2001:db3::/32'
                    cost: 120
            redistribute:
              - protocol: eigrp
                id: 120
                route_map: rmap_1
              - protocol: direct
                route_map: ospf102-direct-connect
          vrfs:
            - vrf: zone1
              router_id: 198.51.100.129
              areas:
                - area_id: 0.0.0.102
                  nssa:
                    default_information_originate: true
                    no_summary: true
                - area_id: 0.0.0.103
                  nssa:
                    no_summary: true
                    translate:
                      type7:
                        always: true
            - vrf: zone2
              auto_cost:
                reference_bandwidth: 45
                unit: Gbps
    state: merged

# Task output:
# ------------
# before: {}
#
# commands:
#  - router ospf 102
#  - router-id 198.51.100.1
#  - address-family ipv6 unicast
#  - redistribute eigrp 120 route-map rmap_1
#  - redistribute direct route-map ospf102-direct-connect
#  - area 0.0.0.100 filter-list route-map rmap_1 in
#  - area 0.0.0.100 filter-list route-map rmap_2 out
#  - area 0.0.0.100 range 2001:db2::/32 not-advertise
#  - area 0.0.0.100 range 2001:db3::/32 cost 120
#  - vrf zone1
#  - router-id 198.51.100.129
#  - area 0.0.0.102 nssa no-summary default-information-originate
#  - area 0.0.0.103 nssa no-summary
#  - area 0.0.0.103 nssa translate type7 always
#  - vrf zone2
#  - auto-cost reference-bandwidth 45 Gbps
#  - router ospf 100
#  - router-id 203.0.113.20
#
# after:
#    processes:
#    - process_id: "100"
#      router_id: 203.0.113.20
#    - address_family:
#        afi: ipv4
#        safi: unicast
#        areas:
#        - area_id: 0.0.0.100
#          filter_list:
#          - direction: out
#            route_map: rmap_2
#          - direction: in
#            route_map: rmap_1
#          ranges:
#          - not_advertise: true
#            prefix: 2001:db2::/32
#          - cost: 120
#            prefix: 2001:db3::/32
#        redistribute:
#        - protocol: direct
#          route_map: ospf102-direct-connect
#        - id: "120"
#          protocol: eigrp
#          route_map: rmap_1
#      process_id: "102"
#      router_id: 198.51.100.1
#      vrfs:
#      - areas:
#        - area_id: 0.0.0.102
#          nssa:
#            default_information_originate: true
#            no_summary: true
#        - area_id: 0.0.0.103
#          nssa:
#            no_summary: true
#            translate:
#              type7:
#                always: true
#        router_id: 198.51.100.129
#        vrf: zone1
#      - auto_cost:
#          reference_bandwidth: 45
#          unit: Gbps
#        vrf: zone2
#

# After state:
# ------------
# nxos-9k-rdo# sh running-config | section "^router ospfv3"
# router ospfv3 100
#   router-id 203.0.113.20
# router ospfv3 102
#   router-id 198.51.100.1
#   address-family ipv6 unicast
#     redistribute direct route-map ospf102-direct-connect
#     redistribute eigrp 120 route-map rmap_1
#     area 0.0.0.100 filter-list route-map rmap_2 out
#     area 0.0.0.100 filter-list route-map rmap_1 in
#     area 0.0.0.100 range 2001:db2::/32 not-advertise
#     area 0.0.0.100 range 2001:db3::/32 cost 120
#   vrf zone1
#     router-id 198.51.100.129
#     area 0.0.0.102 nssa no-summary default-information-originate
#     area 0.0.0.103 nssa no-summary
#     area 0.0.0.103 nssa translate type7 always
#   vrf zone2
#     auto-cost reference-bandwidth 45 Gbps

# Using replaced

# Before state:
# -------------
# nxos-9k-rdo# sh running-config | section "^router ospfv3"
# router ospfv3 100
#   router-id 203.0.113.20
# router ospfv3 102
#   router-id 198.51.100.1
#   address-family upv6 unicast
#     redistribute direct route-map ospf102-direct-connect
#     redistribute eigrp 120 route-map rmap_1
#     area 0.0.0.100 filter-list route-map rmap_2 out
#     area 0.0.0.100 filter-list route-map rmap_1 in
#     area 0.0.0.100 range 2001:db2::/32 not-advertise
#     area 0.0.0.100 range 2001:db3::/32 cost 120
#   vrf zone1
#     router-id 198.51.100.129
#     area 0.0.0.102 nssa no-summary default-information-originate
#     area 0.0.0.103 nssa no-summary
#     area 0.0.0.103 nssa translate type7 always
#   vrf zone2
#     auto-cost reference-bandwidth 45 Gbps

- name: Replace device configurations of listed OSPFv3 processes with provided configurations
  cisco.nxos.nxos_ospfv3:
    config:
      processes:
        - process_id: 102
          router_id: 198.51.100.1
          address_family:
            afi: ipv6
            safi: unicast
            areas:
              - area_id: 0.0.0.100
                filter_list:
                  - route_map: rmap_8
                    direction: in
                ranges:
                  - not_advertise: true
                    prefix: 2001:db2::/32
            redistribute:
              - protocol: eigrp
                id: 130
                route_map: rmap_1
              - protocol: direct
                route_map: ospf102-direct-connect
          vrfs:
            - vrf: zone1
              router_id: 198.51.100.129
              areas:
                - area_id: 0.0.0.102
                  nssa:
                    default_information_originate: true
                    no_summary: true
    state: replaced

# Task output:
# ------------
# before:
#    processes:
#    - process_id: "100"
#      router_id: 203.0.113.20
#    - address_family:
#        afi: ipv4
#        safi: unicast
#        areas:
#        - area_id: 0.0.0.100
#          filter_list:
#          - direction: out
#            route_map: rmap_2
#          - direction: in
#            route_map: rmap_1
#          ranges:
#          - not_advertise: true
#            prefix: 2001:db2::/32
#          - cost: 120
#            prefix: 2001:db3::/32
#        redistribute:
#        - protocol: direct
#          route_map: ospf102-direct-connect
#        - id: "120"
#          protocol: eigrp
#          route_map: rmap_1
#      process_id: "102"
#      router_id: 198.51.100.1
#      vrfs:
#      - areas:
#        - area_id: 0.0.0.102
#          nssa:
#            default_information_originate: true
#            no_summary: true
#        - area_id: 0.0.0.103
#          nssa:
#            no_summary: true
#            translate:
#              type7:
#                always: true
#        router_id: 198.51.100.129
#        vrf: zone1
#      - auto_cost:
#          reference_bandwidth: 45
#          unit: Gbps
#        vrf: zone2
#
#  commands:
#  - router ospf 102
#  - address-family ipv6 unicast
#  - redistribute eigrp 130 route-map rmap_1
#  - no redistribute eigrp 120 route-map rmap_1
#  - area 0.0.0.100 filter-list route-map rmap_8 in
#  - no area 0.0.0.100 filter-list route-map rmap_2 out
#  - no area 0.0.0.100 range 2001:db3::/32
#  - vrf zone1
#  - no area 0.0.0.103 nssa
#  - no area 0.0.0.103 nssa translate type7 always
#  - no vrf zone2
#
# after:
#    processes:
#    - process_id: "100"
#      router_id: 203.0.113.20
#    - address_family:
#        afi: ipv6
#        safi: unicast
#        areas:
#        - area_id: 0.0.0.100
#          filter_list:
#          - direction: in
#            route_map: rmap_8
#          ranges:
#          - not_advertise: true
#            prefix: 2001:db2::/32
#        redistribute:
#        - protocol: direct
#          route_map: ospf102-direct-connect
#        - id: "130"
#          protocol: eigrp
#          route_map: rmap_1
#      process_id: "102"
#      router_id: 198.51.100.1
#      vrfs:
#      - areas:
#        - area_id: 0.0.0.102
#          nssa:
#            default_information_originate: true
#            no_summary: true
#        router_id: 198.51.100.129
#        vrf: zone1

# After state:
# ------------
# nxos-9k-rdo# sh running-config | section "^router ospfv3"
# router ospfv3 100
#   router-id 203.0.113.20
# router ospfv3 102
#   router-id 198.51.100.1
#   address-family ipv6 unicast
#     redistribute direct route-map ospf102-direct-connect
#     redistribute eigrp 130 route-map rmap_1
#     area 0.0.0.100 filter-list route-map rmap_8 in
#     area 0.0.0.100 range 198.51.100.64/27 not-advertise
#   vrf zone1
#     router-id 198.51.100.129
#     area 0.0.0.102 nssa no-summary default-information-originate

# Using overridden

# Before state:
# -------------
# nxos-9k-rdo# sh running-config | section "^router ospfv3"
# router ospfv3 100
#   router-id 203.0.113.20
# router ospfv3 102
#   router-id 198.51.100.1
#   address-family ipv6 unicast
#     redistribute direct route-map ospf102-direct-connect
#     redistribute eigrp 120 route-map rmap_1
#     area 0.0.0.100 filter-list route-map rmap_2 out
#     area 0.0.0.100 filter-list route-map rmap_1 in
#     area 0.0.0.100 range 2001:db2::/32 not-advertise
#     area 0.0.0.100 range 2001:db3::/32 cost 120
#   vrf zone1
#     router-id 198.51.100.129
#     area 0.0.0.102 nssa no-summary default-information-originate
#     area 0.0.0.103 nssa no-summary
#     area 0.0.0.103 nssa translate type7 always
#   vrf zone2
#     auto-cost reference-bandwidth 45 Gbps

- name: Override all OSPFv3 configuration with provided configuration
  cisco.nxos.nxos_ospfv3:
    config:
      processes:
        - process_id: 104
          router_id: 203.0.113.20
        - process_id: 102
          router_id: 198.51.100.1
          shutdown: true
    state: overridden

# Task output:
# ------------
# before:
#    processes:
#    - process_id: "100"
#      router_id: 203.0.113.20
#    - address_family:
#        afi: ipv4
#        safi: unicast
#        areas:
#        - area_id: 0.0.0.100
#          filter_list:
#          - direction: out
#            route_map: rmap_2
#          - direction: in
#            route_map: rmap_1
#          ranges:
#          - not_advertise: true
#            prefix: 2001:db2::/32
#          - cost: 120
#            prefix: 2001:db3::/32
#        redistribute:
#        - protocol: direct
#          route_map: ospf102-direct-connect
#        - id: "120"
#          protocol: eigrp
#          route_map: rmap_1
#      process_id: "102"
#      router_id: 198.51.100.1
#      vrfs:
#      - areas:
#        - area_id: 0.0.0.102
#          nssa:
#            default_information_originate: true
#            no_summary: true
#        - area_id: 0.0.0.103
#          nssa:
#            no_summary: true
#            translate:
#              type7:
#                always: true
#        router_id: 198.51.100.129
#        vrf: zone1
#      - auto_cost:
#          reference_bandwidth: 45
#          unit: Gbps
#        vrf: zone2
#
# commands:
#  - no router ospfv3 100
#  - router ospfv3 104
#  - router-id 203.0.113.20
#  - router ospfv3 102
#  - shutdown
#  - address-family ipv6 unicast
#  - no redistribute direct route-map ospf102-direct-connect
#  - no redistribute eigrp 120 route-map rmap_1
#  - no area 0.0.0.100 filter-list route-map rmap_2 out
#  - no area 0.0.0.100 filter-list route-map rmap_1 in
#  - no area 0.0.0.100 range 2001:db2::/32
#  - no area 0.0.0.100 range 2001:db3::/32
#  - no vrf zone1
#  - no vrf zone2
#
# after:
#    processes:
#    - process_id: "102"
#      router_id: 198.51.100.1
#      shutdown: true
#      address_family:
#        afi: ipv6
#        safi: unicast
#    - process_id: "104"
#      router_id: 203.0.113.20

# After state:
# ------------
# nxos-9k-rdo# sh running-config | section "^router ospfv3"
# router ospfv3 102
#   router-id 198.51.100.1
#   address-family ipv6 unicast
#   shutdown
# router ospfv3 104
#   router-id 203.0.113.20

# Using deleted to delete a single OSPF process

# Before state:
# -------------
# nxos-9k-rdo# sh running-config | section "^router ospf .*"
# router ospfv3 100
#   router-id 203.0.113.20
# router ospfv3 102
#   router-id 198.51.100.1
#   address-family ipv6 unicast
#     redistribute direct route-map ospf102-direct-connect
#     redistribute eigrp 120 route-map rmap_1
#     area 0.0.0.100 filter-list route-map rmap_2 out
#     area 0.0.0.100 filter-list route-map rmap_1 in
#     area 0.0.0.100 range 2001:db2::/32 not-advertise
#     area 0.0.0.100 range 2001:db3::/32 cost 120
#   vrf zone1
#     router-id 198.51.100.129
#     area 0.0.0.102 nssa no-summary default-information-originate
#     area 0.0.0.103 nssa no-summary
#     area 0.0.0.103 nssa translate type7 always
#   vrf zone2
#     auto-cost reference-bandwidth 45 Gbps

- name: Delete a single OSPFv3 process
  cisco.nxos.nxos_ospfv3:
    config:
      processes:
        - process_id: 102
    state: deleted

# Task output:
# ------------
# before:
#    processes:
#    - process_id: "100"
#      router_id: 203.0.113.20
#    - address_family:
#        afi: ipv4
#        safi: unicast
#        areas:
#        - area_id: 0.0.0.100
#          filter_list:
#          - direction: out
#            route_map: rmap_2
#          - direction: in
#            route_map: rmap_1
#          ranges:
#          - not_advertise: true
#            prefix: 2001:db2::/32
#          - cost: 120
#            prefix: 2001:db3::/32
#        redistribute:
#        - protocol: direct
#          route_map: ospf102-direct-connect
#        - id: "120"
#          protocol: eigrp
#          route_map: rmap_1
#      process_id: "102"
#      router_id: 198.51.100.1
#      vrfs:
#      - areas:
#        - area_id: 0.0.0.102
#          nssa:
#            default_information_originate: true
#            no_summary: true
#        - area_id: 0.0.0.103
#          nssa:
#            no_summary: true
#            translate:
#              type7:
#                always: true
#        router_id: 198.51.100.129
#        vrf: zone1
#      - auto_cost:
#          reference_bandwidth: 45
#          unit: Gbps
#        vrf: zone2
#
# commands:
#   - no router ospfv3 102
#
# after:
#   processes:
#   - process_id: "100"
#     router_id: 203.0.113.20

# After state:
# ------------
# nxos-9k-rdo# sh running-config | section "^router ospfv3"
# router ospfv3 100
#   router-id 203.0.113.20

# Using deleted all OSPFv3 processes from the device

# Before state:
# -------------
# nxos-9k-rdo# sh running-config | section "^router ospfv3"
# router ospfv3 100
#   router-id 203.0.113.20
# router ospfv3 102
#   router-id 198.51.100.1
#   address-family ipv6 unicast
#     redistribute direct route-map ospf102-direct-connect
#     redistribute eigrp 120 route-map rmap_1
#     area 0.0.0.100 filter-list route-map rmap_2 out
#     area 0.0.0.100 filter-list route-map rmap_1 in
#     area 0.0.0.100 range 2001:db2::/32 not-advertise
#     area 0.0.0.100 range 2001:db3::/32 cost 120
#   vrf zone1
#     router-id 198.51.100.129
#     area 0.0.0.102 nssa no-summary default-information-originate
#     area 0.0.0.103 nssa no-summary
#     area 0.0.0.103 nssa translate type7 always
#   vrf zone2
#     auto-cost reference-bandwidth 45 Gbps

- name: Delete all OSPFv3 processes from the device
  cisco.nxos.nxos_ospfv3:
    state: deleted

# Task output:
# ------------
# before:
#    processes:
#    - process_id: "100"
#      router_id: 203.0.113.20
#    - address_family:
#        afi: ipv4
#        safi: unicast
#        areas:
#        - area_id: 0.0.0.100
#          filter_list:
#          - direction: out
#            route_map: rmap_2
#          - direction: in
#            route_map: rmap_1
#          ranges:
#          - not_advertise: true
#            prefix: 2001:db2::/32
#          - cost: 120
#            prefix: 2001:db3::/32
#        redistribute:
#        - protocol: direct
#          route_map: ospf102-direct-connect
#        - id: "120"
#          protocol: eigrp
#          route_map: rmap_1
#      process_id: "102"
#      router_id: 198.51.100.1
#      vrfs:
#      - areas:
#        - area_id: 0.0.0.102
#          nssa:
#            default_information_originate: true
#            no_summary: true
#        - area_id: 0.0.0.103
#          nssa:
#            no_summary: true
#            translate:
#              type7:
#                always: true
#        router_id: 198.51.100.129
#        vrf: zone1
#      - auto_cost:
#          reference_bandwidth: 45
#          unit: Gbps
#        vrf: zone2
#
# commands:
#  - no router ospfv3 100
#  - no router ospfv3 102
#
#  after: {}

# After state:
# ------------
# nxos-9k-rdo# sh running-config | section "^router ospfv3"
# nxos-9k-rdo#

# Using rendered

- name: Render platform specific configuration lines with state rendered (without connecting to the device)
  cisco.nxos.nxos_ospfv3:
    config:
      processes:
        - process_id: 100
          router_id: 203.0.113.20
        - process_id: 102
          router_id: 198.51.100.1
          address_family:
            afi: ipv6
            safi: unicast
            areas:
              - area_id: 0.0.0.100
                filter_list:
                  - route_map: rmap_1
                    direction: in
                  - route_map: rmap_2
                    direction: out
                ranges:
                  - prefix: 2001:db2::/32
                    not_advertise: true
                  - prefix: 2001:db3::/32
                    cost: 120
            redistribute:
              - protocol: eigrp
                id: 120
                route_map: rmap_1
              - protocol: direct
                route_map: ospf102-direct-connect
          vrfs:
            - vrf: zone1
              router_id: 198.51.100.129
              areas:
                - area_id: 0.0.0.102
                  nssa:
                    default_information_originate: true
                    no_summary: true
                - area_id: 0.0.0.103
                  nssa:
                    no_summary: true
                    translate:
                      type7:
                        always: true
            - vrf: zone2
              auto_cost:
                reference_bandwidth: 45
                unit: Gbps
    state: rendered

# Task output:
# ------------
# rendered:
#  - router ospfv3 100
#  - router-id 203.0.113.20
#  - router ospfv3 102
#  - router-id 198.51.100.1
#  - address-family ipv6 unicast
#  - redistribute eigrp 120 route-map rmap_1
#  - redistribute direct route-map ospf102-direct-connect
#  - area 0.0.0.100 filter-list route-map rmap_1 in
#  - area 0.0.0.100 filter-list route-map rmap_2 out
#  - area 0.0.0.100 range 2001:db2::/32 not-advertise
#  - area 0.0.0.100 range 2001:db3::/32 cost 120
#  - vrf zone1
#  - router-id 198.51.100.129
#  - area 0.0.0.102 nssa no-summary default-information-originate
#  - area 0.0.0.103 nssa no-summary
#  - area 0.0.0.103 nssa translate type7 always
#  - vrf zone2
#  - auto-cost reference-bandwidth 45 Gbps

# Using parsed

# parsed.cfg
# ------------
# router ospfv3 100
#   router-id 192.0.100.1
#   address-family ipv6 unicast
#     redistribute direct route-map ospf-direct-connect
#     redistribute eigrp 120 route-map rmap_1
#     area 0.0.0.100 filter-list route-map rmap_2 out
#     area 0.0.0.100 filter-list route-map rmap_1 in
#     area 0.0.0.100 range 2001:db2::/32 not-advertise
#     area 0.0.0.100 range 2001:db3::/32 cost 120
#   vrf zone1
#     router-id 198.51.100.129
#     area 0.0.100.1 nssa no-summary no-redistribution
# router ospfv3 102
#   router-id 198.54.100.1
#   shutdown

- name: Parse externally provided OSPFv3 config
  cisco.nxos.nxos_ospfv3:
    running_config: "{{ lookup('file', 'ospfv2.cfg') }}"
    state: parsed

# Task output:
# ------------
# parsed:
#   processes:
#   - process_id: "100"
#     address_family:
#       afi: ipv6
#       safi: unicast
#       areas:
#       - area_id: 0.0.0.101
#         nssa:
#           no_redistribution: true
#           no_summary: true
#       - area_id: 0.0.0.102
#         stub:
#           no_summary: true
#         filter_list:
#           - direction: out
#             route_map: rmap_2
#           - direction: in
#             route_map: rmap_1
#         ranges:
#           - not_advertise: true
#             prefix: 192.0.2.0/24
#           - cost: 120
#             prefix: 192.0.3.0/24
#       redistribute:
#       - protocol: direct
#         route_map: ospf-direct-connect
#       - id: "120"
#         protocol: eigrp
#         route_map: rmap_1
#     router_id: 192.0.100.1
#     vrfs:
#       - vrf: zone1
#         areas:
#           - area_id: 0.0.100.1
#             nssa:
#               no_redistribution: true
#               no_summary: true
#         router_id: 192.0.100.2
#   - process_id: "102"
#     router_id: 198.54.100.1
#     shutdown: true

# Using gathered

- name: Gather OSPFv3 facts using gathered
  cisco.nxos.nxos_ospfv3:
    state: gathered

# Task output:
# ------------
#  gathered:
#    processes:
#    - process_id: "100"
#      router_id: 203.0.113.20
#    - address_family:
#        afi: ipv4
#        safi: unicast
#        areas:
#        - area_id: 0.0.0.100
#          filter_list:
#          - direction: out
#            route_map: rmap_2
#          - direction: in
#            route_map: rmap_1
#          ranges:
#          - not_advertise: true
#            prefix: 2001:db2::/32
#          - cost: 120
#            prefix: 2001:db3::/32
#        redistribute:
#        - protocol: direct
#          route_map: ospf102-direct-connect
#        - id: "120"
#          protocol: eigrp
#          route_map: rmap_1
#      process_id: "102"
#      router_id: 198.51.100.1
#      vrfs:
#      - areas:
#        - area_id: 0.0.0.102
#          nssa:
#            default_information_originate: true
#            no_summary: true
#        - area_id: 0.0.0.103
#          nssa:
#            no_summary: true
#            translate:
#              type7:
#                always: true
#        router_id: 198.51.100.129
#        vrf: zone1
#      - auto_cost:
#          reference_bandwidth: 45
#          unit: Gbps
#        vrf: zone2
#

Возвращаемые значения

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

Ключ	Описание
after dictionary	Результирующая конфигурация после применения модели. Возвращается: при наличии изменений Пример: `"The configuration returned will always be in the same format\n of the parameters above.\n"`
before dictionary	Конфигурация до применения модели. Возвращается: всегда Пример: `"The configuration returned will always be in the same format\n of the parameters above.\n"`
commands list / elements=string	Список команд, отправленных на удалённое устройство. Возвращается: всегда Пример: ["router ospfv3 102", "router-id 198.54.100.1", "router ospfv3 100", "router-id 192.0.100.1", "address-family ipv6 unicast", "redistribute eigrp 120 route-map rmap_1", "redistribute direct route-map ospf-direct-connect", "area 0.0.0.100 filter-list route-map rmap_1 in", "area 0.0.0.100 filter-list route-map rmap_2 out", "area 0.0.0.100 range 2001:db2::/32 not-advertise", "area 0.0.0.100 range 2001:db3::/32 cost 120", "vrf zone1", "router-id 192.0.100.2", "vrf zone2", "auto-cost reference-bandwidth 45 Gbps"]
gathered dictionary	Факты о сетевом ресурсе, собранные с удалённого устройства в виде структурированных данных. Возвращается: если state равно `gathered` Пример: `"This output will always be in the same format as the module argspec.\n"`
parsed dictionary	Собственная конфигурация устройства, переданная в параметре running_config и разобранная в структурированные данные в соответствии со спецификацией аргументов модуля. Возвращается: если state равно `parsed` Пример: `"This output will always be in the same format as the module argspec.\n"`
rendered list / elements=string	Конфигурация из задачи, представленная в собственном формате устройства (автономный режим). Возвращается: если state равно `rendered` Пример: `["router ospfv3 102", "router-id 198.54.100.1", "router ospfv3 100"]`

Авторы

Nilashish Chakraborty (@NilashishC)

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

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