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

Примечание

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

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

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

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

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

Обзор

Этот модуль управляет атрибутами протокола агрегирования каналов (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. В режиме fast LACP отправляется один раз в секунду. В нормальном режиме LACP отправляется через 30 секунд после объединения канала.
	suspend_individual логическое значение		Варианты: no yes	Состояние lacp канала. Отключение приведет к тому, что lacp переведет порт в индивидуальное состояние, а не приостанавливает его в случае отсутствия BPDU LACP от портов-партнеров в порту-канале.
running_config строка				Этот параметр используется только со состоянием parsed. Значение этого параметра должно соответствовать выводу с устройства NX-OS, полученному с помощью команды show running-config \| section ^interface. Состояние parsed считывает конфигурацию из параметра `running_config`, преобразует ее в структурированные данные Ansible в соответствии с argspec модуля ресурса и затем возвращает значение в ключе parsed результата.
state строка			Варианты: объединённый ← заменён переопределён удалён собран отображён распарсен	Состояние конфигурации после завершения работы модуля.

Примечания

Примечание

Проверено на 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/cisco/nxos/nxos_lacp_interfaces_module.html