Spec-Zone.ru › Ansible

Модуль cisco.ios.ios_vrf_address_family — модуль ресурсов для настройки определений VRF.

Примечание

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

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

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

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

Добавлено в cisco.ios 7.0.0

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

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

  • Этот модуль обеспечивает декларативное управление определениями VRF на Cisco IOS.

Примечание

У этого модуля есть соответствующий модуль действий.

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

Параметры

Параметр

Комментарии

config

list / elements=dictionary

Список конфигураций устройства для VRF.

address_families

list / elements=dictionary

Включить семейство адресов и перейти в режим его настройки — конфигурация AFI/SAFI

afi

string

Идентификатор семейства адресов (AFI)

Варианты:

  • "ipv4"
  • "ipv6"

bgp

dictionary

Команды, относящиеся к конфигурации BGP.

next_hop

dictionary

Следующий узел для маршрутов VRF в магистральной сети.

loopback

integer

Интерфейс loopback для следующего узла

export

dictionary

Экспорт VRF

ipv4

dictionary

Экспорт VRF на основе семейства адресов

multicast

dictionary

Экспортировать префиксы в таблицу многоадресной рассылки IPv4

map

string

Имя карты маршрутизации

prefix

integer

Верхний предел количества экспортируемых префиксов, позволяющий избежать чрезмерного расхода памяти

unicast

dictionary

Экспортировать префиксы в таблицу одноадресной рассылки IPv4

allow_evpn

boolean

Разрешить маршрутам EVPN попадать в глобальную таблицу

Варианты:

  • false
  • true

map

string

Имя карты маршрутизации

prefix

integer

Верхний предел количества экспортируемых префиксов, позволяющий избежать чрезмерного расхода памяти

map

string

Имя карты маршрутизации

import_config

dictionary

Импорт VRF

ipv4

dictionary

Импорт VRF на основе семейства адресов

multicast

dictionary

Импортировать префиксы из таблицы многоадресной рассылки IPv4

map

string

Имя карты маршрутизации

prefix

integer

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

unicast

dictionary

Импортировать префиксы из таблицы одноадресной рассылки IPv4

allow_evpn

boolean

Разрешить передачу маршрутов Global->VRF в EVPN

Варианты:

  • false
  • true

limit

integer

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

map

string

Импорт VRF на основе карты маршрутизации

map

string

Имя карты маршрутизации

inter_as_hybrid

dictionary

Гибридный режим между автономными системами

csc

dictionary

Оператор, поддерживающий операторов (Carrier Supporting Carrier)

next_hop

string

Следующий узел для маршрутов VRF в магистральной сети.

next_hop

string

Следующий узел для маршрутов VRF в магистральной сети.

mdt

dictionary

Магистральное дерево распределения многоадресной рассылки

auto_discovery

dictionary

Автоматическое обнаружение BGP для MVPN

ingress_replication

dictionary

Автоматическое обнаружение BGP для репликации на входе

inter_as

dictionary

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

mdt_hello_enable

boolean

Включить сообщения PIM Hello через интерфейс MDT

Варианты:

  • false
  • true

mdt_hello_enable

boolean

Включить сообщения PIM Hello через интерфейс MDT

Варианты:

  • false
  • true

mldp

boolean

Использовать MLDP для автоматического обнаружения MDT.

Варианты:

  • false
  • true

pim

dictionary

Автоматическое обнаружение BGP для PIM

inter_as

dictionary

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

mdt_hello_enable

boolean

Включить сообщения PIM Hello через интерфейс MDT

Варианты:

  • false
  • true

pim_tlv_announce

dictionary

Объявлять PIM TLV для MDT данных

mdt_hello_enable

boolean

Включить сообщения PIM Hello через интерфейс MDT

Варианты:

  • false
  • true

mdt_hello_enable

boolean

Включить сообщения PIM Hello через интерфейс MDT

Варианты:

  • false
  • true

pim_tlv_announce

dictionary

Объявлять PIM TLV для MDT данных

mdt_hello_enable

boolean

Включить сообщения PIM Hello через интерфейс MDT

Варианты:

  • false
  • true

receiver_site

boolean

Узел-получатель BGP только для MVPN

Варианты:

  • false
  • true

data

dictionary

Деревья данных MDT

ingress_replication

dictionary

Использовать репликацию на входе для создания MDT данных

immediate_switch

boolean

Немедленно переключиться на дерево MDT данных

Варианты:

  • false
  • true

list

dictionary

Список контроля доступа

access_list_name

