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

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

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

УСТАНОВЛЕНО

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

Описание

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

Параметры

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

Примечания

Примечание

Проверено на NXOSv 7.3.(0)D1(1) на VIRL
state=absent удаляет конфигурацию канала портов и интерфейс, если он уже существует. Если члены, подлежащие удалению, не указаны явно, удаляются все существующие члены (если таковые имеются).
Члены должны быть списком.
LACP необходимо включить вначале, если используются режимы актив/пассив.
Для получения информации об использовании CLI и NX-API см. руководство по параметрам платформы NXOS
Для получения дополнительной информации об использовании Ansible для управления сетевыми устройствами см. руководство по сети Ansible
Для получения дополнительной информации об использовании 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.5/modules/nxos_portchannel_module.html