cisco.nxos.nxos_vxlan_vtep (7.0.0) — module

Manages VXLAN Network Virtualization Endpoint (NVE).

| "added in version" 1.0.0 of cisco.nxos"

Authors: Gabriele Gerbino (@GGabriele)

Install collection

Install with ansible-galaxy collection install cisco.nxos:==7.0.0


Add to requirements.yml

  collections:
    - name: cisco.nxos
      version: 7.0.0

Description

Manages VXLAN Network Virtualization Endpoint (NVE) overlay interface that terminates VXLAN tunnels.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- cisco.nxos.nxos_vxlan_vtep:
    interface: nve1
    description: default
    host_reachability: true
    source_interface: Loopback0
    source_interface_hold_down_time: 30
    shutdown: default
    multisite_border_gateway_interface: Loopback0

Inputs

    
state:
    choices:
    - present
    - absent
    default: present
    description:
    - Determines whether the config should be present or not on the device.
    type: str

shutdown:
    description:
    - Administratively shutdown the NVE interface.
    type: bool

interface:
    description:
    - Interface name for the VXLAN Network Virtualization Endpoint.
    required: true
    type: str

description:
    description:
    - Description of the NVE interface.
    type: str

source_interface:
    description:
    - Specify the loopback interface whose IP address should be used for the NVE interface.
    type: str

host_reachability:
    description:
    - Specify mechanism for host reachability advertisement.  A Boolean value of 'true'
      indicates that BGP will be used for host reachability advertisement. A Boolean value
      of 'false' indicates that no protocol is used for host reachability advertisement.
      Other host reachability advertisement protocols (e.g. OpenFlow, controller, etc.)
      are not supported.
    type: bool

global_suppress_arp:
    description:
    - Enables ARP suppression for all VNIs. This is available on NX-OS 9K series running
      9.2.x or higher.
    type: bool

global_mcast_group_L2:
    description:
    - Global multicast IP prefix for L2 VNIs or the keyword 'default'. This is available
      on Nexus 9000 series switches running NX-OS software release 9.2(x) or higher.
    type: str

global_mcast_group_L3:
    description:
    - Global multicast IP prefix for L3 VNIs or the keyword 'default'. This is available
      on Nexus 9000 series switches running NX-OS software release 9.2(x) or higher.
    type: str

advertise_virtual_rmac:
    description:
    - The advertise_virtual_rmac parameter lets BGP to use the VMAC with VIP as next-hop
      when advertising type-2 routes. Should be used together with advertise_pip parameter
      from cisco.nxos.nxos_bgp_address_family module.
    type: bool

global_ingress_replication_bgp:
    description:
    - Configures ingress replication protocol as bgp for all VNIs. This is available on
      Nexus 9000 series switches running NX-OS software release 9.2(x) or higher.
    type: bool

source_interface_hold_down_time:
    description:
    - Suppresses advertisement of the NVE loopback address until the overlay has converged.
    type: str

multisite_border_gateway_interface:
    description:
    - Specify the loopback interface whose IP address should be used for the NVE Multisite
      Border-gateway Interface. This is available on specific Nexus 9000 series switches
      running NX-OS 7.0(3)I7(x) or higher. Specify "default" to remove an existing gateway
      config.
    type: str
    version_added: 1.1.0
    version_added_collection: cisco.nxos

Outputs

commands:
  description: commands sent to the device
  returned: always
  sample:
  - interface nve1
  - source-interface loopback0
  - source-interface hold-down-time 30
  - description simple description
  - shutdown
  - host-reachability protocol bgp
  - multisite border-gateway interface loopback0
  type: list