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

Примечание

Этот плагин является частью коллекции community.network (версия 2.0.1).

Для его установки используйте: 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. Псевдонимы: interface
native_vlan строка			VLAN по умолчанию, который нужно настроить в магистральном порту. Если `mode=trunk`, используется как идентификатор магистрального VLAN по умолчанию.
provider строка			Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli`. Для получения дополнительной информации, пожалуйста, обратитесь к руководству CNOS Platform Options. Объект словаря, содержащий данные соединения.
	auth_pass строка		Указывает пароль для входа в привилегированный режим на удаленном устройстве. Если authorize имеет значение false, этот аргумент не имеет эффекта. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_AUTH_PASS`.
	authorize логическое значение	Варианты: нет ← да	Указывает модулю войти в привилегированный режим на удаленном устройстве перед отправкой любых команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, используется значение переменной среды `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 в данном магистральном порту. Если `mode=trunk`, это единственные VLAN, которые будут настроены на магистральном порту, например, "2-10,15".
trunk_vlans строка			Список VLAN, которые нужно настроить в магистральном порту. Если `mode=trunk`, используется диапазон VLAN для ДОБАВЛЕНИЯ или УДАЛЕНИЯ из магистрали.

Примеры

- 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/network/cnos_l2_interface_module.html