cisco.nxos.nxos_vrf_af_module.rst

cisco.nxos.nxos_vrf_af

Manages VRF AF.

Version added: 1.0.0

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

Synopsis

• Manages VRF AF

Parameters

Parameter		Choices/Defaults	Comments
afi string / required		Choices: ipv4 ipv6	Address-Family Identifier (AFI).
route_target_both_auto_evpn boolean		Choices: no yes	Enable/Disable the EVPN route-target 'auto' setting for both import and export target communities.
route_targets list / elements=dictionary			Specify the route-targets which should be imported and/or exported under the AF. This argument accepts a list of dicts that specify the route-target, the direction (import|export|both) and state of each route-target. Default direction is direction=both. See examples.
	direction string	Choices: import export both ←	Indicates the direction of the route-target (import|export|both)
	rt string / required		Defines the route-target itself
	state string	Choices: present ← absent	Determines whether the route-target with the given direction should be present or not on the device.
state string		Choices: present ← absent	Determines whether the config should be present or not on the device.
vrf string / required			Name of the VRF.

Notes

Note

• Tested against NXOSv 7.3.(0)D1(1) on VIRL
• Unsupported for Cisco MDS
• Default, where supported, restores params default value.
• In case of state=absent the address-family configuration will be absent. Therefore the options route_target_both_auto_evpn and route_targets are ignored.
• 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

- cisco.nxos.nxos_vrf_af:
    vrf: ntc
    afi: ipv4
    route_target_both_auto_evpn: true
    state: present
- cisco.nxos.nxos_vrf_af:
    vrf: ntc
    afi: ipv4
    route_targets:
      - rt: '65000:1000'
        direction: import
      - rt: '65001:1000'
        direction: import
- cisco.nxos.nxos_vrf_af:
    vrf: ntc
    afi: ipv4
    route_targets:
      - rt: '65000:1000'
        direction: import
      - rt: '65001:1000'
        state: absent
- cisco.nxos.nxos_vrf_af:
    vrf: ntc
    afi: ipv4
    route_targets:
      - rt: '65000:1000'
        direction: export
      - rt: '65001:1000'
        direction: export
- cisco.nxos.nxos_vrf_af:
    vrf: ntc
    afi: ipv4
    route_targets:
      - rt: '65000:1000'
        direction: export
        state: absent
- cisco.nxos.nxos_vrf_af:
    vrf: ntc
    afi: ipv4
    route_targets:
      - rt: '65000:1000'
        direction: both
        state: present
      - rt: '65001:1000'
        direction: import
        state: present
      - rt: '65002:1000'
        direction: both
        state: absent

Return Values

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

Key	Returned	Description
commands list	always	commands sent to the device Sample: ['vrf context ntc', 'address-family ipv4 unicast']

Status

Authors

• Gabriele Gerbino (@GGabriele)