Spec-Zone.ru › Ansible

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

Примечание

Этот модуль является частью коллекции cisco.nxos (версия 8.1.0).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

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

Для использования в playbook, укажите: 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

плавная конвергенция port-channel lacp. Отключите это только с портами lacp, подключенными к не-Nexus-пиру. Отключение этого с пиром Nexus может привести к приостановке порта.

Варианты:

  • false
  • true

vpc

boolean

Включить конвергенцию lacp для каналов портов vPC.

Варианты:

  • false
  • true

links

dictionary

Этот словарь содержит настраиваемые параметры, связанные с максимальным и минимальным количеством каналов портов. Применимо только для Port-channel.

max

integer

Максимальный пакет Port-channel.

min

integer

Минимальное количество каналов Port-channel.

mode

string

Режим LACP. Применимо только для Port-channel.

Варианты:

  • "delay"

name

string / required

Имя интерфейса.

port_priority

integer

Приоритет порта LACP для интерфейса. Диапазон 1-65535. Применимо только для Ethernet.

rate

string

Скорость, с которой PDU отправляются LACP. Применимо только для Ethernet. На высокой скорости LACP передается один раз в секунду. На нормальной скорости LACP передается каждые 30 секунд после объединения ссылки.

Варианты:

  • "fast"
  • "normal"

suspend_individual

boolean

состояние port-channel lacp. Отключение этого приведет к тому, что lacp переведет порт в индивидуальное состояние и не будет приостанавливать порт, если он не получит LACP BPDU от портов-пиров в канале портов.

Варианты:

  • false
  • true

running_config

string

Этот параметр используется только с состоянием parsed.

Значение этого параметра должно быть выводом, полученным от устройства NX-OS путем выполнения команды show running-config | section ^interface.

Состояние parsed считывает конфигурацию из параметра running_config и преобразует её в структурированные данные Ansible в соответствии с argspec модуля ресурса, а затем возвращаемое значение находится в ключе parsed в результате.

state

string

Состояние конфигурации после завершения работы модуля.

Варианты:

  • "merged" ← (по умолчанию)
  • "replaced"
  • "overridden"
  • "deleted"
  • "gathered"
  • "rendered"
  • "parsed"

Примечания

Примечание

  • Тестировалось на 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

список / элементы=строка

Конфигурация в виде структурированных данных после завершения модуля.

Возвращается: при изменении

Пример: ["The configuration returned will always be in the same format\n of the parameters above.\n"]

before

список / элементы=строка

Конфигурация в виде структурированных данных до вызова модуля.

Возвращается: всегда

Пример: ["The configuration returned will always be in the same format\n of the parameters above.\n"]

commands

список / элементы=строка

Набор команд, отправленных на удалённое устройство.

Возвращается: всегда

Пример: ["interface port-channel10", "lacp min-links 5", "lacp mode delay"]

Авторы

  • Trishna Guha (@trishnaguha)

Ссылки на коллекцию

  • Система отслеживания задач
  • Репозиторий (исходный код)

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/nxos/nxos_lacp_interfaces_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API