W3cubDocs

/Ansible

cisco.nxos.nxos_vxlan_vtep_vni module – Creates a Virtual Network Identifier member (VNI)

Note

This module is part of the cisco.nxos collection (version 9.4.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install cisco.nxos.

To use it in a playbook, specify: cisco.nxos.nxos_vxlan_vtep_vni.

New in cisco.nxos 1.0.0

Synopsis

  • Creates a Virtual Network Identifier member (VNI) for an NVE overlay interface.

Parameters

Parameter

Comments

assoc_vrf

boolean

This attribute is used to identify and separate processing VNIs that are associated with a VRF and used for routing. The VRF and VNI specified with this command must match the configuration of the VNI under the VRF.

Choices:

  • false
  • true

ingress_replication

string

Specifies mechanism for host reachability advertisement.

Choices:

  • "bgp"
  • "static"
  • "default"

interface

string / required

Interface name for the VXLAN Network Virtualization Endpoint.

multicast_group

string

The multicast group (range) of the VNI. Valid values are string and keyword ‘default’.

multisite_ingress_replication

string

added in cisco.nxos 1.1.0

Enables multisite ingress replication.

Choices:

  • "disable"
  • "enable"
  • "optimized"

peer_list

list / elements=string

Set the ingress-replication static peer list. Valid values are an array, a space-separated string of ip addresses, or the keyword ‘default’.

state

string

Determines whether the config should be present or not on the device.

Choices:

  • "present" ← (default)
  • "absent"

suppress_arp

boolean

Suppress arp under layer 2 VNI.

Choices:

  • false
  • true

suppress_arp_disable

boolean

Overrides the global ARP suppression config. This is available on NX-OS 9K series running 9.2.x or higher.

Choices:

  • false
  • true

vni

string / required

ID of the Virtual Network Identifier.

Notes

Note

  • Tested against NXOSv 7.3.(0)D1(1) on VIRL
  • Unsupported for Cisco MDS
  • default, where supported, restores params default value.
  • 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 <https://www.ansible.com/integrations/networks/cisco>`_.

Examples

- cisco.nxos.nxos_vxlan_vtep_vni:
    interface: nve1
    vni: 6000
    ingress_replication: default
    multisite_ingress_replication: enable

Return Values

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

Key

Description

commands

list / elements=string

commands sent to the device

Returned: always

Sample: ["interface nve1", "member vni 6000", "multisite ingress-replication"]

Authors

  • Gabriele Gerbino (@GGabriele)

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/nxos/nxos_vxlan_vtep_vni_module.html