string

Именованный расширенный список контроля доступа IP

access_list_number

integer

Номер списка контроля доступа

number

integer

Количество MDT данных

list

dictionary

Список контроля доступа

access_list_name

string

Именованный расширенный список контроля доступа IP

access_list_number

integer

Номер списка контроля доступа

mpls

dictionary

Настроить MPLS для MDT данных

mldp

integer

Использовать MLDP для MDT данных MPLS

threshold

integer

Порог переключения MDT

default

dictionary

Конфигурация MDT по умолчанию

ingress_replication

boolean

Использовать репликацию на входе для MDT по умолчанию

Варианты:

  • false
  • true

direct

boolean

Прямые MDT

Варианты:

  • false
  • true

log_reuse

boolean

Журналирование событий повторного использования MDT данных

Варианты:

  • false
  • true

mode

dictionary

Тип инкапсуляции

gre

boolean

Инкапсуляция GRE

Варианты:

  • false
  • true

mtu

integer

MTU

overlay

dictionary

Протокол наложенной сети MDT

bgp

dictionary

Сигнализация наложенной сети BGP

shared_tree_prune_delay

integer

Задержка перед обрезкой общего дерева на C-RP PE

source_tree_prune_delay

integer

Задержка перед обрезкой дерева источника на C-S PE

use_bgp

dictionary

Использовать BGP для сигнализации наложенной сети MDT

set

boolean

Включить использование BGP для наложенной сети MDT.

Варианты:

  • false
  • true

spt_only

boolean

Включить режим ASM только с SPT

Варианты:

  • false
  • true

partitioned

dictionary

Разделенное дерево распределения многоадресной рассылки

ingress_replication

boolean

Использовать репликацию на входе для разделенного MDT

Варианты:

  • false
  • true

mldp

dictionary

Использовать MLDP для разделенного MDT.

p2mp

boolean

Включить P2MP для разделенного MDT на основе MLDP.

Варианты:

  • false
  • true

strict_rpf

dictionary

Включить строгую проверку RPF

interface

boolean

Строгая проверка RPF на основе интерфейса

Варианты:

  • false
  • true

protection

dictionary

Настроить локальное восстановление

local_prefixes

boolean

Включить защиту локальных префиксов

Варианты:

  • false
  • true

route_replicate

dictionary

Реплицировать (импортировать) маршруты из другой топологии (и другой VRF)

from_config

dictionary

Реплицировать маршруты из другой VRF

multicast

dictionary

SAFI многоадресной рассылки

all

dictionary

Все маршруты

route_map

string

Ссылка на route-map

bgp

dictionary

Протокол граничного шлюза (BGP)

as_number

integer

Номер автономной системы

route_map

string

Ссылка на route-map

eigrp

dictionary

Протокол усовершенствованной маршрутизации внутреннего шлюза (EIGRP)

as_number

integer

Номер автономной системы

route_map

string

Ссылка на route-map

isis

dictionary

Протокол IS-IS (Intermediate System-to-Intermediate System)

iso_tag

string

Метка области маршрутизации ISO

route_map

string

Ссылка на route-map

mobile

dictionary

Маршруты мобильных узлов

route_map

string

Ссылка на route-map

odr

dictionary

Маршруты-заглушки по запросу

route_map

string

Ссылка на route-map

ospf

dictionary

Протокол OSPF (Open Shortest Path First)

process_id

integer

Идентификатор процесса OSPF

route_map

string

Ссылка на route-map

rip

dictionary

Протокол маршрутной информации (RIP)

route_map

string

Ссылка на route-map

static

dictionary

Статические маршруты

route_map

string

Ссылка на route-map

topology

dictionary

Имя топологии

base

dictionary

Базовая топология

all

dictionary

Все маршруты

route_map

string

Ссылка на route-map

bgp

dictionary

Протокол граничного шлюза (BGP)

as_number

integer

Номер автономной системы

route_map

string

Ссылка на route-map

eigrp

dictionary

Протокол усовершенствованной маршрутизации внутреннего шлюза (EIGRP)

as_number

integer

Номер автономной системы

route_map

string

Ссылка на route-map

isis

dictionary

Протокол IS-IS (Intermediate System-to-Intermediate System)

iso_tag

string

Метка области маршрутизации ISO

route_map

string

Ссылка на route-map

mobile

dictionary

Маршруты мобильных узлов

route_map

string

Ссылка на route-map

odr

dictionary

Маршруты-заглушки по запросу

route_map

string

Ссылка на route-map

