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

Примечание

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

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

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

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

Новый в cisco.ios 1.0.0

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

Описание

Этот модуль обеспечивает декларативное управление определениями VRF на устройствах Cisco IOS. Он позволяет плейбукам управлять отдельными или всеми определениями VRF. Он также поддерживает удаление из конфигурации определений VRF, которые не определены явно.

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

Параметры

Параметр	Комментарии
address_family список / элементы=словарь	Список семейств адресов с параметрами MDT, которые необходимо настроить на удалённом устройстве IOS.
afi строка	Идентификатор семейства адресов. Варианты: `"ipv4"` `"ipv6"`
mdt словарь	Параметры MDT.
auto_discovery словарь	Параметры автоматического обнаружения.
vxlan словарь	Параметры VXLAN.
enable булево	Включить VXLAN. Варианты: `false` `true`
inter_as булево	Включить меж-AS. Варианты: `false` `true`
data словарь	Параметры для опции data.
threshold целое число	Значение порога.
vxlan_mcast_group строка	Значение группы мультикаста VXLAN.
default словарь	Параметры для опции по умолчанию.
vxlan_mcast_group строка	Значение группы мультикаста VXLAN.
overlay словарь	Параметры для опции overlay.
use_bgp словарь	Параметры для опции BGP.
enable булево	Включить использование BGP. Варианты: `false` `true`
spt_only булево	Включить только SPT. Варианты: `false` `true`
associated_interfaces список / элементы=строка	Это опция намерения и проверяет операционное состояние для заданной ВРФ `name` для ассоциированных интерфейсов. Если значение в `associated_interfaces` не совпадает с операционным состоянием интерфейсов ВРФ на устройстве, это приведёт к ошибке.
delay целое число	Время в секундах, которое нужно подождать, прежде чем проверять операционное состояние на удалённом устройстве. По умолчанию: `10`
description строка	Предоставляет краткое описание определения ВРФ в текущей активной конфигурации. Значение определения ВРФ принимает алфавитно-цифровые символы, используемые для предоставления дополнительной информации о ВРФ.
interfaces список / элементы=строка	Определяет набор интерфейсов, которые должны быть настроены в ВРФ. Интерфейсы должны быть маршрутизируемыми интерфейсами, чтобы их можно было поместить в ВРФ.
name строка	Имя определения ВРФ, которое нужно управлять на удалённом устройстве IOS. Имя определения ВРФ — это ASCII-строковое имя, используемое для уникальной идентификации ВРФ. Этот аргумент взаимоисключающий с аргументом `vrfs`
purge булево	Инструктирует модуль рассматривать определение ВРФ как абсолютное. Он удалит любые ранее настроенные ВРФ на устройстве. Варианты: `false` ← (по умолчанию) `true`
rd строка	Значение маршрутизатора-дискриминатора, которое однозначно определяет ВРФ для процессов маршрутизации на удалённой системе IOS. Значение RD имеет вид `A:B`, где `A` и `B` — числовые значения.

route_both список / элементы=строка	Добавляет список экспорта и импорта расширенных сообщений целевого маршрута в VRF.
route_both_ipv4 список / элементы=строка	Добавляет список экспорта и импорта расширенных сообщений целевого маршрута в подрежиме конфигурации семейства адресов в VRF.
route_both_ipv6 список / элементы=строка	Добавляет список экспорта и импорта расширенных сообщений целевого маршрута в подрежиме конфигурации семейства адресов в VRF.
route_export список / элементы=строка	Добавляет список экспорта расширенных сообщений целевого маршрута в VRF.
route_export_ipv4 список / элементы=строка	Добавляет список экспорта расширенных сообщений целевого маршрута в подрежиме конфигурации семейства адресов в VRF.
route_export_ipv6 список / элементы=строка	Добавляет список экспорта расширенных сообщений целевого маршрута в подрежиме конфигурации семейства адресов в VRF.
route_import список / элементы=строка	Добавляет список импорта расширенных сообщений целевого маршрута в VRF.
route_import_ipv4 список / элементы=строка	Добавляет список импорта расширенных сообщений целевого маршрута в подрежиме конфигурации семейства адресов в VRF.
route_import_ipv6 список / элементы=строка	Добавляет список импорта расширенных сообщений целевого маршрута в подрежиме конфигурации семейства адресов в VRF.
state строка	Настраивает состояние определения VRF, связанное с рабочей конфигурацией устройства. При установке в present VRF должна быть настроена в активной конфигурации устройства, а при установке в absent VRF не должна быть в активной конфигурации устройства Варианты: `"present"` ← (по умолчанию) `"absent"`
vrfs список / элементы=любой	Набор объектов определения VRF, которые будут настроены на удалённом устройстве IOS. Элементы списка могут быть именем VRF или хешем из определений VRF и атрибутов. Этот аргумент взаимоисключающий с аргументом `name`.

