cisco.nxos.nxos_vtp_domain 模块 – 管理 VTP 域配置。

注意

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

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

要安装它,请使用:ansible-galaxy collection install cisco.nxos

要在 Playbook 中使用它,请指定:cisco.nxos.nxos_vtp_domain

cisco.nxos 1.0.0 中的新增功能

概要

  • 管理 VTP 域配置。

参数

参数

注释

domain

字符串 / 必需

VTP 域名。

注释

注意

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

  • 不支持 Cisco MDS

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

  • 此模块仅用于管理 VTP 域名。

  • VTP 域名区分大小写。

  • 如果之前从未配置过,VTP 版本默认设置为 1。否则,它将保持先前配置的版本不变。使用 cisco.nxos.nxos_vtp_version 来更改它。

  • 将此与 cisco.nxos.nxos_vtp_passwordcisco.nxos.nxos_vtp_version 结合使用,以完全管理 VTP 操作。

  • 有关使用 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 DOMAIN IS CONFIGURED
- cisco.nxos.nxos_vtp_domain:
    domain: ntc
    host: '{{ inventory_hostname }}'
    username: '{{ un }}'
    password: '{{ pwd }}'

返回值

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

描述

changed

布尔值

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

返回:总是

示例: true

end_state

字典

模块执行后 vtp 域的 k/v 对

返回:总是

示例: {"domain": "ntc", "version": "2", "vtp_password": "password"}

existing

字典

现有 vtp 域的 k/v 对

返回:总是

示例: {"domain": "testing", "version": "2", "vtp_password": "password"}

proposed

字典

传递到模块的参数的 k/v 对

返回:总是

示例: {"domain": "ntc"}

updates

列表 / 元素=字符串

发送到设备的命令

返回:总是

示例: ["vtp domain ntc"]

作者

  • Gabriele Gerbino (@GGabriele)