cisco.ios.ios_linkagg – Управление группами агрегирования каналов на устройствах Cisco IOS

Примечание

Этот плагин входит в состав коллекции cisco.ios (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install cisco.ios.

Для использования в playbook, укажите: cisco.ios.ios_linkagg.

Новое в версии 1.0.0: модуля cisco.ios

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

Описание

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

Примечание

Для этого модуля есть соответствующий плагин действия.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
aggregate список / элементы=словарь			Список определений агрегирования каналов.
	group строка / обязательный		Номер группы каналов для группы агрегирования каналов port-channel. Диапазон 1-255.
	members список / элементы=строка		Список членов группы агрегирования каналов.
	mode строка	Варианты: active on passive auto desirable	Режим группы агрегирования каналов. Режим on необходимо указывать в кавычках как 'on', иначе pyyaml преобразует его в True до передачи в Ansible.
	state строка	Варианты: present absent	Состояние группы агрегирования каналов.
group целое число			Номер группы каналов для группы агрегирования каналов port-channel. Диапазон 1-255.
members список / элементы=строка			Список членов группы агрегирования каналов.
mode строка		Варианты: active on passive auto desirable	Режим группы агрегирования каналов. Режим on необходимо указывать в кавычках как 'on', иначе pyyaml преобразует его в True до передачи в Ansible.
provider словарь			Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli`. Для получения дополнительной информации обратитесь к руководству по вариантам платформы IOS IOS Platform Options. Объект словаря, содержащий детали подключения.
	auth_pass строка		Указывает пароль для использования, если требуется для входа в привилегированный режим на удаленном устройстве. Если authorize ложно, этот аргумент не работает. Если значение не указано в задаче, будет использовано значение переменной окружения `ANSIBLE_NET_AUTH_PASS`.
	authorize логическое значение	Варианты: нет ← да	Указывает модулю войти в привилегированный режим на удаленном устройстве перед отправкой любых команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, будет использовано значение переменной окружения `ANSIBLE_NET_AUTHORIZE`.
	host строка		Указывает имя хоста DNS или адрес для подключения к удаленному устройству по указанному транспорту. Значение host используется в качестве адреса назначения для транспорта.
	password строка		Указывает пароль для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, будет использовано значение переменной окружения `ANSIBLE_NET_PASSWORD`.
	port целое число		Указывает порт для подключения к удаленному устройству.
	ssh_keyfile путь		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Это значение — путь к ключу, используемому для аутентификации сеанса SSH. Если значение не указано в задаче, будет использовано значение переменной окружения `ANSIBLE_NET_SSH_KEYFILE`.
	timeout целое число		Указывает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания превышено до завершения операции, модуль вернёт ошибку.
	username строка		Указывает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, будет использовано значение переменной окружения `ANSIBLE_NET_USERNAME`.
purge логическое значение		Варианты: нет ← да	Очистить ссылки, не определённые в параметре aggregate.
state строка		Варианты: present ← absent	Состояние группы агрегирования каналов.

Примечания

Примечание

Тестировалось с IOS 15.2
Для получения дополнительной информации об использовании Ansible для управления сетевыми устройствами, см. Руководство по сетям Ansible
Для получения дополнительной информации об использовании Ansible для управления устройствами Cisco, см. страницу интеграции Cisco.

Примеры

- name: create link aggregation group
  cisco.ios.ios_linkagg:
    group: 10
    state: present

- name: delete link aggregation group
  cisco.ios.ios_linkagg:
    group: 10
    state: absent

- name: set link aggregation group to members
  cisco.ios.ios_linkagg:
    group: 200
    mode: active
    members:
    - GigabitEthernet0/0
    - GigabitEthernet0/1

- name: remove link aggregation group from GigabitEthernet0/0
  cisco.ios.ios_linkagg:
    group: 200
    mode: active
    members:
    - GigabitEthernet0/1

- name: Create aggregate of linkagg definitions
  cisco.ios.ios_linkagg:
    aggregate:
    - {group: 3, mode: on, members: [GigabitEthernet0/1]}
    - {group: 100, mode: passive, members: [GigabitEthernet0/2]}

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

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

Ключ	Возвращаемое значение	Описание
commands список / элементы=строка	всегда, за исключением платформ, которые используют транспорт Netconf для управления устройством.	Список команд конфигурации в режиме конфигурации для отправки устройству Пример: ['interface port-channel 30', 'interface GigabitEthernet0/3', 'channel-group 30 mode on', 'no interface port-channel 30']

Авторы

Trishna Guha (@trishnaguha)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/cisco/ios/ios_linkagg_module.html