cisco.nxos.nxos_vtp_domain_module.rst

cisco.nxos.nxos_vtp_domain

Manages VTP domain configuration.

Version added: 1.0.0

• Synopsis
• Parameters
• Notes
• Examples
• Return Values
• Status

Synopsis

• Manages VTP domain configuration.

Parameters

Parameter	Choices/Defaults	Comments
domain string / required		VTP domain name.

Notes

Note

• Tested against NXOSv 7.3.(0)D1(1) on VIRL
• Unsupported for Cisco MDS
• VTP feature must be active on the device to use this module.
• This module is used to manage only VTP domain names.
• VTP domain names are case-sensible.
• If it's never been configured before, VTP version is set to 1 by default. Otherwise, it leaves the previous configured version untouched. Use :ref:`cisco.nxos.nxos_vtp_version <cisco.nxos.nxos_vtp_version_module>` to change it.
• Use this in combination with :ref:`cisco.nxos.nxos_vtp_password <cisco.nxos.nxos_vtp_password_module>` and :ref:`cisco.nxos.nxos_vtp_version <cisco.nxos.nxos_vtp_version_module>` to fully manage VTP operations.
• For information on using CLI and NX-API see the :ref:`NXOS Platform Options guide <nxos_platform_options>`
• For more information on using Ansible to manage network devices see the :ref:`Ansible Network Guide <network_guide>`
• For more information on using Ansible to manage Cisco devices see the Cisco integration page.

Examples

# ENSURE VTP DOMAIN IS CONFIGURED
- cisco.nxos.nxos_vtp_domain:
    domain: ntc
    host: '{{ inventory_hostname }}'
    username: '{{ un }}'
    password: '{{ pwd }}'

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key	Returned	Description
changed boolean	always	check to see if a change was made on the device Sample: True
end_state dictionary	always	k/v pairs of vtp domain after module execution Sample: {'domain': 'ntc', 'version': '2', 'vtp_password': 'password'}
existing dictionary	always	k/v pairs of existing vtp domain Sample: {'domain': 'testing', 'version': '2', 'vtp_password': 'password'}
proposed dictionary	always	k/v pairs of parameters passed into module Sample: {'domain': 'ntc'}
updates list	always	command sent to the device Sample: ['vtp domain ntc']

Status

Authors

• Gabriele Gerbino (@GGabriele)