Spec-Zone.ru › Ansible 2.11

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

Примечание

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

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

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

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

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

Обзор

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

Примечание

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

Параметры

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

Примечания

Примечание

  • Проверено на 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/cisco/nxos/nxos_lldp_global_module.html

Spec-Zone.ru

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