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

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

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

УСТАРЕЛО

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

Синопсис

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

Параметры

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

Примечания

Примечание

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

Примеры

# 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.7/modules/nxos_portchannel_module.html