cisco.nxos.nxos_lacp_interfaces – Модуль ресурса интерфейсов LACP

Примечание

Этот плагин является частью коллекции cisco.nxos (версия 1.4.0).

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

Для использования в книге задач укажите: cisco.nxos.nxos_lacp_interfaces.

Новое в версии 1.0.0: of cisco.nxos

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

Обзор

Этот модуль управляет атрибутами протокола Link Aggregation Control Protocol (LACP) интерфейсов NX-OS.

Примечание

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

Параметры

Параметр			Варианты/Значения по умолчанию	Комментарии
config список / элементы=словарь				Словарь параметров интерфейсов LACP.
	convergence словарь			Этот словарь содержит настраиваемые параметры, относящиеся к сходимости. Применимо только для канала порта.
		graceful логическое значение	Варианты: no yes	постепенная сходимость lacp канала порта. Отключить только при подключенных портах lacp к узлам без Nexus. Отключение с узлом Nexus может привести к приостановке порта.
		vpc логическое значение	Варианты: no yes	Включить сходимость lacp для каналов портов vPC.
	links словарь			Этот словарь содержит настраиваемые параметры, относящиеся к максимальному и минимальному количеству связей канала порта. Применимо только для канала порта.
		max целое число		Максимальное количество каналов порта.
		min целое число		Минимальное количество связей канала порта.
	mode строка		Варианты: delay	Режим LACP. Применимо только для канала порта.
	name строка / обязательный			Имя интерфейса.
	port_priority целое число			Приоритет порта LACP для интерфейса. Диапазон 1-65535. Применимо только для Ethernet.
	rate строка		Варианты: fast normal	Скорость отправки PDU LACP. Применимо только для Ethernet. При высокой скорости LACP передается один раз в секунду. При нормальной скорости LACP передаётся каждые 30 секунд после объединения канала.
	suspend_individual логическое значение		Варианты: no yes	Состояние канала порта lacp. Отключение приведет к тому, что lacp переведет порт в отдельное состояние и не приостановит порт в случае, если он не получит LACP BPDU от портов-партнеров в канале порта.
running_config строка				Этот параметр используется только со значением parsed. Значение этого параметра должно быть выводом с устройства NX-OS, полученным с помощью команды show running-config \| section ^interface. Состояние parsed считывает конфигурацию из параметра `running_config`, преобразует её в структурированные данные Ansible в соответствии со спецификацией аргумента модуля ресурса, а затем возвращает его в ключе parsed в результате.
state строка			Варианты: merged ← replaced overridden deleted gathered rendered parsed	Состояние конфигурации после завершения работы модуля.

Примечания

Примечание

Тестировалось на NXOS 7.3.(0)D1(1) на VIRL

Примеры

# Using merged

# Before state:
# -------------
#

- name: Merge provided configuration with device configuration.
  cisco.nxos.nxos_lacp_interfaces:
    config:
    - name: Ethernet1/3
      port_priority: 5
      rate: fast
    state: merged

# After state:
# ------------
#
# interface Ethernet1/3
# lacp port-priority 5
# lacp rate fast


# Using replaced

# Before state:
# -------------
#
# interface Ethernet1/3
#   lacp port-priority 5
# interface port-channel11
#   lacp mode delay

- name: Replace device lacp interfaces configuration with the given configuration.
  cisco.nxos.nxos_lacp_interfaces:
    config:
    - name: port-channel11
      links:
        min: 4
    state: replaced

# After state:
# ------------
#
# interface Ethernet1/3
#   lacp port-priority 5
# interface port-channel11
#   lacp min-links 4


# Using overridden

# Before state:
# -------------
#
# interface Ethernet1/3
#   lacp port-priority 5
# interface port-channel11
#   lacp mode delay

- name: Override device configuration of all LACP interfaces attributes of given interfaces
    on device with provided configuration.
  cisco.nxos.nxos_lacp_interfaces:
    config:
    - name: port-channel11
      links:
        min: 4
    state: overridden

# After state:
# ------------
#
# interface port-channel11
# lacp min-links 4


# Using deleted

# Before state:
# -------------
#
# interface Ethernet1/3
#   lacp port-priority 5
# interface port-channel11
#   lacp mode delay

- name: Delete LACP interfaces configurations.
  cisco.nxos.nxos_lacp_interfaces:
    state: deleted

# After state:
# ------------
#

# Using rendered

- name: Use rendered state to convert task input to device specific commands
  cisco.nxos.nxos_lacp_interfaces:
    config:
    - name: Ethernet1/800
      rate: fast
    - name: Ethernet1/801
      rate: fast
      port_priority: 32
    - name: port-channel10
      links:
        max: 15
        min: 2
      convergence:
        graceful: true
    state: rendered

# Task Output (redacted)
# -----------------------

# rendered:
#  - "interface Ethernet1/800"
#  - "lacp rate fast"
#  - "interface Ethernet1/801"
#  - "lacp port-priority 32"
#  - "lacp rate fast"
#  - "interface port-channel10"
#  - "lacp min-links 2"
#  - "lacp max-bundle 15"
#  - "lacp graceful-convergence"

# Using parsed

# parsed.cfg
# ------------

# interface port-channel10
#   lacp min-links 10
#   lacp max-bundle 15
# interface Ethernet1/800
#   lacp port-priority 100
#   lacp rate fast

- name: Use parsed state to convert externally supplied config to structured format
  cisco.nxos.nxos_lacp_interfaces:
    running_config: "{{ lookup('file', 'parsed.cfg') }}"
    state: parsed

# Task output (redacted)
# -----------------------

# parsed:
#   - name: port-channel10
#     links:
#       max: 15
#       min: 10
#   - name: Ethernet1/800
#     port_priority: 100
#     rate: fast

# Using gathered

# Existing device config state
# -------------------------------
# interface Ethernet1/1
#   lacp port-priority 5
#   lacp rate fast
# interface port-channel10
#   lacp mode delay
# interface port-channel11
#   lacp max-bundle 10
#   lacp min-links 5

- name: Gather lacp_interfaces facts from the device using nxos_lacp_interfaces
  cisco.nxos.nxos_lacp_interfaces:
    state: gathered

# Task output (redacted)
# -----------------------
# gathered:
#  - name: Ethernet1/1
#    port_priority: 5
#    rate: fast
#  - name: port-channel10
#    mode: delay
#  - name: port-channel11
#    links:
#      max: 10
#      min: 5

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

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

Ключ	Возвращаемое значение	Описание
after список / элементы=строка	при изменении	Конфигурация в виде структурированных данных после завершения работы модуля. Пример: Возвращаемая конфигурация всегда будет в том же формате, что и параметры выше.
before список / элементы=строка	всегда	Конфигурация в виде структурированных данных до запуска модуля. Пример: Возвращаемая конфигурация всегда будет в том же формате, что и параметры выше.
commands список / элементы=строка	всегда	Набор команд, отправленных на удаленное устройство. Пример: ['interface port-channel10', 'lacp min-links 5', 'lacp mode delay']

Авторы

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/nxos/nxos_lacp_interfaces_module.html