icx_vlan – Управление VLAN на коммутаторах Ruckus ICX 7000 серии

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

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

Обзор

Этот модуль предоставляет декларативное управление VLAN на устройствах сети ICX.

Параметры

Параметр			Варианты/Значения по умолчанию	Комментарии
aggregate список				Список определений VLAN.
	associated_interfaces список			Это параметр намерений и проверяет операционное состояние указанной VLAN `name` для ассоциированных интерфейсов. Если значение в `associated_interfaces` не совпадает с операционным состоянием интерфейсов VLAN на устройстве, это приведёт к ошибке.
	associated_tagged список			Это параметр намерений и проверяет операционное состояние заданной VLAN `name` для ассоциированных меченных портов и LAG. Если значение в `associated_tagged` не совпадает с операционным состоянием интерфейсов VLAN на устройстве, это приведёт к ошибке.
	check_running_config логическое значение		Варианты: no yes	Проверка конфигурации текущего выполнения. Это можно установить как переменную окружения. Модуль будет использовать значение переменной окружения (по умолчанию: True), если это не переопределено, указав его как параметр модуля.
	delay целое число			Задержка, которую должен подождать запуск для проверки значений параметров декларативных намерений.
	interfaces словарь			Список портов Ethernet или LAG, которые будут добавлены как порты доступа (немеченные) к VLAN. Для добавления диапазона портов используйте ключевое слово «to». См. пример.
		name список		Имя интерфейса или LAG
		purge логическое значение	Варианты: no yes	Удаление интерфейсов, не определённых в параметре name
	ip_arp_inspection логическое значение		Варианты: no yes	Включает динамическую проверку ARP для VLAN.
	ip_dhcp_snooping логическое значение		Варианты: no yes	Включает DHCP-snooping для VLAN.
	name строка			Имя VLAN.
	state строка		Варианты: present absent	Состояние конфигурации VLAN.
	stp словарь			Включить spanning-tree 802-1w/rstp для этой VLAN.
		enabled логическое значение	Варианты: no yes	Управление состоянием (Включить/Выключить) spanning_tree_802_1w в текущей VLAN
		priority строка		Настраивает приоритет моста. Значение находится в диапазоне от 0 до 65535. Более низкое числовое значение означает, что у моста более высокий приоритет. Таким образом, наивысший приоритет — 0. По умолчанию — 32768.
		type строка	Варианты: 802-1w ← rstp	Укажите тип spanning-tree
	tagged словарь			Список портов Ethernet или LAG, которые будут добавлены как порты магистрали (меченные) к VLAN. Для добавления диапазона портов используйте ключевое слово 'to'. См. пример.
		name список		Имя интерфейса или LAG
		purge логическое значение	Варианты: no yes	Удаление интерфейсов, не определённых в параметре name
	vlan_id строка / обязательно			ID VLAN. Диапазон 1-4094.
associated_interfaces список				Это параметр намерений и проверяет операционное состояние указанной VLAN `name` для ассоциированных интерфейсов. Если значение в `associated_interfaces` не совпадает с операционным состоянием интерфейсов VLAN на устройстве, это приведёт к ошибке.
associated_tagged список				Это параметр намерений и проверяет операционное состояние заданной VLAN `name` для ассоциированных меченных портов и LAG. Если значение в `associated_tagged` не совпадает с операционным состоянием интерфейсов VLAN на устройстве, это приведёт к ошибке.
check_running_config логическое значение			Варианты: no yes ←	Проверка конфигурации текущего выполнения. Это можно установить как переменную окружения. Модуль будет использовать значение переменной окружения (по умолчанию: True), если это не переопределено, указав его как параметр модуля.
delay целое число			По умолчанию: 10	Задержка, которую должен подождать запуск для проверки значений параметров декларативных намерений.
interfaces словарь				Список портов Ethernet или LAG, которые будут добавлены как порты доступа (немеченные) к VLAN. Для добавления диапазона портов используйте ключевое слово «to». См. пример.
	name список			Имя интерфейса или LAG
	purge логическое значение		Варианты: no yes	Удаление интерфейсов, не определённых в параметре name
ip_arp_inspection логическое значение			Варианты: no yes	Включает динамическую проверку ARP для VLAN.
ip_dhcp_snooping логическое значение			Варианты: no yes	Включает DHCP-snooping для VLAN.
name строка				Имя VLAN.
purge логическое значение			Варианты: no ← yes	Удаление VLAN, не определённых в параметре aggregate.
state строка			Варианты: present ← absent	Состояние конфигурации VLAN.
stp словарь				Включить spanning-tree 802-1w/rstp для этой VLAN.
	enabled логическое значение		Варианты: no yes	Управление состоянием (Включить/Выключить) spanning_tree_802_1w в текущей VLAN
	priority строка			Настраивает приоритет моста. Значение находится в диапазоне от 0 до 65535. Более низкое числовое значение означает, что у моста более высокий приоритет. Таким образом, наивысший приоритет — 0. По умолчанию — 32768.

	тип строка	Варианты: 802-1w ← rstp	Укажите тип spanning-tree
tagged словарь			Список портов Ethernet или LAGS, которые нужно добавить в качестве портов trunk (tagged) в VLAN. Для добавления диапазона портов используйте ключевое слово 'to'. См. пример.
	название список		Имя интерфейса или lag
	purge булево	Варианты: нет да	Очистить интерфейсы, не определённые в поле имя
vlan_id целое число / обязательно			Идентификатор VLAN. Диапазон 1-4094.

Примечания

Примечание

Проверено на ICX 10.1.
Дополнительную информацию об использовании платформы ICX см. в руководстве по платформам ICX OS.

Примеры

- name: Add a single ethernet 1/1/48 as access(untagged) port to vlan 20
  icx_vlan:
    name: test-vlan
    vlan_id: 20
    interfaces:
      name:
        - ethernet 1/1/48

- name: Add a single LAG 10 as access(untagged) port to vlan 20
  icx_vlan:
    vlan_id: 20
    interfaces:
      name:
        - lag 10

- name: Add a range of ethernet ports as trunk(tagged) ports to vlan 20 by port
  icx_vlan:
    vlan_id: 20
    tagged:
      name:
        - ethernet 1/1/40 to 1/1/48

- name: Add discontinuous lags, ethernet ports as access(untagged) and trunk(tagged) port to vlan 20.
  icx_vlan:
    vlan_id: 20
    interfaces:
      name:
        - ethernet 1/1/40 to 1/1/48
        - ethernet 2/1/1
        - lag 1
        - lag 3 to 5
    tagged:
      name:
        - ethernet 1/1/20 to 1/1/25
        - lag 1 to 3

- name: Remove an access and range of trunk ports from vlan
  icx_vlan:
    vlan_id: 20
    interfaces:
      name:
        - ethernet 1/1/40
    tagged:
      name:
        - ethernet 1/1/39 to 1/1/70

- name: Enable dhcp snooping, disable arp inspection in vlan
  icx_vlan:
    vlan_id: 20
    ip_dhcp_snooping: present
    ip_arp_inspection: absent

- name: Create vlan 20.  Enable  arp inspection in vlan. Purge all other vlans.
  icx_vlan:
    vlan_id: 20
    ip_arp_inspection: present
    purge: present

- name: Remove vlan 20.
  icx_vlan:
    vlan_id: 20
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
commands список	всегда	Список команд конфигурации для отправки устройству Пример: ['vlan 100', 'name test-vlan']

Статус

Не гарантируется обратная совместимость данного модуля. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Ruckus Wireless (@Commscope)

Подсказка

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

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