ospf

dictionary

Протокол OSPF (Open Shortest Path First)

process_id

integer

Идентификатор процесса OSPF

route_map

string

Ссылка на route-map

rip

dictionary

Протокол маршрутной информации (RIP)

route_map

string

Ссылка на route-map

static

dictionary

Статические маршруты

route_map

string

Ссылка на route-map

unicast

dictionary

SAFI одноадресной передачи

all

dictionary

Все маршруты

route_map

string

Ссылка на route-map

bgp

dictionary

Протокол граничного шлюза (BGP)

as_number

integer

Номер автономной системы

route_map

string

Ссылка на route-map

connected

dictionary

Подключённые маршруты

route_map

string

Ссылка на route-map

eigrp

dictionary

Усовершенствованный протокол маршрутизации внутреннего шлюза (EIGRP)

as_number

integer

Номер автономной системы

route_map

string

Ссылка на route-map

isis

dictionary

Промежуточная система — промежуточная система (ISIS)

iso_tag

string

Тег области маршрутизации ISO

route_map

string

Ссылка на route-map

mobile

dictionary

Мобильные маршруты

route_map

string

Ссылка на route-map

odr

dictionary

Маршруты заглушек по запросу

route_map

string

Ссылка на route-map

ospf

dictionary

Протокол кратчайшего пути первым (OSPF)

process_id

integer

Идентификатор процесса OSPF

route_map

string

Ссылка на route-map

rip

dictionary

Протокол маршрутной информации (RIP)

route_map

string

Ссылка на route-map

static

dictionary

Статические маршруты

route_map

string

Ссылка на route-map

vrf

dictionary

Укажите исходную VRF

global

dictionary

Глобальная VRF

multicast

dictionary

SAFI многоадресной рассылки

all

dictionary

Все маршруты

route_map

string

Ссылка на route-map

bgp

dictionary

Протокол граничного шлюза (BGP)

as_number

integer

Номер автономной системы

route_map

string

Ссылка на route-map

eigrp

dictionary

Усовершенствованный протокол маршрутизации внутреннего шлюза (EIGRP)

as_number

integer

Номер автономной системы

route_map

string

Ссылка на route-map

isis

dictionary

Промежуточная система — промежуточная система (ISIS)

iso_tag

string

Тег области маршрутизации ISO

route_map

string

Ссылка на route-map

mobile

dictionary

Мобильные маршруты

route_map

string

Ссылка на route-map

odr

dictionary

Маршруты заглушек по запросу

route_map

string

Ссылка на route-map

ospf

dictionary

Протокол кратчайшего пути первым (OSPF)

process_id

integer

Идентификатор процесса OSPF

route_map

string

Ссылка на route-map

rip

dictionary

Протокол маршрутной информации (RIP)

route_map

string

Ссылка на route-map

static

dictionary

Статические маршруты

route_map

string

Ссылка на route-map

topology

dictionary

Имя топологии

base

dictionary

Базовая топология

all

dictionary

Все маршруты

route_map

string

Ссылка на route-map

bgp

dictionary

Протокол граничного шлюза (BGP)

as_number

integer

Номер автономной системы

route_map

string

Ссылка на route-map

eigrp

dictionary

Усовершенствованный протокол маршрутизации внутреннего шлюза (EIGRP)

as_number

integer

Номер автономной системы

route_map

string

Ссылка на route-map

isis

dictionary

Промежуточная система — промежуточная система (ISIS)

iso_tag

string

Тег области маршрутизации ISO

route_map

string

Ссылка на route-map

mobile

dictionary

Мобильные маршруты

route_map

string

Ссылка на route-map

odr

dictionary

Маршруты заглушек по запросу

route_map

string

Ссылка на route-map

ospf

dictionary

Протокол кратчайшего пути первым (OSPF)

process_id

integer

Идентификатор процесса OSPF

route_map

string

Ссылка на route-map

rip

dictionary

Протокол маршрутной информации (RIP)

route_map

string

Ссылка на route-map

static

dictionary

Статические маршруты

route_map

string

Ссылка на route-map

unicast

dictionary

SAFI одноадресной передачи

all

dictionary

Все маршруты

route_map

string

Ссылка на route-map

bgp

dictionary

Протокол граничного шлюза (BGP)

as_number

integer

Номер автономной системы

route_map

string

Ссылка на route-map

connected

dictionary

Подключенные маршруты

route_map

string

Ссылка на route-map

eigrp

dictionary

