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

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

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

УСТЕРЕЛО

Удалено в Ansible:
	версия: 2.13
Почему:	Выпущены обновлённые модули с большей функциональностью.
Альтернатива:	nxos_lag_interfaces

Описание

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

Параметры

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

Примечания

Примечание

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

Примеры

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

Статус

Этот модуль будет удален в версии 2.13. [устаревший]
Для получения дополнительной информации см. УСТАРЕВШИЙ.

Авторы

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