nxos_linkagg – Управление группами агрегации каналов на устройствах Cisco NXOS.

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

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

Описание

Этот модуль предоставляет декларативное управление группами агрегации каналов на устройствах Cisco NXOS.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
aggregate -			Список определений агрегации каналов.
force boolean		Варианты: нет ← да	При значении true, члены группы агрегации каналов будут принудительно соответствовать значениям в параметре members. Это может использоваться для удаления членов.
group string / обязательно			Номер канала-группы для группы агрегации каналов port-channel.
members -			Список интерфейсов, которые будут управляться в группе агрегации каналов.
min_links -			Минимальное количество портов, необходимое для включения группы агрегации каналов.
mode -		Варианты: активный вкл ← пассивный	Режим для группы агрегации каналов.
provider -			Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli`. Этот параметр необходим только если используется NX-API. Для получения дополнительной информации, см. руководство NXOS Platform Options. Объект словаря, содержащий данные соединения.
	auth_pass - добавлен в 2.5.3	Значение по умолчанию: "none"	Указывает пароль для входа в привилегированный режим на удаленном устройстве. Если authorize ложно, то этот аргумент ничего не делает. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_AUTH_PASS`.
	authorize boolean добавлен в 2.5.3	Варианты: нет ← да	Указывает модулю войти в привилегированный режим на удаленном устройстве перед отправкой команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, будет использовано значение переменной среды `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"	Настраивает транспортное соединение для подключения к удаленному устройству. Транспортный аргумент поддерживает подключение к устройству через cli (ssh) или nxapi.
	use_proxy boolean добавлен в 2.5	Варианты: нет да ←	Если `no`, переменные среды `http_proxy` и `https_proxy` будут проигнорированы.
	use_ssl boolean	Варианты: нет ← да	Настраивает транспорт transport для использования SSL, если установлено значение true, только когда `transport=nxapi`, в противном случае это значение игнорируется.
	username -		Настраивает имя пользователя для аутентификации соединения с удаленным устройством. Это значение используется для аутентификации входа в CLI или аутентификации nxapi в зависимости от используемого транспорта. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_USERNAME`.
	validate_certs boolean	Варианты: нет да	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с самозаверяющими сертификатами. Если аргумент transport не nxapi, это значение игнорируется.
purge boolean		Варианты: нет ← да	Очистка ссылок, не определённых в параметре aggregate.
state -		Варианты: present ← absent	Состояние группы агрегации каналов.

Примечания

Примечание

Тестировано с NXOSv 7.0(3)I5(1).
state=absent удаляет конфигурацию portchannel и интерфейс, если они уже существуют. Если члены для удаления не указаны явно, удаляются все существующие члены (если таковые имеются).
Members должен быть списком.
LACP должен быть сначала включён, если используются режимы актив/пассив.
Для получения информации о использовании CLI и NX-API, см. Руководство по параметрам платформы NXOS
Для получения более подробной информации об использовании Ansible для управления сетевыми устройствами, см. Руководство по сетям Ansible
Для получения более подробной информации об использовании Ansible для управления устройствами Cisco, см. страницу интеграции Cisco.

Примеры

- name: create link aggregation group
  nxos_linkagg:
    group: 99
    state: present

- name: delete link aggregation group
  nxos_linkagg:
    group: 99
    state: absent

- name: set link aggregation group to members
  nxos_linkagg:
    group: 10
    min_links: 3
    mode: active
    members:
      - Ethernet1/2
      - Ethernet1/4

- name: remove link aggregation group from Ethernet1/2
  nxos_linkagg:
    group: 10
    min_links: 3
    mode: active
    members:
      - Ethernet1/4

- name: Create aggregate of linkagg definitions
  nxos_linkagg:
    aggregate:
      - { group: 3 }
      - { group: 100, min_links: 3 }

- name: Remove aggregate of linkagg definitions
  nxos_linkagg:
    aggregate:
      - { group: 3 }
      - { group: 100, min_links: 3 }
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
commands list	всегда, за исключением платформ, использующих транспорт Netconf для управления устройством.	Список команд режима конфигурации для отправки на устройство Пример: ['interface port-channel 30', 'lacp min-links 5', 'interface Ethernet2/1', 'channel-group 30 mode active', 'no interface port-channel 30']

Статус

Интерфейс этого модуля не гарантируется как обратной совместимый. [превью]
Этот модуль поддерживается командой Ansible Network. [сетевой]

Поддержка Red Hat

Дополнительную информацию о поддержке этого модуля компанией Red Hat можно найти в этой статье базы знаний Red Hat.

Авторы

Trishna Guha (@trishnaguha)

Подсказка

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

© 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_linkagg_module.html