Усовершенствованный протокол маршрутизации внутреннего шлюза (EIGRP)

as_number

integer

Номер автономной системы

route_map

string

Ссылка на route-map

isis

dictionary

Протокол Intermediate System-to-Intermediate System (ISIS)

iso_tag

string

Метка области маршрутизации ISO

route_map

string

Ссылка на route-map

mobile

dictionary

Мобильные маршруты

route_map

string

Ссылка на route-map

odr

dictionary

Маршруты заглушки по запросу

route_map

string

Ссылка на route-map

ospf

dictionary

Протокол приоритета кратчайшего пути (OSPF)

process_id

integer

Идентификатор процесса OSPF

route_map

string

Ссылка на route-map

rip

dictionary

Протокол маршрутной информации (RIP)

route_map

string

Ссылка на route-map

static

dictionary

Статические маршруты

route_map

string

Ссылка на route-map

multicast

dictionary

SAFI многоадресной передачи

all

dictionary

Все маршруты

route_map

string

Ссылка на route-map

bgp

dictionary

Протокол граничного шлюза (BGP)

as_number

integer

Номер автономной системы

route_map

string

Ссылка на route-map

eigrp

dictionary

Усовершенствованный протокол маршрутизации внутреннего шлюза (EIGRP)

as_number

integer

Номер автономной системы

route_map

string

Ссылка на route-map

isis

dictionary

Протокол Intermediate System-to-Intermediate System (ISIS)

iso_tag

string

Метка области маршрутизации ISO

route_map

string

Ссылка на route-map

mobile

dictionary

Мобильные маршруты

route_map

string

Ссылка на route-map

odr

dictionary

Маршруты заглушки по запросу

route_map

string

Ссылка на route-map

ospf

dictionary

Протокол приоритета кратчайшего пути (OSPF)

process_id

integer

Идентификатор процесса OSPF

route_map

string

Ссылка на route-map

rip

dictionary

Протокол маршрутной информации (RIP)

route_map

string

Ссылка на route-map

static

dictionary

Статические маршруты

route_map

string

Ссылка на route-map

topology

dictionary

Имя топологии

base

dictionary

Базовая топология

all

dictionary

Все маршруты

route_map

string

Ссылка на route-map

bgp

dictionary

Протокол граничного шлюза (BGP)

as_number

integer

Номер автономной системы

route_map

string

Ссылка на route-map

eigrp

dictionary

Усовершенствованный протокол маршрутизации внутреннего шлюза (EIGRP)

as_number

integer

Номер автономной системы

route_map

string

Ссылка на route-map

isis

dictionary

Протокол Intermediate System-to-Intermediate System (ISIS)

iso_tag

string

Метка области маршрутизации ISO

route_map

string

Ссылка на route-map

mobile

dictionary

Мобильные маршруты

route_map

string

Ссылка на route-map

odr

dictionary

Маршруты заглушки по запросу

route_map

string

Ссылка на route-map

ospf

dictionary

Протокол приоритета кратчайшего пути (OSPF)

process_id

integer

Идентификатор процесса OSPF

route_map

string

Ссылка на route-map

rip

dictionary

Протокол маршрутной информации (RIP)

route_map

string

Ссылка на route-map

static

dictionary

Статические маршруты

route_map

string

Ссылка на route-map

name

string

Имя исходной VRF

unicast

dictionary

SAFI для одноадресной передачи

all

dictionary

Все маршруты

route_map

string

Ссылка на route-map

bgp

dictionary

Протокол граничного шлюза (BGP)

as_number

integer

Номер автономной системы

route_map

string

Ссылка на route-map

connected

dictionary

Маршруты непосредственно подключённых сетей

route_map

string

Ссылка на route-map

eigrp

dictionary

Усовершенствованный протокол маршрутизации внутреннего шлюза (EIGRP)

as_number

integer

Номер автономной системы

route_map

string

Ссылка на route-map

isis

dictionary

Протокол «промежуточная система — промежуточная система» (ISIS)

iso_tag

string

Метка области маршрутизации ISO

route_map

string

Ссылка на route-map

mobile

dictionary

Мобильные маршруты

route_map

string

Ссылка на route-map

odr

dictionary

Маршруты заглушки по запросу

route_map

string

Ссылка на route-map

ospf

dictionary

Протокол поиска кратчайшего пути (OSPF)

process_id

integer

Идентификатор процесса OSPF

route_map

string

Ссылка на route-map

rip

dictionary

Протокол маршрутной информации (RIP)

route_map

string

Ссылка на route-map