Примечания

Примечание

Проверено на Cisco IOSXE версии 17.3 на CML.
Этот модуль работает с подключением network_cli. См. https://docs.ansible.com/ansible/latest/network/user_guide/platform_ios.html
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве по сетям Ansible: :ref:`Руководство по сети Ansible <network_guide>`
Дополнительную информацию об использовании Ansible для управления устройствами Cisco см. на странице интеграции Cisco: `<https://www.ansible.com/integrations/networks/cisco>`_.

Примеры

- name: Configure a vrf named management
  cisco.ios.ios_vrf:
    name: management
    description: oob mgmt vrf
    interfaces:
      - Management1

- name: Remove a vrf named test
  cisco.ios.ios_vrf:
    name: test
    state: absent

- name: Configure set of VRFs and purge any others
  cisco.ios.ios_vrf:
    vrfs:
      - red
      - blue
      - green
    purge: true

- name: Creates a list of import RTs for the VRF with the same parameters
  cisco.ios.ios_vrf:
    name: test_import
    rd: 1:100
    route_import:
      - 1:100
      - 3:100

- name:
    Creates a list of import RTs in address-family configuration submode for the
    VRF with the same parameters
  cisco.ios.ios_vrf:
    name: test_import_ipv4
    rd: 1:100
    route_import_ipv4:
      - 1:100
      - 3:100

- name:
    Creates a list of import RTs in address-family configuration submode for the
    VRF with the same parameters
  cisco.ios.ios_vrf:
    name: test_import_ipv6
    rd: 1:100
    route_import_ipv6:
      - 1:100
      - 3:100

- name: Creates a list of export RTs for the VRF with the same parameters
  cisco.ios.ios_vrf:
    name: test_export
    rd: 1:100
    route_export:
      - 1:100
      - 3:100

- name:
    Creates a list of export RTs in address-family configuration submode for the
    VRF with the same parameters
  cisco.ios.ios_vrf:
    name: test_export_ipv4
    rd: 1:100
    route_export_ipv4:
      - 1:100
      - 3:100

- name:
    Creates a list of export RTs in address-family configuration submode for the
    VRF with the same parameters
  cisco.ios.ios_vrf:
    name: test_export_ipv6
    rd: 1:100
    route_export_ipv6:
      - 1:100
      - 3:100

- name:
    Creates a list of import and export route targets for the VRF with the same
    parameters
  cisco.ios.ios_vrf:
    name: test_both
    rd: 1:100
    route_both:
      - 1:100
      - 3:100

- name:
    Creates a list of import and export route targets in address-family configuration
    submode for the VRF with the same parameters
  cisco.ios.ios_vrf:
    name: test_both_ipv4
    rd: 1:100
    route_both_ipv4:
      - 1:100
      - 3:100

- name:
    Creates a list of import and export route targets in address-family configuration
    submode for the VRF with the same parameters
  cisco.ios.ios_vrf:
    name: test_both_ipv6
    rd: 1:100
    route_both_ipv6:
      - 1:100
      - 3:100

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

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

Ключ	Описание
commands список / элементы=строка	Список команд режима конфигурации, которые нужно отправить устройству Возвращается: всегда Пример: `["vrf definition ansible", "description management vrf", {"rd": "1:100"}]`
delta строка	Затраченное время на выполнение всех операций Возвращается: всегда Пример: `"0:00:10.469466"`
end строка	Время завершения задачи Возвращается: всегда Пример: `"2016-11-16 10:38:25.595612"`
start строка	Время начала задачи Возвращается: всегда Пример: `"2016-11-16 10:38:15.126146"`

Авторы

Peter Sprygada (@privateip)

Ссылки на сборку

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