arista.eos.eos_lldp_global 模块 – LLDP 资源模块

注意

此模块是 arista.eos 集合（版本 10.0.1）的一部分。

如果您正在使用 ansible 包，您可能已经安装了这个集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install arista.eos。

要在 playbook 中使用它，请指定：arista.eos.eos_lldp_global。

arista.eos 1.0.0 中的新增功能

概要

  • 此模块管理 Arista EOS 设备上的全局链路层发现协议 (LLDP) 设置。

参数

参数

注释

config

字典

提供的全局 LLDP 配置。

holdtime

整数

指定在数据包中发送的保持时间（以秒为单位）。

reinit

整数

指定任何接口上 LLDP 初始化延迟时间（以秒为单位）。

timer

整数

指定发送 LLDP 数据包的速率（以秒为单位）。

tlv_select

字典

指定要启用或禁用的 LLDP TLV。

布尔值

启用或禁用链路聚合 TLV。

选项

  • false

  • true

management_address

布尔值

启用或禁用管理地址 TLV。

选项

  • false

  • true

max_frame_size

布尔值

启用或禁用最大帧大小 TLV。

选项

  • false

  • true

port_description

布尔值

启用或禁用端口描述 TLV。

选项

  • false

  • true

system_capabilities

布尔值

启用或禁用系统功能 TLV。

选项

  • false

  • true

system_description

布尔值

启用或禁用系统描述 TLV。

选项

  • false

  • true

system_name

布尔值

启用或禁用系统名称 TLV。

选项

  • false

  • true

running_config

字符串

此选项仅用于状态 *parsed*。

此选项的值应是通过执行命令 **show running-config | section lldp** 从 EOS 设备收到的输出。

状态 *parsed* 从 running_config 选项中读取配置，并根据资源模块的 argspec 将其转换为 Ansible 结构化数据，然后该值将返回到结果中的 *parsed* 键中。

state

字符串

模块完成后配置的状态。

选项

  • "merged" ← (默认)

  • "replaced"

  • "deleted"

  • "rendered"

  • "gathered"

  • "parsed"

注释

注意

  • 已针对 Arista EOS 4.24.6F 进行测试

  • 此模块与 network_cli 连接一起使用。 请参阅 EOS 平台选项。

示例

# Using merged
#
# ------------
# Before State
# ------------
#
# veos# show run | section lldp
# lldp timer 3000
# lldp holdtime 100
# lldp reinit 5
# no lldp tlv-select management-address
# no lldp tlv-select system-description

- name: Merge provided LLDP configuration with the existing configuration
  arista.eos.eos_lldp_global:
    config:
      holdtime: 100
      tlv_select:
        management_address: false
        port_description: false
        system_description: true
    state: merged

# -----------
# After state
# -----------
#
# veos# show run | section lldp
# lldp timer 3000
# lldp holdtime 100
# lldp reinit 5
# no lldp tlv-select management-address
# no lldp tlv-select port-description


# Using replaced
#
# ------------
# Before State
# ------------
#
# veos# show run | section lldp
# lldp timer 3000
# lldp holdtime 100
# lldp reinit 5
# no lldp tlv-select management-address
# no lldp tlv-select system-description

- name: Replace existing LLDP device configuration with provided configuration
  arista.eos.eos_lldp_global:
    config:
      holdtime: 100
      tlv_select:
        management_address: false
        port_description: false
        system_description: true
    state: replaced

# -----------
# After state
# -----------
#
# veos# show run | section lldp
# lldp holdtime 100
# no lldp tlv-select management-address
# no lldp tlv-select port-description


# Using deleted
#
# ------------
# Before State
# ------------
#
# veos# show run | section lldp
# lldp timer 3000
# lldp holdtime 100
# lldp reinit 5
# no lldp tlv-select management-address
# no lldp tlv-select system-description

- name: Delete existing LLDP configurations from the device
  arista.eos.eos_lldp_global:
    state: deleted

# -----------
# After state
# -----------
#
# veos# show run | section ^lldp

# Using rendered:

- name: Use Rendered to convert the structured data to native config
  arista.eos.eos_lldp_global:
    config:
      holdtime: 100
      tlv_select:
        management_address: false
        port_description: false
        system_description: true
    state: rendered

# -----------
# Output
# -----------
#
# rendered:
#   - "lldp holdtime 100"
#   - "no lldp tlv-select management-address"
#   - "no lldp tlv-select port-description"

# Using parsed

# parsed.cfg

# lldp timer 3000
# lldp holdtime 100
# lldp reinit 5
# no lldp tlv-select management-address
# no lldp tlv-select system-description

- name: Use parsed to convert native configs to structured data
  arista.eos.lldp_global:
    running_config: "{{ lookup('file', 'parsed.cfg') }}"
    state: parsed

# -----------
# Output
# -----------

#    parsed:
#      holdtime: 100
#      timer 3000
#      reinit 5
#      tlv_select:
#        management_address: False
#        port_description: False
#        system_description: True

# Using gathered:
# native config:
# lldp timer 3000
# lldp holdtime 100
# lldp reinit 5
# no lldp tlv-select management-address
# no lldp tlv-select system-description


- name: Gather lldp_global facts from the device
  arista.eos.lldp_global:
    state: gathered

# -----------
# Output
# -----------

#    gathered:
#      holdtime: 100
#      timer 3000
#      reinit 5
#      tlv_select:
#        management_address: False
#        port_description: False
#        system_description: True

返回值

常见返回值记录在这里，以下是此模块特有的字段

键

描述

after

字典

模块完成后配置的结构化数据。

返回： 当发生更改时

示例： "返回的配置始终与上面的参数格式相同。\n"

before

字典

模块调用之前配置的结构化数据。

返回： 始终

示例： "返回的配置始终与上面的参数格式相同。\n"

commands

列表 / elements=字符串

推送到远程设备的命令集。

返回： 始终

示例： ["lldp holdtime 100", "no lldp timer", "lldp tlv-select system-description"]

作者

  • Nathaniel Case (@Qalthos)