cnos_vlan – Управление VLAN на устройствах сети CNOS

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

Описание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
aggregate - добавлен в 2.8			Список определений VLAN.
associated_interfaces - добавлен в 2.8			Это опция интента и проверяет оперативное состояние для заданного vlan `name` для связанных интерфейсов. Если значение в `associated_interfaces` не совпадает с оперативным состоянием интерфейсов vlan на устройстве, это приведет к ошибке.
delay - добавлен в 2.8		По умолчанию: 10	Задержка, которую должно выждать выполнение для проверки параметров декларативного интента.
interfaces - / обязательно добавлен в 2.8			Список интерфейсов, которые должны быть связаны с VLAN.
name - добавлен в 2.8			Имя VLAN.
provider - добавлен в 2.8			Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli`. Для получения дополнительной информации см. руководство CNOS Platform Options. Объект словаря, содержащий сведения о подключении.
	auth_pass -		Указывает пароль, который необходимо использовать при необходимости для входа в привилегированный режим на удаленном устройстве. Если authorize равно false, этот аргумент ничего не делает. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_AUTH_PASS`.
	authorize boolean	Варианты: нет ← да	Инструктирует модуль войти в привилегированный режим на удаленном устройстве перед отправкой команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_AUTHORIZE`.
	host - / обязательно		Указывает имя хоста DNS или адрес для подключения к удаленному устройству через указанный транспорт. Значение host используется в качестве адреса назначения для транспорта.
	password -		Указывает пароль для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_PASSWORD`.
	port -	По умолчанию: 22	Указывает порт, используемый при построении подключения к удаленному устройству.
	ssh_keyfile -		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Это значение — путь к ключу, используемому для аутентификации сеанса SSH. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout -	По умолчанию: 10	Указывает время ожидания в секундах для связи с сетевым устройством при подключении или отправке команд. Если время ожидания истечет до завершения операции, модуль вернет ошибку.
	username -		Настраивает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_USERNAME`.
purge boolean добавлен в 2.8		Варианты: нет ← да	Очистка VLAN, не определенных в параметре aggregate.
state - добавлен в 2.8		Варианты: present ← absent active suspend	Состояние конфигурации VLAN.
vlan_id - / обязательно добавлен в 2.8			Идентификатор VLAN. Диапазон 1-4094.

Примечания

Примечание

Тестировался на CNOS 10.8.1

Примеры

- name: Create vlan
  cnos_vlan:
    vlan_id: 100
    name: test-vlan
    state: present

- name: Add interfaces to VLAN
  cnos_vlan:
    vlan_id: 100
    interfaces:
      - Ethernet1/33
      - Ethernet1/44

- name: Check if interfaces is assigned to VLAN
  cnos_vlan:
    vlan_id: 100
    associated_interfaces:
      - Ethernet1/33
      - Ethernet1/44

- name: Delete vlan
  cnos_vlan:
    vlan_id: 100
    state: absent

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

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

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

Статус

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

Авторы

Anil Kumar Mureleedharan(@amuraleedhar)

Подсказка

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

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