Spec-Zone.ru › Ansible 2.10

cisco.nxos.nxos_lldp_global – Модуль ресурсов LLDP

Примечание

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

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

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

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

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

Обзор

  • Этот модуль настраивает и управляет атрибутами протокола Link Layer Discovery Protocol (LLDP) на платформах NX-OS.

Примечание

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

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
config
словарь
Список конфигураций протокола Link Layer Discovery Protocol
holdtime
целое число
Время удержания информации принимающим устройством (в секундах)
port_id
целое число
    Варианты:
  • 0
  • 1
Этот атрибут определяет, должны ли имена интерфейсов рекламироваться в длинном (0) или коротком (1) формате.
reinit
целое число
Время ожидания инициализации LLDP на любом интерфейсе (в секундах)
timer
целое число
Частота, с которой необходимо передавать обновления LLDP (в секундах)
tlv_select
словарь
Этот атрибут может использоваться для указания TLV, которые необходимо отправлять и принимать в пакетах LLDP. По умолчанию все TLV рекламируются.
dcbxp
логическое значение
    Варианты:
  • нет
  • да
Используется для указания TLV протокола Data Center Bridging Exchange Protocol
management_address
словарь
Используется для указания управляющего адреса в сообщениях TLV
v4
логическое значение
    Варианты:
  • нет
  • да
Управляющий адрес с TLV v4
v6
логическое значение
    Варианты:
  • нет
  • да
Управляющий адрес с TLV v6
port
словарь
Используется для управления атрибутами порта в сообщениях TLV
description
логическое значение
    Варианты:
  • нет
  • да
Используется для указания TLV описания порта
vlan
логическое значение
    Варианты:
  • нет
  • да
Используется для указания TLV идентификатора VLAN порта
power_management
логическое значение
    Варианты:
  • нет
  • да
Используется для указания мощности IEEE 802.3 DTE через TLV MDI
system
словарь
Используется для управления системными атрибутами в сообщениях TLV
capabilities
логическое значение
    Варианты:
  • нет
  • да
Используется для указания TLV возможностей системы
description
логическое значение
    Варианты:
  • нет
  • да
Используется для указания TLV описания системы
name
логическое значение
    Варианты:
  • нет
  • да
Используется для указания TLV имени системы
running_config
строка
Этот параметр используется только для состояния parsed.
Значение этого параметра должно быть результатом выполнения команды show running-config | include lldp на устройстве NX-OS.
Состояние parsed считывает конфигурацию из параметра running_config, преобразует её в структурированные данные Ansible в соответствии с argspec модуля ресурсов и возвращает значение в ключе parsed результата.
state
строка
    Варианты:
  • слит ←
  • заменён
  • удален
  • собрано
  • отображен
  • разбор
Состояние конфигурации после завершения работы модуля

Примечания

Примечание

  • Тестировано на NxOS 7.3.(0)D1(1) на VIRL
  • Функция LLDP должна быть включена перед использованием этого модуля

Примеры

# Using merged
# Before state:
# -------------
#
# user(config)# show running-config | include lldp
# feature lldp

- name: Merge provided configuration with device configuration
  cisco.nxos.nxos_lldp_global:
    config:
      timer: 35
      holdtime: 100
    state: merged

# After state:
# ------------
#
# user(config)# show running-config | include lldp
# feature lldp
# lldp timer 35
# lldp holdtime 100


# Using replaced
# Before state:
# -------------
#
# user(config)# show running-config | include lldp
# feature lldp
# lldp holdtime 100
# lldp reinit 5
# lldp timer 35

- name: Replace device configuration of specific LLDP attributes with provided configuration
  cisco.nxos.nxos_lldp_global:
    config:
      timer: 40
      tlv_select:
        system:
          description: true
          name: false
        management_address:
          v4: true
    state: replaced

# After state:
# ------------
#
# user(config)# show running-config | include lldp
# feature lldp
# lldp timer 40
# no lldp tlv-select system-name


# Using deleted
# Before state:
# -------------
#
# user(config)# show running-config | include lldp
# feature lldp
# lldp holdtime 5
# lldp reinit 3

- name: Delete LLDP configuration (this will by default remove all lldp configuration)
  cisco.nxos.nxos_lldp_global:
    state: deleted

# After state:
# ------------
#
# user(config)# show running-config | include lldp
# feature lldp

# Using rendered

- name: Use rendered state to convert task input to device specific commands
  cisco.nxos.nxos_lldp_global:
    config:
      holdtime: 130
      port_id: 1
      reinit: 5
      tlv_select:
        dcbxp: yes
        power_management: yes
    state: rendered

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

# rendered:
#   - "lldp tlv-select dcbxp"
#   - "lldp tlv-select power-management"
#   - "lldp portid-subtype 1"
#   - "lldp reinit 5"
#   - "lldp holdtime 130"

# Using parsed

# parsed.cfg
# ------------
# lldp holdtime 131
# lldp reinit 7
# no lldp tlv-select system-name
# no lldp tlv-select system-description

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

# parsed:
#   holdtime: 131
#   reinit: 7
#   tlv_select:
#     system:
#       description: false
#       name: false

# Using gathered

# Existing device config state
# -------------------------------
# feature lldp
# lldp holdtime 129
# lldp reinit 5
# lldp timer 35
# no lldp tlv-select system-name

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

# gathered:
#   reinit: 5
#   timer: 35
#   tlv_select:
#     system:
#       name: False
#   holdtime: 129

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

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

Ключ Возвращаемое значение Описание
after
словарь
при изменении
Конфигурация в структурированных данных после завершения работы модуля.

Пример:
Возвращаемая конфигурация всегда будет в том же формате, что и параметры выше.
before
словарь
всегда
Конфигурация в структурированных данных перед вызовом модуля.

Пример:
Возвращаемая конфигурация всегда будет в том же формате, что и параметры выше.
commands
список / элементы=строка
всегда
Набор команд, отправленных на удалённое устройство.

Пример:
['lldp holdtime 125', 'lldp reinit 4', 'no lldp tlv-select system-name']


Авторы

  • Adharsh Srivats Rangarajan (@adharshsrivatsr)

© 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_lldp_global_module.html

Spec-Zone.ru

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