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

Примечание

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

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

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

Чтобы использовать коллекцию в плейбуке, укажите: cisco.nxos.nxos_lldp_global.

Добавлено в cisco.nxos 1.0.0

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Этот модуль настраивает атрибуты протокола обнаружения канального уровня (LLDP) на платформах NX-OS и управляет ими.

Примечание

Этому модулю соответствует модуль действий.

Псевдонимы: lldp_global

Параметры

Параметр	Комментарии
config словарь	Список параметров конфигурации обнаружения канального уровня
holdtime целое число	Время (в секундах), в течение которого принимающее устройство должно хранить эту информацию
port_id целое число	Этот атрибут определяет, следует ли передавать имена интерфейсов в полном (0) или сокращенном (1) формате. Варианты: `0` `1`
reinit целое число	Время задержки (в секундах) перед инициализацией LLDP на любом интерфейсе
timer целое число	Интервал (в секундах), с которым передаются обновления LLDP
tlv_select словарь	Этот атрибут позволяет указать TLV, которые должны отправляться и приниматься в пакетах LLDP. По умолчанию передаются все TLV.
dcbxp логическое значение	Позволяет указать TLV протокола обмена данными Data Center Bridging Варианты: `false` `true`
management_address словарь	Позволяет указать адрес управления в сообщениях TLV
v4 логическое значение	Адрес управления в TLV v4 Варианты: `false` `true`
v6 логическое значение	Адрес управления в TLV v6 Варианты: `false` `true`
port словарь	Позволяет управлять атрибутами портов в сообщениях TLV
description логическое значение	Позволяет указать TLV с описанием порта Варианты: `false` `true`
vlan логическое значение	Позволяет указать TLV с идентификатором VLAN порта Варианты: `false` `true`
power_management логическое значение	Позволяет указать TLV IEEE 802.3 DTE Power via MDI Варианты: `false` `true`
system словарь	Позволяет управлять атрибутами системы в сообщениях TLV
capabilities логическое значение	Позволяет указать TLV с возможностями системы Варианты: `false` `true`
description логическое значение	Позволяет указать TLV с описанием системы Варианты: `false` `true`
name логическое значение	Позволяет указать TLV с именем системы Варианты: `false` `true`
running_config строка	Этот параметр используется только при состоянии parsed. Значением этого параметра должен быть вывод, полученный от устройства NX-OS при выполнении команды show running-config \| include lldp. Состояние parsed считывает конфигурацию из параметра `running_config` и преобразует ее в структурированные данные Ansible в соответствии со спецификацией аргументов модуля ресурсов; затем значение возвращается в ключе parsed результата.
state строка	Состояние конфигурации после выполнения модуля. Состояния `replaced` и `overridden` работают в этом модуле одинаково. Варианты: `"merged"` ← (по умолчанию) `"replaced"` `"overridden"` `"deleted"` `"gathered"` `"rendered"` `"parsed"`

Примечания

Примечание

Проверено на NxOS 7.3.(0)D1(1) в VIRL
Не поддерживается на Cisco MDS
Перед использованием этого модуля необходимо включить функцию 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: true
        power_management: true
    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 словарь	Конфигурация в виде структурированных данных после выполнения модуля. Возвращается: при изменении Пример: `"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 список / элементы=строка	Набор команд, отправленных на удаленное устройство. Возвращается: всегда Пример: `["lldp holdtime 125", "lldp reinit 4", "no lldp tlv-select system-name"]`

Авторы

Adharsh Srivats Rangarajan (@adharshsrivatsr)

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

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