nxos_vlans – Создание VLAN и управление конфигурациями VLAN на интерфейсах NX-OS

Новая версия 2.9.

Обзор
Параметры
Примечания
Примеры
Значения возврата
Статус

Обзор

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
config список			Словарь параметров VLAN
	enabled булево	Варианты: нет да	Управление административным состоянием VLAN.
	mapped_vni целое число		Идентификатор Virtual Network Identifier (VNI), сопоставленный с VLAN.
	mode строка	Варианты: ce fabricpath	Устанавливает режим VLAN на классический Ethernet или fabricpath. Этот параметр действителен для серий Nexus 5000, 6000 и 7000.
	name строка		Имя VLAN.
	state строка	Варианты: активный приостановленный	Управление рабочим состоянием VLAN.
	vlan_id целое число / обязательно		Идентификатор VLAN.
state строка		Варианты: слитый ← замененный переопределённый удаленный	Состояние конфигурации после завершения модуля.

Примечания

Примечание

Проверено на NXOS 7.3.(0)D1(1) на VIRL

Примеры

# Using merged

# Before state:
# -------------
# vlan 1

- name: Merge provided configuration with device configuration.
  nxos_vlans:
    config:
      - vlan_id: 5
        name: test-vlan5
      - vlan_id: 10
        enabled: False
    state: merged

# After state:
# ------------
# vlan 5
#   name test-vlan5
#   state active
#   no shutdown
# vlan 10
#   state active
#   shutdown


# Using replaced

# Before state:
# -------------
# vlan 1
# vlan 5
#   name test-vlan5
# vlan 10
#   shutdown

- name: Replace device configuration of specified vlan with provided configuration.
  nxos_vlans:
    config:
      - vlan_id: 5
        name: test-vlan
        enabled: False
      - vlan_id: 10
        enabled: False
    state: replaced

# After state:
# ------------
# vlan 1
# vlan 5
#   name test-vlan
#   state active
#   shutdown
# vlan 10
#   state active
#   shutdown


# Using overridden

# Before state:
# -------------
# vlan 1
# vlan 3
#   name testing
# vlan 5
#   name test-vlan5
#   shutdown
# vlan 10
#   shutdown

- name: Override device configuration of all vlans with provided configuration.
  nxos_vlans:
    config:
      - vlan_id: 5
        name: test-vlan
      - vlan_id: 10
        state: active
    state: overridden

# After state:
# ------------
# vlan 1
# vlan 5
#   name test-vlan
#   state active
#   no shutdown
# vlan 10
#   state active
#   no shutdown


# Using deleted

# Before state:
# -------------
# vlan 1
# vlan 5
# vlan 10

- name: Delete vlans.
  nxos_vlans:
    config:
      - vlan_id: 5
      - vlan_id: 10
    state: deleted

# After state:
# ------------
# vlan 1

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

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

Ключ	Возвращаемое значение	Описание
after список	при изменении	Конфигурация в виде структурированных данных после завершения модуля. Пример: Возвращаемая конфигурация всегда будет в том же формате, что и параметры выше.
before список	всегда	Конфигурация в виде структурированных данных до вызова модуля. Пример: Возвращаемая конфигурация всегда будет в том же формате, что и параметры выше.
commands список	всегда	Набор команд, отправленных на удаленное устройство. Пример: ['vlan 5', 'name test-vlan5', 'state suspend']

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается командой Ansible Network Team. [сеть]

Поддержка Red Hat

Дополнительную информацию о поддержке этого модуля Red Hat можно найти в этой статье базы знаний Red Hat.

Авторы

Trishna Guha (@trishnaguha)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/nxos_vlans_module.html