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

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

Описание
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Поддержка
- Автор

Описание

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

Параметры

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

Примечания

Примечание

Проверено на NXOSv 7.0(3)I5(1).
state=absent удаляет конфигурацию порт-канала и интерфейс, если она уже существует. Если члены для удаления не передаются явно, удаляются все существующие члены (если таковые есть).
Members должен быть списком.
LACP нужно сначала включить, если используются режимы active/passive.
Сведения о применении CLI и NX-API см. в руководстве NXOS Platform Options
Дополнительная информация о использовании Ansible для управления сетевыми устройствами см. в руководстве Ansible Network Guide
Дополнительная информация о применении 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 список	всегда, за исключением платформ, использующих транспорт Netconf для управления устройством.	Список команд режима конфигурации, которые нужно отправить устройству Пример: ['interface port-channel 30', 'lacp min-links 5', 'interface Ethernet2/1', 'channel-group 30 mode active', 'no interface port-channel 30']

Статус

Этот модуль помечен как preview, что означает, что он не гарантирует обратную совместимость интерфейса.

Техническое обслуживание

Этот модуль помечен как сетевой, что означает, что он поддерживается командой Ansible Network Team. Для получения дополнительной информации см. поддержку и техническое обслуживание модулей.

Список других модулей, также поддерживаемых командой Ansible Network Team, см. здесь.

Поддержка

Для получения дополнительной информации о поддержке этого модуля 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.6/modules/nxos_linkagg_module.html