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

Примечание

Этот модуль входит в коллекцию cisco.nxos (версия 8.1.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 dictionary	Список конфигураций обнаружения канального уровня
holdtime integer	Время, в течение которого принимающее устройство должно хранить информацию (в секундах)
port_id integer	Этот атрибут определяет, должны ли имена интерфейсов объявляться в длинной (0) или короткой (1) форме. Варианты: `0` `1`
reinit integer	Время задержки инициализации LLDP на любом интерфейсе (в секундах)
timer integer	Частота, с которой необходимо передавать обновления LLDP (в секундах)
tlv_select dictionary	Этот атрибут можно использовать для указания TLV, которые должны отправляться и приниматься в пакетах LLDP. По умолчанию объявляются все TLV
dcbxp boolean	Используется для указания TLV протокола обмена мостами центров обработки данных Варианты: `false` `true`
management_address dictionary	Используется для указания управляющего адреса в сообщениях TLV
v4 boolean	Управляющий адрес с TLV v4 Варианты: `false` `true`
v6 boolean	Управляющий адрес с TLV v6 Варианты: `false` `true`
port dictionary	Используется для управления атрибутами на основе портов в сообщениях TLV
description boolean	Используется для указания TLV описания порта Варианты: `false` `true`
vlan boolean	Используется для указания TLV идентификатора VLAN порта Варианты: `false` `true`
power_management boolean	Используется для указания TLV IEEE 802.3 DTE Power via MDI Варианты: `false` `true`
system dictionary	Используется для управления атрибутами на основе системы в сообщениях TLV
capabilities boolean	Используется для указания TLV возможностей системы Варианты: `false` `true`
description boolean	Используется для указания TLV описания системы Варианты: `false` `true`
name boolean	Используется для указания TLV имени системы Варианты: `false` `true`
running_config string	Этот параметр используется только с состоянием parsed. Значение этого параметра должно быть выводом, полученным от устройства NX-OS путем выполнения команды show running-config \| include lldp. Состояние parsed считывает конфигурацию из параметра `running_config` и преобразует ее в структурированные данные Ansible в соответствии с argspec модуля ресурса, а затем возвращает значение в ключе parsed в результате.
state string	Состояние конфигурации после завершения работы модуля. Состояния `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

Значения возврата

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

Ключ	Описание
после словарь	Конфигурация в формате структурированных данных после завершения модуля. Возвращается: при изменении Пример: `"The configuration returned will always be in the same format\n of the parameters above.\n"`
перед словарь	Конфигурация в формате структурированных данных до вызова модуля. Возвращается: всегда Пример: `"The configuration returned will always be in the same format\n of the parameters above.\n"`
команды список / элементы=строка	Набор команд, отправленных на удалённое устройство. Возвращается: всегда Пример: `["lldp holdtime 125", "lldp reinit 4", "no lldp tlv-select system-name"]`

Авторы

Adharsh Srivats Rangarajan (@adharshsrivatsr)

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

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