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

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

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

Обзор

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

Параметры

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

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

- name: Ensure Ethernet1/5 only has vlans 5-10 as trunk vlans
  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)
  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
  cnos_l2_interface:
    name: Ethernet1/5
    mode: trunk
    trunk_vlans: 51-4094
    state: absent

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

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

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

Статус

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

Авторы

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.9/modules/cnos_l2_interface_module.html