cisco.nxos.nxos_vtp_password 模块 – 管理 VTP 密码配置。

注意

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

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

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

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

cisco.nxos 1.0.0 版本新增

概要

  • 管理 VTP 密码配置。

参数

参数

注释

state

字符串

管理资源的状态

选项

  • "present" ← (默认)

  • "absent"

vtp_password

字符串

VTP 密码

注释

注意

  • 已在 VIRL 上针对 NXOSv 7.3.(0)D1(1) 进行测试

  • 不支持 Cisco MDS

  • 要使用此模块，VTP 功能必须在设备上处于活动状态。

  • 此模块仅用于管理 VTP 密码。

  • 将此模块与 cisco.nxos.nxos_vtp_domain 和 cisco.nxos.nxos_vtp_version 结合使用，以全面管理 VTP 操作。

  • 仅当 VTP 域已存在时，您才可以设置/删除密码。

  • 如果 state=absent 并且未提供 vtp_password，则它将删除当前的 VTP 密码。

  • 如果 state=absent 并且提供了 vtp_password，则建议的 vtp_password 必须与现有的密码匹配才能删除它。

  • 有关使用 CLI 和 NX-API 的信息，请参阅：ref:`NXOS 平台选项指南 <nxos_platform_options>`

  • 有关使用 Ansible 管理网络设备的更多信息，请参阅：ref:`Ansible 网络指南 <network_guide>`

  • 有关使用 Ansible 管理 Cisco 设备的更多信息，请参阅 `Cisco 集成页面 <https://ansible.org.cn/integrations/networks/cisco>`_。

示例

# ENSURE VTP PASSWORD IS SET
- cisco.nxos.nxos_vtp_password:
    state: present
    host: '{{ inventory_hostname }}'
    username: '{{ un }}'
    password: '{{ pwd }}'

# ENSURE VTP PASSWORD IS REMOVED
- cisco.nxos.nxos_vtp_password:
    state: absent
    host: '{{ inventory_hostname }}'
    username: '{{ un }}'
    password: '{{ pwd }}'

返回值

通用返回值记录在 此处，以下是此模块特有的字段

键

描述

changed

布尔值

检查设备上是否进行了更改

返回值： 总是

示例： true

end_state

字典

模块执行后 vtp 的键/值对

返回值： 总是

示例： {"domain": "ntc", "version": "1", "vtp_password": "new_ntc"}

existing

字典

现有 vtp 的键/值对

返回值： 总是

示例： {"domain": "ntc", "version": "1", "vtp_password": "ntc"}

proposed

字典

传递到模块中的参数的键/值对

返回值： 总是

示例： {"vtp_password": "new_ntc"}

updates

列表 / 元素=字符串

发送到设备的命令

返回值： 总是

示例： ["vtp password new_ntc"]

作者

  • Gabriele Gerbino (@GGabriele)