cisco.nxos.nxos_vrf_af module – Manages VRF AF.
Note
This module is part of the cisco.nxos collection (version 8.1.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_vrf_af
.
New in cisco.nxos 1.0.0
Synopsis
Manages VRF AF
Aliases: vrf_af
Parameters
Parameter |
Comments |
---|---|
Address-Family Identifier (AFI). Choices:
|
|
Enable/Disable the EVPN route-target ‘auto’ setting for both import and export target communities. Choices:
|
|
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 |
|
Indicates the direction of the route-target (import|export|both) Choices:
|
|
Defines the route-target itself |
|
Determines whether the route-target with the given direction should be present or not on the device. Choices:
|
|
Determines whether the config should be present or not on the device. Choices:
|
|
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 optionsroute_target_both_auto_evpn
androute_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 <https://www.ansible.com/integrations/networks/cisco>`_.
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 |
Description |
---|---|
commands sent to the device Returned: always Sample: |