static

dictionary

Статические маршруты

route_map

string

Ссылка на route-map

recursion_policy

dictionary

Политика рекурсии при репликации маршрутов

destination

boolean

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

Варианты:

  • false
  • true

route_target

dictionary

Указывает расширенные сообщества Target VPN.

both

string

Этот параметр УСТАРЕЛ; вместо него используется both_options, принимающий список словарей.

both_options

list / elements=dictionary

Сообщество Target VPN для экспорта и импорта

rt_value

string

Сообщество Target VPN для экспорта.

stitching

boolean

Сообщество Target VPN для экспорта.

Варианты:

  • false
  • true

export

string

Этот параметр УСТАРЕЛ; вместо него используется exports, принимающий список словарей.

exports

list / elements=dictionary

Сообщество Target VPN для экспорта.

rt_value

string

Сообщество Target VPN для экспорта.

stitching

boolean

Сообщество Target VPN для экспорта.

Варианты:

  • false
  • true

import_config

string

Этот параметр УСТАРЕЛ; вместо него используется imports, принимающий список словарей.

imports

list / elements=dictionary

Сообщество Target VPN для экспорта.

rt_value

string

Сообщество Target VPN для экспорта.

stitching

boolean

Сообщество Target VPN для экспорта.

Варианты:

  • false
  • true

safi

string

Модификатор семейства адресов

Варианты:

  • "multicast"
  • "unicast"

name

string / обязательный

Имя VRF.

running_config

string

Этот параметр используется только при состоянии parsed.

Значением этого параметра должен быть вывод, полученный с устройства IOS при выполнении команды show running-config vrf.

Состояние parsed считывает конфигурацию из параметра running_config и преобразует её в структурированные данные Ansible в соответствии со спецификацией аргументов модуля ресурса; затем значение возвращается в ключе parsed результата.

state

string

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

Состояния rendered, gathered и parsed не вносят изменений на устройстве.

Состояние rendered преобразует конфигурацию из параметра config в команды CLI для конкретной платформы, которые будут возвращены в ключе rendered результата. Для состояния rendered активное подключение к удалённому узлу не требуется.

Состояние gathered получает текущую конфигурацию устройства и преобразует её в структурированные данные в формате, соответствующем спецификации аргументов модуля ресурса; значение возвращается в ключе gathered результата.

Состояние parsed считывает конфигурацию из параметра running_config и преобразует её в формат JSON в соответствии с параметрами модуля ресурса; значение возвращается в ключе parsed результата. Значение параметра running_config должно иметь тот же формат, что и вывод команды show running-config vrf. Подключение к удалённому узлу не требуется.

Варианты:

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

Примечания

Примечание

  • Проверено в CML на Cisco IOSXE версии 17.3.
  • Этот модуль работает с подключением network_cli. См. https://docs.ansible.com/ansible/latest/network/user_guide/platform_ios.html

Примеры

# Using merged
#
# Before state:
# -------------
#
# RP/0/0/CPU0:ios#show running-config | section ^vrf
# vrf defnition test
#

- name: Merge provided configuration with device configuration
  cisco.ios.ios_vrf_address_family:
    config:
      - name: test1
        address_families:
          - afi: "ipv4"
            safi: "unicast"
            bgp:
              next_hop:
                loopback: 40
            export:
              ipv4:
                multicast:
                  map: "single"
                  prefix: 345
                unicast:
                  allow_evpn: true
                  map: "test-map"
                  prefix: 67
              map: "testing-map"
            import_config:
              ipv4:
                multicast:
                  map: "import-map"
                  prefix: 89
                unicast:
                  allow_evpn: true
                  limit: 12
                  map: "ran-map"
              map: "import-map"
    state: merged

# Task Output:
# ------------
#
# before: []
#
# commands:
# - vrf definition test1
# - address-family ipv4 unicast
# - bgp next-hop loopback 40
# - export map "testing-map"
# - export ipv4 multicast 345 map "single"
# - export ipv4 unicast 67 map "test-map" allow-evpn
# - import map "import-map"
# - import ipv4 multicast 89 map "import-map"
# - import ipv4 unicast 12 map "ran-map" allow-evpn
#
# after:
# - name: test1
#   address_families:
#     - afi: "ipv4"
#       safi: "unicast"
#       bgp:
#         next_hop:
#           loopback: 40
#       export:
#         ipv4:
#           multicast:
#             map: "single"
#             prefix: 345
#           unicast:
#             allow_evpn: true
#             map: "test-map"
#             prefix: 67
#         map: "testing-map"
#       import_config:
#         ipv4:
#           multicast:
#             map: "import-map"
#             prefix: 89
#           unicast:
#             allow_evpn: true
#             limit: 12
#             map: "ran-map"
#       map: "import-map"
#
# After state:
# ------------
#
# RP/0/0/CPU0:ios#show running-config | section ^vrf
# vrf definition test1
#  address-family ipv4 unicast
#   bgp next-hop loopback 40
#   export map "testing-map"
#   export ipv4 multicast 345 map "single"
#   export ipv4 unicast 67 map "test-map" allow-evpn
#   import map "import-map"
#   import ipv4 multicast 89 map "import-map"
#   import ipv4 unicast 12 map "ran-map" allow-evpn

