community.network.cnos_l2_interface – Управление интерфейсом второго уровня на устройствах Lenovo CNOS.

Примечание

Этот плагин входит в коллекцию community.network (версия 1.3.0).

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

Для использования в книге задач укажите: community.network.cnos_l2_interface.

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

Описание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
access_vlan строка			Настройка заданного VLAN в порту доступа. Если `mode=access`, используется в качестве идентификатора VLAN доступа.
aggregate строка			Список определений интерфейсов второго уровня.
mode строка		Варианты: access ← trunk	Режим настройки интерфейса.
name строка / обязательно			Полное имя интерфейса, исключая номер логического блока, например Ethernet1/3. псевдонимы: интерфейс
native_vlan строка			VLAN по умолчанию для настройки порта trunk. Если `mode=trunk`, используется в качестве идентификатора VLAN по умолчанию для trunk.
provider строка			Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli`. Дополнительную информацию см. в руководстве CNOS Platform Options. Объект словаря, содержащий данные подключения.
	auth_pass строка		Указывает пароль для входа в привилегированный режим на удаленном устройстве. Если authorize имеет значение false, этот аргумент ничего не делает. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_AUTH_PASS`.
	authorize логическое	Варианты: no ← yes	Указывает модулю войти в привилегированный режим на удаленном устройстве перед отправкой команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, используется значение переменной среды `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`.
state строка		Варианты: present ← absent unconfigured	Управление состоянием конфигурации интерфейса второго уровня.
trunk_allowed_vlans строка			Список разрешенных VLAN в заданном порту trunk. Если `mode=trunk`, это единственные VLAN, которые будут настроены на trunk, например "2-10,15".
trunk_vlans строка			Список VLAN, которые нужно настроить в порту trunk. Если `mode=trunk`, используется диапазон VLAN для добавления или удаления из trunk.

Примеры

- name: Ensure Ethernet1/5 is in its default l2 interface state
  community.network.cnos_l2_interface:
    name: Ethernet1/5
    state: unconfigured

- name: Ensure Ethernet1/5 is configured for access vlan 20
  community.network.cnos_l2_interface:
    name: Ethernet1/5
    mode: access
    access_vlan: 20

- name: Ensure Ethernet1/5 only has vlans 5-10 as trunk vlans
  community.network.cnos_l2_interface:
    name: Ethernet1/5
    mode: trunk
    native_vlan: 10
    trunk_vlans: 5-10

- name: Ensure Ethernet1/5 is a trunk port and ensure 2-50 are being tagged
        (doesn't mean others aren't also being tagged)
  community.network.cnos_l2_interface:
    name: Ethernet1/5
    mode: trunk
    native_vlan: 10
    trunk_vlans: 2-50

- name: Ensure these VLANs are not being tagged on the trunk
  community.network.cnos_l2_interface:
    name: Ethernet1/5
    mode: trunk
    trunk_vlans: 51-4094
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
commands список / элементы=строка	всегда, кроме платформ, которые используют протокол Netconf для управления устройством.	Список команд конфигурации для отправки устройству Пример: ['interface Ethernet1/5', 'switchport access vlan 20']

Авторы

Anil Kumar Muraleedharan (@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.10/collections/community/network/cnos_l2_interface_module.html