Модуль cisco.nxos.nxos_lacp_interfaces — модуль ресурсов интерфейсов LACP
Примечание
Этот модуль входит в коллекцию cisco.nxos (версия 11.2.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в состав ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install cisco.nxos.
Чтобы использовать этот модуль в плейбуке, укажите: cisco.nxos.nxos_lacp_interfaces.
Добавлено в cisco.nxos 1.0.0
Краткое описание
- Этот модуль управляет атрибутами протокола управления агрегацией каналов (LACP) интерфейсов NX-OS.
Примечание
Этому модулю соответствует модуль действий.
Псевдонимы: lacp_interfaces
Параметры
Параметр | Комментарии |
|---|---|
config list / elements=dictionary | Словарь параметров интерфейсов LACP. |
|
convergence dictionary |
Этот словарь содержит настраиваемые параметры, относящиеся к сходимости. Применимо только к Port-channel. |
|
graceful boolean |
Плавная сходимость LACP для port-channel. Отключайте этот параметр только для портов LACP, подключенных к устройству, отличному от Nexus. Отключение этого параметра при подключении к устройству Nexus может привести к приостановке работы порта. Варианты:
|
|
vpc boolean |
Включить сходимость LACP для каналов vPC port-channel. Варианты:
|
|
links dictionary |
Этот словарь содержит настраиваемые параметры, относящиеся к максимальному и минимальному количеству каналов port-channel. Применимо только к Port-channel. |
|
max integer |
Максимальное количество объединяемых каналов port-channel. |
|
min integer |
Минимальное количество каналов port-channel. |
|
mode string |
Режим LACP. Применимо только к Port-channel. Варианты:
|
|
name string / обязательный |
Имя интерфейса. |
|
port_priority integer |
Приоритет порта LACP для интерфейса. Диапазон: 1–65535. Применимо только к Ethernet. |
|
rate string |
Интервал отправки блоков данных протокола (PDU) протоколом LACP. Применимо только к Ethernet. При быстром режиме LACP передается раз в секунду. При обычном режиме LACP передается каждые 30 секунд после объединения канала. Варианты:
|
|
suspend_individual boolean |
Состояние LACP для port-channel. Отключение этого параметра приведет к тому, что LACP переведет порт в индивидуальное состояние, а не приостановит его, если он не получает LACP BPDU от портов партнера в port-channel. Варианты:
|
running_config string | Этот параметр используется только при состоянии parsed. Значением этого параметра должен быть вывод команды show running-config | section ^interface, выполненной на устройстве NX-OS. При состоянии parsed конфигурация считывается из параметра |
state string | Состояние конфигурации после выполнения модуля. Варианты:
|
Примечания
Примечание
- Проверено на NXOS 7.3.(0)D1(1) в VIRL
- Не поддерживается на Cisco MDS
Примеры
# 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 list / elements=string | Конфигурация в виде структурированных данных после выполнения модуля. Возвращается: при изменении Пример: |
before list / elements=string | Конфигурация в виде структурированных данных до вызова модуля. Возвращается: всегда Пример: |
commands list / elements=string | Набор команд, отправленных на удаленное устройство. Возвращается: всегда Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/cisco/nxos/nxos_lacp_interfaces_module.html