nxos_portchannel — Управляет интерфейсами порт-каналов.

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

УСТАНОВЛЕНО
Описание
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
- Автор

УСТАНОВЛЕНО

Удалено в Ansible:
	версия: 2.9
Почему:	Заменено на общие модули сети `*_linkagg`.
Альтернатива:	Используйте nxos_linkagg вместо этого.

Описание

Управляет параметрами конфигурации, специфичными для порт-каналов.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
force		Варианты: false ← true	Если true, члены порт-канала будут соответствовать тому, что объявлено в параметре members. Это можно использовать для удаления членов.
group обязательно			Номер группы канала для порт-канала.
members			Список интерфейсов, которые будут управляться в данном порт-канале.
min_links			Минимальное количество каналов, необходимое для поддержания работоспособности порт-канала.
mode		Варианты: active passive on Значение по умолчанию: "yes"	Режим порт-канала, т.е. on, active, passive.
provider			Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli`. Этот параметр необходим только при использовании NX-API. Дополнительную информацию можно найти в руководстве NXOS Platform Options. Объект словаря, содержащий данные подключения.
	host обязательно		Указывает имя или адрес хоста DNS для подключения к удаленному устройству через указанный транспорт. Значение host используется в качестве адреса назначения для транспорта.
	port	Значение по умолчанию: "0 (использовать стандартный порт)"	Указывает порт, который необходимо использовать при создании подключения к удаленному устройству. Это значение относится к cli или nxapi. Значение порта по умолчанию соответствует стандартному порту транспорта, если он не указан в задаче. (cli=22, http=80, https=443).
	username		Устанавливает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации входа в CLI или аутентификации nxapi в зависимости от используемого транспорта. Если значение не указано в задаче, вместо него используется значение переменной среды `ANSIBLE_NET_USERNAME`.
	password		Указывает пароль для аутентификации подключения к удаленному устройству. Это общий параметр, используемый для транспортов cli или nxapi. Если значение не указано в задаче, вместо него используется значение переменной среды `ANSIBLE_NET_PASSWORD`.
	authorize bool (добавлено в 2.5.3)	Варианты: нет ← да	Указывает модулю войти в привилегированный режим на удаленном устройстве перед отправкой любых команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, вместо него используется значение переменной среды `ANSIBLE_NET_AUTHORIZE`.
	auth_pass (добавлено в 2.5.3)	Значение по умолчанию: "нет"	Указывает пароль, необходимый для входа в привилегированный режим на удаленном устройстве. Если authorize равно false, этот параметр ничего не делает. Если значение не указано в задаче, вместо него используется значение переменной среды `ANSIBLE_NET_AUTH_PASS`.
	timeout (добавлено в 2.3)	Значение по умолчанию: 10	Указывает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания истекает до завершения операции, модуль выдаст ошибку. NX-API может медленно возвращать данные при выполнении длительных команд (sh mac, sh bgp и т.д.).
	ssh_keyfile		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Этот параметр используется только для транспорта cli. Если значение не указано в задаче, вместо него используется значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	transport обязательно	Значение по умолчанию: "cli"	Настраивает транспортное соединение для подключения к удаленному устройству. Параметр transport поддерживает подключение к устройству через cli (ssh) или nxapi.
	use_ssl bool	Варианты: нет ← да	Настраивает transport для использования SSL, если значение равно true, только если `transport=nxapi`, в противном случае это значение игнорируется.
	validate_certs bool	Варианты: нет да	Если `no`, сертификаты SSL не будут проверяться. Это следует использовать только на контролируемых сайтах, использующих самозаверенные сертификаты. Если параметр transport не равен nxapi, это значение игнорируется.
	use_proxy bool (добавлено в 2.5)	Варианты: нет да ←	Если `no`, переменные среды `http_proxy` и `https_proxy` будут проигнорированы.
state		Варианты: present ← absent	Управляет состоянием ресурса.

Примечания

Примечание

Тестировалось на NXOSv 7.3.(0)D1(1) на VIRL
state=absent удаляет конфигурацию порт-канала и интерфейс, если они уже существуют. Если члены для удаления не указаны явно, удаляются все существующие члены (если таковые имеются).
Члены должны быть списком.
LACP необходимо включить предварительно, если используются режимы active/passive.
Дополнительная информация по использованию CLI и NX-API в руководстве NXOS Platform Options
Дополнительная информация об использовании Ansible для управления сетевыми устройствами в руководстве Ansible Network Guide
Дополнительную информацию об использовании Ansible для управления устройствами Cisco можно найти на странице интеграции Cisco.

Примеры

# Ensure port-channel99 is created, add two members, and set to mode on
- nxos_portchannel:
    group: 99
    members: ['Ethernet1/1','Ethernet1/2']
    mode: 'active'
    state: present

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

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

Ключ	Возвращаемое значение	Описание
commands список	всегда	Команда, отправленная на устройство Пример: ['interface Ethernet2/6', 'no channel-group 12', 'interface Ethernet2/5', 'no channel-group 12', 'interface Ethernet2/6', 'channel-group 12 mode on', 'interface Ethernet2/5', 'channel-group 12 mode on']

Статус

Этот модуль помечен как устаревший и будет удален в версии 2.9. Дополнительную информацию см. в разделе УСТАНОВЛЕНО.

Автор

Jason Edelman (@jedelman8)
Gabriele Gerbino (@GGabriele)

Подсказка

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

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/nxos_portchannel_module.html