cisco.ios.ios_lldp_global – Модуль ресурсов LLDP
Примечание
Этот плагин является частью коллекции cisco.ios (версия 1.2.1).
Для его установки используйте: ansible-galaxy collection install cisco.ios
Для использования в книге задач укажите: cisco.ios.ios_lldp_global
Новое в версии 1.0.0: коллекции cisco.ios
Обзор
- Этот модуль настраивает и управляет атрибутами протокола Link Layer Discovery Protocol (LLDP) на платформах IOS.
Примечание
У этого модуля есть соответствующий плагин действий.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | ||
|---|---|---|---|---|
| config словарь | Словарь параметров LLDP | |||
| enabled логический |
| Включить LLDP | ||
| holdtime целое число | Время удержания LLDP (в сек), отправляемое в пакетах. См. документацию производителя для допустимых значений. | |||
| reinit целое число | Укажите задержку (в сек) для инициализации LLDP. См. документацию производителя для допустимых значений. ПРИМЕЧАНИЕ. Если LLDP reinit настроен со начальным значением, идемпотентность не будет сохранена, так как устройство Cisco не записывает начальное значение reinit. В связи с этим Ansible не может проверить, настроено ли соответствующее начальное значение reinit на устройстве или нет. Если вы пытаетесь применить начальное значение reinit в каждом запуске задачи, Ansible покажет, что изменения произошли. Для любого другого значения reinit идемпотентность будет сохранена, так как любое другое значение reinit записывается в устройстве Cisco. | |||
| timer целое число | Укажите частоту отправки пакетов LLDP (в сек). См. документацию производителя для допустимых значений. | |||
| tlv_select словарь | Выбор LLDP TLV (type-length-value) для отправки ПРИМЕЧАНИЕ. Если tlv-select настроен, идемпотентность не будет сохранена, так как устройство Cisco не записывает настроенные параметры tlv-select. В связи с этим Ansible не может проверить, настроен ли соответствующий tlv-select на устройстве или нет. Если вы пытаетесь применить параметр tlv-select в каждом запуске задачи, Ansible покажет, что изменения произошли. | |||
| four_wire_power_management логический |
| Cisco 4-проводное управление питанием через MDI TLV | ||
| mac_phy_cfg логический |
| TLV конфигурации/состояния MAC/PHY IEEE 802.3 | ||
| management_address логический |
| TLV адреса управления | ||
| port_description логический |
| TLV описания порта | ||
| port_vlan логический |
| TLV идентификатора VLAN порта | ||
| power_management логический |
| TLV управления питанием DTE IEEE 802.3 через MDI | ||
| system_capabilities логический |
| TLV возможностей системы | ||
| system_description логический |
| TLV описания системы | ||
| system_name логический |
| TLV имени системы | ||
| running_config строка | Этот параметр используется только со состоянием parsed. Значение этого параметра должно быть результатом выполнения команды show running-config | section ^lldp на устройстве IOS. Состояние parsed считывает конфигурацию из параметра running_config и преобразует ее в структурированные данные Ansible, соответствующие параметрам модуля ресурсов, и значение затем возвращается в поле parsed результата. | |||
| state строка |
| Состояние, в котором должна остаться конфигурация Состояния rendered, gathered и parsed не производят никаких изменений на устройстве. Состояние rendered преобразует конфигурацию в параметре config в команды CLI, специфичные для платформы, которые будут возвращены в поле rendered результата. Для состояния rendered активное подключение к удаленному хосту не требуется.Состояние gathered извлечет конфигурацию running с устройства и преобразует ее в структурированные данные в формате, соответствующем параметрам модуля ресурсов, и значение возвращается в поле gathered результата. Состояние parsed считывает конфигурацию из параметра running_config и преобразует ее в формат JSON, соответствующий параметрам модуля ресурсов, и значение возвращается в поле parsed результата. Значение параметра running_config должно соответствовать формату вывода команды show running-config | include ip route|ipv6 route, выполненной на устройстве. Для состояния parsed активное подключение к удаленному хосту не требуется. | ||
Примечания
Примечание
- Тестировалось на Cisco IOSv версии 15.2 на VIRL.
Примеры
# Using merged
# Before state:
# -------------
# vios#sh running-config | section ^lldp
# vios1#
- name: Merge provided configuration with device configuration
cisco.ios.ios_lldp_global:
config:
holdtime: 10
enabled: true
reinit: 3
timer: 10
state: merged
# After state:
# ------------
# vios#sh running-config | section ^lldp
# lldp timer 10
# lldp holdtime 10
# lldp reinit 3
# lldp run
# Using replaced
# Before state:
# -------------
# vios#sh running-config | section ^lldp
# lldp timer 10
# lldp holdtime 10
# lldp reinit 3
# lldp run
- name: Replaces LLDP device configuration with provided configuration
cisco.ios.ios_lldp_global:
config:
holdtime: 20
reinit: 5
state: replaced
# After state:
# -------------
# vios#sh running-config | section ^lldp
# lldp holdtime 20
# lldp reinit 5
# Using Deleted without any config passed
#"(NOTE: This will delete all of configured LLDP module attributes)"
# Before state:
# -------------
# vios#sh running-config | section ^lldp
# lldp timer 10
# lldp holdtime 10
# lldp reinit 3
# lldp run
- name: Delete LLDP attributes
cisco.ios.ios_lldp_global:
state: deleted
# After state:
# -------------
# vios#sh running-config | section ^lldp
# vios1#
# Using Gathered
# Before state:
# -------------
#
# vios#sh running-config | section ^lldp
# lldp timer 10
# lldp holdtime 10
# lldp reinit 3
# lldp run
- name: Gather listed interfaces with provided configurations
cisco.ios.ios_lldp_global:
config:
state: gathered
# Module Execution Result:
# ------------------------
#
# "gathered": {
# "enabled": true,
# "holdtime": 10,
# "reinit": 3,
# "timer": 10
# }
# After state:
# ------------
#
# vios#sh running-config | section ^lldp
# lldp timer 10
# lldp holdtime 10
# lldp reinit 3
# lldp run
# Using Rendered
- name: Render the commands for provided configuration
cisco.ios.ios_lldp_global:
config:
holdtime: 10
enabled: true
reinit: 3
timer: 10
state: rendered
# Module Execution Result:
# ------------------------
#
# "rendered": [
# "lldp holdtime 10",
# "lldp run",
# "lldp timer 10",
# "lldp reinit 3"
# ]
# Using Parsed
# File: parsed.cfg
# ----------------
#
# lldp timer 10
# lldp holdtime 10
# lldp reinit 3
# lldp run
- name: Parse the commands for provided configuration
cisco.ios.ios_lldp_global:
running_config: "{{ lookup('file', 'parsed.cfg') }}"
state: parsed
# Module Execution Result:
# ------------------------
#
# "parsed": {
# "enabled": true,
# "holdtime": 10,
# "reinit": 3,
# "timer": 10
# }
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое | Описание |
|---|---|---|
| after словарь | при изменении | Конфигурация в виде структурированных данных после завершения работы модуля. Пример: Возвращаемая конфигурация всегда будет в том же формате, что и вышеуказанные параметры. |
| before словарь | всегда | Конфигурация в виде структурированных данных до вызова модуля. Пример: Возвращаемая конфигурация всегда будет в том же формате, что и вышеуказанные параметры. |
| commands список / элементы=строка | всегда | Набор команд, отправленных на удаленное устройство Пример: ['lldp holdtime 10', 'lldp run', 'lldp timer 10'] |
Авторы
- Sumit Jaiswal (@justjais)
© 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/ios/ios_lldp_global_module.html