cisco.nxos.nxos_vrf модуль — Управление глобальной конфигурацией VRF.

Примечание

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

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

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

Для использования в плейбуке укажите: cisco.nxos.nxos_vrf.

Новая функция в cisco.nxos 1.0.0

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

Обзор

Этот модуль предоставляет декларативное управление VRF на сетевых устройствах CISCO NXOS.

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

Параметры

Параметр	Комментарии
admin_state строка	Административное состояние VRF. Варианты: `"up"` ← (по умолчанию) `"down"`
aggregate список / элементы=словарь	Список определений VRF.
admin_state строка	Административное состояние VRF. Варианты: `"up"` `"down"`
associated_interfaces список / элементы=строка	Это параметр намерений и проверяет операционное состояние для данного vrf `name` для связанных интерфейсов. Если значение в `associated_interfaces` не соответствует операционному состоянию интерфейсов vrf на устройстве, это приведет к ошибке.
delay целое число	Время в секундах ожидания проверки операционного состояния на удаленном устройстве. Это ожидание применимо к аргументам операционного состояния.
description строка	Описание VRF или ключевое слово «default».
interfaces список / элементы=строка	Список интерфейсов для проверки правильности конфигурации VRF или ключевое слово «default».
name псевдонимы: vrf строка	Имя VRF, которое нужно управлять.
rd строка	VPN Route Distinguisher (RD). Допустимые значения — строка в одном из форматов route-distinguisher (ASN2:NN, ASN4:NN или IPV4:NN); ключевое слово «auto» или ключевое слово «default».
state строка	Управляет желаемым состоянием ресурса. Варианты: `"present"` `"absent"`
vni строка	Укажите идентификатор виртуальной сети. Допустимые значения — целое число или ключевое слово «default».
associated_interfaces список / элементы=строка	Это параметр намерений и проверяет операционное состояние для данного vrf `name` для связанных интерфейсов. Если значение в `associated_interfaces` не соответствует операционному состоянию интерфейсов vrf на устройстве, это приведет к ошибке.
delay целое число	Время в секундах ожидания проверки операционного состояния на удаленном устройстве. Это ожидание применимо к аргументам операционного состояния. По умолчанию: `10`
description строка	Описание VRF или ключевое слово «default».
interfaces список / элементы=строка	Список интерфейсов для проверки правильности конфигурации VRF или ключевое слово «default».
name псевдонимы: vrf строка	Имя VRF, которое нужно управлять.
purge логический тип	Удалить VRF, не определённые в параметре aggregate. Варианты: `false` ← (по умолчанию) `true`
rd строка	VPN Route Distinguisher (RD). Допустимые значения — строка в одном из форматов route-distinguisher (ASN2:NN, ASN4:NN или IPV4:NN); ключевое слово «auto» или ключевое слово «default».
state строка	Управляет желаемым состоянием ресурса. Варианты: `"present"` ← (по умолчанию) `"absent"`
vni строка	Укажите идентификатор виртуальной сети. Допустимые значения — целое число или ключевое слово «default».

END_OF_DOCUMENT_MARKER

Примечания

Примечание

Проверено на NXOSv 7.3.(0)D1(1) на VIRL
Не поддерживается для Cisco MDS
Cisco NX-OS создаёт по умолчанию VRF сам. Поэтому вы не можете использовать default как имя vrf в этом модуле.
vrf имя должно быть короче 32 символов.
Имена VRF в NX-OS регистронезависимы. Тем не менее, имя сохраняется так, как его ввёл пользователь, и не будет изменено, пока VRF не будет удалён и пересоздан. Например, vrf=ntc создаст VRF с именем NTC, но повторное выполнение с vrf=ntc не вызовет изменений конфигурации.
Для информации о использовании CLI и NX-API см. руководство :ref:`NXOS Platform Options <nxos_platform_options>`
Для получения более подробной информации об использовании Ansible для управления сетевыми устройствами см. руководство :ref:`Ansible Network Guide <network_guide>`
Для получения более подробной информации об использовании Ansible для управления устройствами Cisco см. страницу интеграции Cisco `<https://www.ansible.com/integrations/networks/cisco>`_.

Примеры

- name: Ensure ntc VRF exists on switch
  cisco.nxos.nxos_vrf:
    name: ntc
    description: testing
    state: present
- name: Aggregate definition of VRFs
  cisco.nxos.nxos_vrf:
    aggregate:
      - name: test1
        description: Testing
        admin_state: down
      - name: test2
        interfaces: Ethernet1/2
- name: Aggregate definitions of VRFs with Purge
  cisco.nxos.nxos_vrf:
    aggregate:
      - name: ntc1
        description: purge test1
      - name: ntc2
        description: purge test2
    state: present
    purge: true
- name: Delete VRFs exist on switch
  cisco.nxos.nxos_vrf:
    aggregate:
      - name: ntc1
      - name: ntc2
    state: absent
- name: Assign interfaces to VRF declaratively
  cisco.nxos.nxos_vrf:
    name: test1
    interfaces:
      - Ethernet2/3
      - Ethernet2/5
- name: Check interfaces assigned to VRF
  cisco.nxos.nxos_vrf:
    name: test1
    associated_interfaces:
      - Ethernet2/3
      - Ethernet2/5
- name: >-
    Ensure VRF is tagged with interface Ethernet2/5 only (Removes from
    Ethernet2/3)
  cisco.nxos.nxos_vrf:
    name: test1
    interfaces:
      - Ethernet2/5
- name: Delete VRF
  cisco.nxos.nxos_vrf:
    name: ntc
    state: absent

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

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

Ключ	Описание
commands список / элементы=строка	Команды, отправленные устройству Возвращается: всегда Пример: `["vrf context ntc", "no shutdown", "interface Ethernet1/2", "no switchport", "vrf member test2"]`

Авторы

Jason Edelman (@jedelman8)
Gabriele Gerbino (@GGabriele)
Trishna Guha (@trishnaguha)

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

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