# Using replaced
#
# Before state:
# -------------
#
# RP/0/0/CPU0:ios#show running-config | section ^vrf
# vrf definition test1
#  address-family ipv4 unicast
#   bgp next-hop loopback 40
#   export map "testing-map"
#   export ipv4 multicast 345 map "single"
#   export ipv4 unicast 67 map "test-map" allow-evpn
#   import map "import-map"
#   import ipv4 multicast 89 map "import-map"
#   import ipv4 unicast 12 map "ran-map" allow-evpn

- name: Replace the provided configuration with the existing running configuration
  cisco.ios.ios_vrf_address_family:
    config:
      - name: test1
        address_families:
          - afi: "ipv4"
            safi: "unicast"
            bgp:
              next_hop:
                loopback: 40
            export:
              ipv4:
                multicast:
                  map: "single"
                  prefix: 345
                unicast:
                  allow_evpn: true
                  map: "test-map"
                  prefix: 67
              map: "testing-map"
            import_config:
              ipv4:
                multicast:
                  map: "import-map"
                  prefix: 89
                unicast:
                  allow_evpn: true
                  limit: 12
                  map: "ran-map"
              map: "import-map"
    state: replaced

# Task Output:
# ------------
#
# before:
# - name: test1
#   address_families:
#     - afi: "ipv4"
#       safi: "unicast"
#       bgp:
#         next_hop:
#           loopback: 40
#       export:
#         ipv4:
#           multicast:
#             map: "single"
#             prefix: 345
#           unicast:
#             allow_evpn: true
#             map: "test-map"
#             prefix: 67
#         map: "testing-map"
#       import_config:
#         ipv4:
#           multicast:
#             map: "import-map"
#             prefix: 89
#           unicast:
#             allow_evpn: true
#             limit: 12
#             map: "ran-map"
#       map: "import-map"
#
# commands:
# - vrf definition test1
# - address-family ipv4 unicast
# - bgp next-hop loopback 40
# - export map "testing-map"
# - export ipv4 multicast 345 map "single"
# - export ipv4 unicast 67 map "test-map" allow-evpn
# - import map "import-map"
# - import ipv4 multicast 89 map "import-map"
# - import ipv4 unicast 12 map "ran-map" allow-evpn
#
# after:
# - name: VRF1
#   address_families:
#     - afi: "ipv4"
#       safi: "unicast"
#       bgp:
#         next_hop:
#           loopback: 23
#       export:
#         ipv4:
#           multicast:
#             map: "single"
#             prefix: 33
#           unicast:
#             allow_evpn: true
#             map: "test-map1"
#             prefix: 7
#         map: "testing-map"
#       import_config:
#         ipv4:
#           multicast:
#             map: "import-map1"
#             prefix: 89
#           unicast:
#             allow_evpn: true
#             limit: 12
#             map: "ran-map"
#       map: "import-map"
#
# After state:
# ------------
#
# RP/0/RP0/CPU0:ios(config)#show running-config vrf
# vrf definition VRF1
#  address-family ipv4 unicast
#   bgp next-hop loopback 23
#   export map "testing-map"
#   export ipv4 multicast 345 map "single"
#   export ipv4 unicast 67 map "test-map1" allow-evpn
#   import map "import-map"
#   import ipv4 multicast 89 map "import-map1"
#   import ipv4 unicast 12 map "ran-map" allow-evpn

# Using overridden
#
# Before state:
# -------------
#
# RP/0/RP0/CPU0:ios(config)#show running-config | section ^vrf
# vrf definition test1
#  address-family ipv4 unicast
#   bgp next-hop loopback 40
#   export map "testing-map"
#   export ipv4 multicast 345 map "single"
#   export ipv4 unicast 67 map "test-map" allow-evpn
#   import map "import-map"
#   import ipv4 multicast 89 map "import-map"
#   import ipv4 unicast 12 map "ran-map" allow-evpn

