cisco.nxos.nxos_udld_interface 模块 – 管理 UDLD 接口配置参数。

注意

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

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

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

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

cisco.nxos 1.0.0 中的新增功能

概要 

管理 UDLD 接口配置参数。

参数 

参数	注释
interface 字符串 / 必需	接口的全名，例如 Ethernet1/1-
mode 字符串 / 必需	管理接口的 UDLD 模式。选项 `"enabled"` `"disabled"` `"aggressive"`
state 字符串	管理资源的状态。选项 `"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 Ethernet1/1 is configured to be in aggressive mode
- cisco.nxos.nxos_udld_interface:
    interface: Ethernet1/1
    mode: aggressive
    state: present
    host: '{{ inventory_hostname }}'
    username: '{{ un }}'
    password: '{{ pwd }}'

# Remove the aggressive config only if it's currently in aggressive mode and then disable udld (switch default)
- cisco.nxos.nxos_udld_interface:
    interface: Ethernet1/1
    mode: aggressive
    state: absent
    host: '{{ inventory_hostname }}'
    username: '{{ un }}'
    password: '{{ pwd }}'

# ensure Ethernet1/1 has aggressive mode enabled
- cisco.nxos.nxos_udld_interface:
    interface: Ethernet1/1
    mode: enabled
    host: '{{ inventory_hostname }}'
    username: '{{ un }}'
    password: '{{ pwd }}'

返回值 

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

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

作者

Jason Edelman (@jedelman8)