cisco.nxos.nxos_udld 模块 – 管理 UDLD 全局配置参数。

注意

此模块是 cisco.nxos 集合 (版本 9.2.1) 的一部分。

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

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

要在 playbook 中使用它，请指定： cisco.nxos.nxos_udld。

cisco.nxos 1.0.0 中的新增功能

概要 

管理 UDLD 全局配置参数。

参数 

参数	注释
aggressive 字符串	切换侵略模式。选项 `"enabled"` `"disabled"`
msg_time 字符串	UDLD 数据包的消息时间（秒），或关键字“default”。
reset 布尔值	重置 UDLD 关闭的所有端口的能力。当此参数存在时，“state”参数不能为“absent”。选项 `false` `true`
state 字符串	管理资源的状态。设置为“absent”时，aggressive 和 msg_time 将设置为其默认值。选项 `"present"` ← (默认) `"absent"`

备注 

注意

在 VIRL 上针对 NXOSv 7.3.(0)D1(1) 进行了测试
不支持 Cisco MDS
如果之前未启用 udld 功能，则模块将失败。
有关使用 CLI 和 NX-API 的信息，请参阅：ref:`NXOS 平台选项指南 <nxos_platform_options>`
有关使用 Ansible 管理网络设备的更多信息，请参阅：ref:`Ansible 网络指南 <network_guide>`
有关使用 Ansible 管理 Cisco 设备的更多信息，请参阅 `Cisco 集成页面 <https://ansible.org.cn/integrations/networks/cisco>`_。

示例 

# ensure udld aggressive mode is globally disabled and se global message interval is 20
- cisco.nxos.nxos_udld:
    aggressive: disabled
    msg_time: 20
    host: '{{ inventory_hostname }}'
    username: '{{ un }}'
    password: '{{ pwd }}'

# Ensure agg mode is globally enabled and msg time is 15
- cisco.nxos.nxos_udld:
    aggressive: enabled
    msg_time: 15
    host: '{{ inventory_hostname }}'
    username: '{{ un }}'
    password: '{{ pwd }}'

返回值 

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

键	描述
changed 布尔值	检查设备上是否进行了更改返回值：始终示例： `true`
end_state 字典	模块执行后 udld 配置的键值对返回值：始终示例： `{"aggressive": "enabled", "msg_time": "40"}`
existing 字典	现有 udld 配置的键值对返回值：始终示例： `{"aggressive": "disabled", "msg_time": "15"}`
proposed 字典	传递到模块的参数的键值对返回值：始终示例： `{"aggressive": "enabled", "msg_time": "40"}`
updates 列表 / 元素=字符串	发送到设备的命令返回值：始终示例： `["udld message-time 40", "udld aggressive"]`

作者

Jason Edelman (@jedelman8)