модуль dellemc.enterprise_sonic.sonic_lldp_global — управление глобальными конфигурациями LLDP в SONiC

Примечание

Этот модуль входит в коллекцию dellemc.enterprise_sonic (версия 3.2.0).

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

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

Чтобы использовать коллекцию в плейбуке, укажите: dellemc.enterprise_sonic.sonic_lldp_global.

Добавлено в dellemc.enterprise_sonic 2.1.0

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

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

Этот модуль позволяет управлять конфигурацией глобальных параметров LLDP для использования на интерфейсах уровня 2 с поддержкой LLDP устройств под управлением SONiC.
Предназначен для совместного использования с конфигурацией интерфейсов уровня 2 LLDP, применяемой к участвующим интерфейсам.

Параметры

Параметр	Комментарии
config словарь	Набор конфигураций глобальных атрибутов протокола обнаружения канального уровня
enable логическое значение	Этот аргумент принимает логическое значение, включающее или отключающее LLDP. Варианты: `false` `true`
hello_time целое число	Частота отправки объявлений LLDP (в секундах). Диапазон: от 5 до 254 секунд
mode строка	По умолчанию включены передача и прием кадров LLDP. С помощью этой команды можно настроить только прием или только передачу. Варианты: `"receive"` `"transmit"`
multiplier целое число	Значение множителя используется для определения интервала ожидания (т. е. hello-time x значение множителя) Диапазон: от 1 до 10
system_description строка	Описание этой системы для передачи в объявлениях LLDP. Если задано, это значение используется в объявлениях вместо описания системы по умолчанию.
system_name строка	Указание описательного имени системы с помощью этой команды позволяет пользователю проще различать устройства с LLDP. По умолчанию используется имя хоста.
tlv_select словарь	По умолчанию в кадрах LLDP передаются TLV-данные адреса управления и возможностей системы. Этот параметр конфигурации позволяет выборочно отключить отправку этих TLV-данных соседнему устройству.
management_address логическое значение	Включить или отключить TLV-данные адреса управления. Варианты: `false` `true`
system_capabilities логическое значение	Включить или отключить TLV-данные возможностей системы. Варианты: `false` `true`
state строка	Состояние определяет тип обновления конфигурации, выполняемого на устройстве. Если состояние — «merged», указанные атрибуты объединяются с уже настроенными атрибутами. Для состояния «deleted» указанные атрибуты удаляются из существующей конфигурации. Варианты: `"merged"` ← (по умолчанию) `"deleted"`

Примечания

Примечание

Проверено на Enterprise SONiC Distribution от Dell Technologies.
Поддерживает check_mode.

Примеры

# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show running-configuration
# !
# lldp receive
# lldp timer 200
# lldp multiplier 1
# lldp system-name 8999_System
# lldp system-description sonic_system
# !

- name: Delete LLDP configurations
  dellemc.enterprise_sonic.sonic_lldp_global:
    config:
      hello_time: 200
      system_description: sonic_system
      mode: receive
      multiplier: 1
    state: deleted

# After state:
# ------------
# sonic# show running-configuration | grep lldp
# !
# lldp system-name 8999_System
# !
# sonic#


# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show running-configuration | grep lldp
# sonic#

- name: Delete default LLDP configurations
  dellemc.enterprise_sonic.sonic_lldp_global:
    config:
      tlv_select:
        system_capabilities: true
    state: deleted

# After state:
# ------------
# sonic# show running-configuration
# !
# no lldp tlv-select system-capabilities
# !


# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show running-configuration | grep lldp
# !
# lldp receive
# lldp timer 200
# lldp multiplier 1
# lldp system-name 8999_System
# lldp system-description sonic_system
# !

- name: Delete all LLDP configuration
  dellemc.enterprise_sonic.sonic_lldp_global:
    config:
    state: deleted

# After state:  (No LLDP global configuration present.)
# ------------
# sonic# show running-configuration | grep lldp
# sonic#


# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show running-configuration | grep lldp
# sonic#

- name: Modify LLDP configurations
  dellemc.enterprise_sonic.sonic_lldp_global:
    config:
      enable: false
      multiplier: 9
      system_name: CR_sonic
      hello_time: 18
      mode: receive
      system_description: Sonic_System
      tlv_select:
        management_address: true
        system_capabilities: false
    state: merged

# After state:
# ------------
# sonic# show running-configuration | grep lldp
# !
# no lldp enable
# no lldp tlv-select system_capabilities
# lldp receive
# lldp timer 18
# lldp multiplier 9
# lldp system-name CR_sonic
# lldp system-description Sonic_System
# !


# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show running-configuration | grep lldp
# !
# lldp receive
# lldp timer 200
# lldp multiplier 1
# lldp system-name 8999_System
# lldp system-description sonic_system
# !

- name: Modify LLDP configurations
  dellemc.enterprise_sonic.sonic_lldp_global:
    config:
      multiplier: 9
      system_name: CR_sonic
    state: merged

# After state:
# ------------
# sonic# show running-configuration | grep lldp
# !
# lldp receive
# lldp timer 200
# lldp multiplier 9
# lldp system-name CR_sonic
# lldp system-description sonic_system
# !

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

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

Ключ	Описание
after список / элементы=строка	Результирующий вызов модуля конфигурации. Возвращается: при изменении Пример: `["The configuration returned will always be in the same format as the parameters above.\n"]`
after(generated) список / элементы=строка	Сгенерированный вызов модуля конфигурации. Возвращается: когда `check_mode` Пример: `["The configuration returned will always be in the same format as the parameters above.\n"]`
before список / элементы=строка	Конфигурация до вызова модуля. Возвращается: всегда Пример: `["The configuration returned will always be in the same format as the parameters above.\n"]`
commands список / элементы=строка	Набор команд, отправленных на удаленное устройство. Возвращается: всегда Пример: `["command 1", "command 2", "command 3"]`

Авторы

Divya Balasubramanian(@divya-balasubramania)

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

© 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/dellemc/enterprise_sonic/sonic_lldp_global_module.html