- name: Override the provided configuration with the existing running configuration
  cisco.ios.ios_vrf_address_family:
    state: overridden
    config:
      - name: VRF7
        address_families:
          - afi: "ipv4"
            safi: "unicast"
            bgp:
              next_hop:
                loopback: 89
            export:
              ipv4:
                multicast:
                  map: "single"
                  prefix: 345
                unicast:
                  allow_evpn: true
                  map: "test-map"
                  prefix: 67
              map: "testing-map"
            import_config:
              ipv4:
                multicast:
                  map: "import-map"
                  prefix: 89
                unicast:
                  allow_evpn: true
                  limit: 12
                  map: "ran-map"
              map: "import-map"
# Task Output:
# ------------
#
# before:
# - name: test1
#   address_families:
#     - afi: "ipv4"
#       safi: "unicast"
#       bgp:
#         next_hop:
#           loopback: 40
#       export:
#         ipv4:
#           multicast:
#             map: "single"
#             prefix: 345
#           unicast:
#             allow_evpn: true
#             map: "test-map"
#             prefix: 67
#         map: "testing-map"
#       import_config:
#         ipv4:
#           multicast:
#             map: "import-map"
#             prefix: 89
#           unicast:
#             allow_evpn: true
#             limit: 12
#             map: "ran-map"
#       map: "import-map"
#
# commands:
# - vrf definition VRF7
# - address-family ipv4 unicast
# - bgp next-hop loopback 89
# - export map "testing-map"
# - export ipv4 multicast 345 map "single"
# - export ipv4 unicast 67 map "test-map" allow-evpn
# - import map "import-map"
# - import ipv4 multicast 89 map "import-map"
# - import ipv4 unicast 12 map "ran-map" allow-evpn

#
# After state:
# -------------
# RP/0/RP0/CPU0:ios(config)#show running-config vrf
# vrf definition VRF4
# vrf definition VRF7
#  address-family ipv4 unicast
#   bgp next-hop loopback 89
#   export map "testing-map"
#   export ipv4 multicast 345 map "single"
#   export ipv4 unicast 67 map "test-map" allow-evpn
#   import map "import-map"
#   import ipv4 multicast 89 map "import-map1"
#   import ipv4 unicast 12 map "ran-map" allow-evpn

# Using deleted
#
# Before state:
# -------------
#
# RP/0/RP0/CPU0:ios(config)#show running-config | section ^vrf
# vrf definition VRF4
# vrf definition VRF6
# address-family ipv4 unicast
#  bgp next-hop loopback 40
#  import map "import-map"
#  import ipv4 multicast 89 map "import-map"
#  import ipv4 unicast 12 map "ran-map" allow-evpn
#  export map "testing-map"
#  export ipv4 multicast 345 map "single"
#  export ipv4 unicast 67 map "test-map" allow-evpn
# vrf definition VRF7

- name: Delete the provided configuration
  cisco.ios.ios_vrf_address_family:
    config:
    state: deleted

# Task Output:
# ------------
#
# before:
# - name: VRF4
# - name: VRF6
#   address_families:
#     - afi: "ipv4"
#       safi: "unicast"
#       bgp:
#         next_hop:
#           loopback: 23
#       import_config:
#         ipv4:
#           multicast:
#             map: "import-map"
#             prefix: 89
#           unicast:
#             map: "ran-map"
#             limit: 12
#             allow_evpn: true
#         map: "import-map"
#       export:
#         ipv4:
#           multicast:
#             map: "single"
#             prefix: 345
#           unicast:
#             map: "test-map"
#             prefix: 67
#             allow_evpn: true
#         map: "testing-map"
# - name: VRF7

# commands:
# - vrf definition VRF4
# - vrf definition VRF6
# - no address-family ipv4 unicast
# - vrf definition VRF7
#
# after:
# - name: VRF4
# - name: VRF6
# - name: VRF7
#
# After state:
# ------------
#
# RP/0/RP0/CPU0:ios(config)#show running-config | section ^vrf
# vrf definition VRF4
# vrf definition VRF6
# vrf definition VRF7

