junipernetworks.junos.junos_lldp_global – Модуль ресурса LLDP
Примечание
Этот плагин является частью коллекции junipernetworks.junos (версия 1.3.0).
Для его установки используйте: ansible-galaxy collection install junipernetworks.junos.
Для использования в книге задач укажите: junipernetworks.junos.junos_lldp_global.
Добавлено в версии 1.0.0: junipernetworks.junos
Обзор
- Этот модуль управляет атрибутами протокола обнаружения канального уровня (LLDP) на устройствах Juniper JUNOS.
Примечание
У этого модуля есть соответствующий плагин действий.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- ncclient (>=v0.6.4)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| config словарь | Список конфигураций атрибутов протокола обнаружения канального уровня | ||
| address строка | Этот аргумент задает адрес управления из LLDP. | ||
| enabled булево |
| Этот аргумент представляет собой булево значение для включения или отключения LLDP. | |
| hold_multiplier целое число | Укажите количество секунд, в течение которого информация LLDP сохраняется перед удалением. Значение множителя используется в сочетании со значением interval. | ||
| interval целое число | Частота отправки объявлений LLDP (в секундах). | ||
| transmit_delay целое число | Укажите количество секунд, которое устройство ожидает перед отправкой объявлений соседям после внесения изменений в локальную систему. | ||
| running_config строка | Этот параметр используется только со значением состояния parsed. Значение этого параметра должно быть результатом выполнения команды show protocols lldp на устройстве Junos. Состояние parsed считывает конфигурацию из параметра running_config, преобразует её в структурированные данные Ansible, соответствующие argspec модуля ресурса, а затем возвращает значение в ключе parsed в результате. | ||
| state строка |
| Состояние конфигурации после завершения работы модуля. | |
Примечания
Примечание
- Этот модуль требует включения системной службы netconf на удаленном управляемом устройстве.
- Тестировался с vSRX JUNOS версии 18.4R1.
- Этот модуль работает с подключением
netconf. См. варианты платформы Junos OS.
Примеры
# Using merged
# Before state:
# -------------
# user@junos01# # show protocols lldp
#
- name: Merge provided configuration with device configuration
junipernetworks.junos.junos_lldp_global:
config:
interval: 10000
address: 10.1.1.1
transmit_delay: 400
hold_multiplier: 10
state: merged
# After state:
# -------------
# user@junos01# show protocols lldp
# management-address 10.1.1.1;
# advertisement-interval 10000;
# transmit-delay 400;
# hold-multiplier 10;
# Using replaced
# Before state:
# -------------
# user@junos01# show protocols lldp
# management-address 10.1.1.1;
# advertisement-interval 10000;
# transmit-delay 400;
# hold-multiplier 10;
- name: Replace provided configuration with device configuration
junipernetworks.junos.junos_lldp_global:
config:
address: 20.2.2.2
hold_multiplier: 30
enabled: false
state: replaced
# After state:
# -------------
# user@junos01# show protocols lldp
# disable;
# management-address 20.2.2.2;
# hold-multiplier 30;
# Using deleted
# Before state:
# -------------
# user@junos01# show protocols lldp
# management-address 20.2.2.2;
# hold-multiplier 30;
- name: Delete lldp configuration (this will by default remove all lldp configuration)
junipernetworks.junos.junos_lldp_global:
state: deleted
# After state:
# -------------
# user@junos01# # show protocols lldp
#
#
# Using gathered
# Before state:
# ------------
#
# ansible@cm123456tr21# show protocols lldp
# management-address 10.1.1.1;
# advertisement-interval 10000;
# transmit-delay 400;
# hold-multiplier 10;
# interface ge-0/0/1;
# interface ge-0/0/2 {
# disable;
# }
- name: Gather junos lldp_global as in given arguments
junipernetworks.junos.junos_lldp_global:
state: gathered
# Task Output (redacted)
# -----------------------
#
# "gathered": {
# "address": "10.1.1.1",
# "hold_multiplier": 10,
# "interval": 10000,
# "transmit_delay": 400
# }
# After state:
# ------------
#
# ansible@cm123456tr21# show protocols lldp
# management-address 10.1.1.1;
# advertisement-interval 10000;
# transmit-delay 400;
# hold-multiplier 10;
# interface ge-0/0/1;
# interface ge-0/0/2 {
# disable;
# }
# Using rendered
- name: Render platform specific xml from task input using rendered state
junipernetworks.junos.junos_lldp_global:
config:
interval: 10000
address: 10.1.1.1
transmit_delay: 400
hold_multiplier: 10
state: rendered
# Task Output (redacted)
# -----------------------
# "rendered": "<nc:protocols
# xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0">
# <nc:lldp>
# <nc:management-address>10.1.1.1</nc:management-address>
# <nc:advertisement-interval>10000</nc:advertisement-interval>
# <nc:transmit-delay>400</nc:transmit-delay>
# <nc:hold-multiplier>10</nc:hold-multiplier>
# <nc:disable delete="delete"/>
# </nc:lldp>
# </nc:protocols>"
#
# parsed.cfg
# ------------
#
# <?xml version="1.0" encoding="UTF-8"?>
# <rpc-reply message-id="urn:uuid:0cadb4e8-5bba-47f4-986e-72906227007f">
# <configuration changed-seconds="1590139550" changed-localtime="2020-05-22 09:25:50 UTC">
# <protocols>
# <ospf>
# <area>
# <name>0.0.0.0</name>
# <interface>
# <name>ge-0/0/0.0</name>
# </interface>
# </area>
# </ospf>
# <lldp>
# <management-address>10.1.1.1</management-address>
# <advertisement-interval>10000</advertisement-interval>
# <transmit-delay>400</transmit-delay>
# <hold-multiplier>10</hold-multiplier>
# <interface>
# <name>ge-0/0/1</name>
# </interface>
# <interface>
# <name>ge-0/0/2</name>
# <disable/>
# </interface>
# </lldp>
# </protocols>
# </configuration>
# </rpc-reply>
# - name: Convert lldp global config to argspec without connecting to the appliance
# junipernetworks.junos.junos_lldp_global:
# running_config: "{{ lookup('file', './parsed.cfg') }}"
# state: parsed
# Task Output (redacted)
# -----------------------
# "parsed": {
# "address": "10.1.1.1",
# "hold_multiplier": 10,
# "interval": 10000,
# "transmit_delay": 400
# }
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| after словарь | при изменении | Конфигурация в структурированном формате после завершения работы модуля. Пример: Возвращаемая конфигурация всегда будет в том же формате, что и параметры выше. |
| before словарь | всегда | Конфигурация в структурированном формате до вызова модуля. Пример: Возвращаемая конфигурация всегда будет в том же формате, что и параметры выше. |
| commands список / элементы=строка | всегда | Набор команд, отправленных на удалённое устройство. Пример: ['<nc:protocols xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0"> <nc:lldp> <nc:management-address>10.1.1.1</nc:management-address> <nc:advertisement-interval>10000</nc:advertisement-interval> <nc:transmit-delay>400</nc:transmit-delay> <nc:hold-multiplier>10</nc:hold-multiplier> <nc:disable delete="delete"/> </nc:lldp> </nc:protocols>', 'xml 2', 'xml 3'] |
Авторы
- Ganesh Nalawade (@ganeshrn)
© 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/junipernetworks/junos/junos_lldp_global_module.html