# Using rendered
#
- name: Render provided configuration with device configuration
  cisco.ios.ios_vrf_address_family:
    config:
      - name: test
        address_families:
          - afi: "ipv4"
            safi: "unicast"
            bgp:
              next_hop:
                loopback: 23
            import_config:
              ipv4:
                multicast:
                  map: "import-map"
                  prefix: 89
                unicast:
                  map: "ran-map"
                  limit: 12
                  allow_evpn: true
              map: "import-map"
            export:
              ipv4:
                multicast:
                  map: "single"
                  prefix: 345
                unicast:
                  map: "test-map"
                  prefix: 67
                  allow_evpn: true
              map: "testing-map"
    state: rendered

# Task Output:
# ------------
#
# rendered:
# - vrf definition test
# - address-family ipv4 unicast
# - bgp next-hop loopback 23
# - import map "import-map"
# - import ipv4 multicast 89 map "import-map"
# - import ipv4 unicast 12 map "ran-map" allow-evpn
# - export map "testing-map"
# - export ipv4 multicast 345 map "single"
# - export ipv4 unicast 67 map "test-map" allow-evpn

# Using gathered
#
# Before state:
# -------------
#
# RP/0/RP0/CPU0:ios(config)#show running-config | section ^vrf
# vrf definition test1
# address-family ipv4 unicast
#  bgp next-hop loopback 40
#  import map "import-map"
#  import ipv4 multicast 89 map "import-map"
#  import ipv4 unicast 12 map "ran-map" allow-evpn
#  export map "testing-map"
#  export ipv4 multicast 345 map "single"
#  export ipv4 unicast 67 map "test-map" allow-evpn

- name: Gather existing running configuration
  cisco.ios.ios_vrf_address_family:
    state: gathered

# Task Output:
# ------------
#
# gathered:
# - name: test1
#   address_families:
#    - afi: "ipv4"
#      safi: "unicast"
#      bgp:
#        next_hop:
#          loopback: 40
#      export:
#        ipv4:
#          multicast:
#            map: "single"
#            prefix: 345
#          unicast:
#            allow_evpn: true
#            map: "test-map"
#            prefix: 67
#        map: "testing-map"
#      import_config:
#        ipv4:
#          multicast:
#            map: "import-map"
#            prefix: 89
#          unicast:
#            allow_evpn: true
#            limit: 12
#            map: "ran-map"
#        map: "import-map"

# Using parsed
#
# File: parsed.cfg
# ----------------
#
# vrf definition test
# address-family ipv4 unicast
#  bgp next-hop loopback 23
#  import map "import-map"
#  import ipv4 multicast 89 map "import-map"
#  import ipv4 unicast 12 map "ran-map" allow-evpn
#  export map "testing-map"
#  export ipv4 multicast 345 map "single"
#  export ipv4 unicast 67 map "test-map" allow-evpn

- name: Parse the provided configuration
  cisco.ios.ios_vrf_address_family:
    running_config: "{{ lookup('file', 'parsed.cfg') }}"
    state: parsed

# Task Output:
# ------------
#
# parsed:
#   - address_families:
#     - afi: ipv4
#       bgp:
#         next_hop:
#           loopback: 40
#        export:
#          ipv4:
#            multicast:
#              map: "single"
#              prefix: 345
#            unicast:
#              allow_evpn: true
#              map: "test-map"
#              prefix: 67
#          map: "testing-map"
#        import_config:
#          ipv4:
#            multicast:
#              map: "import-map"
#              prefix: 89
#            unicast:
#              allow_evpn: true
#              limit: 12
#              map: "ran-map"
#       safi: unicast
#     name: test

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

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

Ключ

Описание

after

list / elements=string

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

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

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

before

list / elements=string

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

Возвращается: если state имеет значение merged, replaced, overridden, deleted или purged

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

commands

list / elements=string

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

Возвращается: если state имеет значение merged, replaced, overridden, deleted

Пример: ["vrf definition test1", "address-family ipv4 unicast", "bgp next-hop loopback 40", "export map \"testing-map\"", "export ipv4 multicast 345 map \"testmap\""]

gathered

list / elements=string

Факты о сетевом ресурсе, полученные с удалённого устройства в виде структурированных данных.

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

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

parsed

list / elements=string

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

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

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

rendered

list / elements=string

Конфигурация из задачи преобразована в собственный формат устройства (в автономном режиме).

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

Пример: ["vrf definition test1", "address-family ipv4 unicast", "bgp next-hop loopback 40", "import map \"testing-map\"", "export ipv4 multicast 345 map \"testmap\""]

Авторы

  • Ruchi Pakhle (@Ruchip16)

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

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 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/ios/ios_vrf_address_family_module.html

Spec-Zone.ru

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