cisco.nxos.nxos_bgp_af (4.4.0) — module

Install collection

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

Add to requirements.yml

  collections:
    - name: cisco.nxos
      version: 4.4.0

Description

Manages BGP Address-family configurations on NX-OS switches.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# configure a simple address-family
- cisco.nxos.nxos_bgp_af:
    asn: 65535
    vrf: TESTING
    afi: ipv4
    safi: unicast
    advertise_l2vpn_evpn: true
    state: present
    retain_route_target: all

Inputs

    
afi:
    choices:
    - ipv4
    - ipv6
    - vpnv4
    - vpnv6
    - l2vpn
    description:
    - Address Family Identifier.
    required: true
    type: str

asn:
    description:
    - BGP autonomous system number. Valid values are String, Integer in ASPLAIN or ASDOT
      notation.
    required: true
    type: str

vrf:
    default: default
    description:
    - Name of the VRF. The name 'default' is a valid VRF representing the global bgp.
    type: str

safi:
    choices:
    - unicast
    - multicast
    - evpn
    description:
    - Sub Address Family Identifier.
    required: true
    type: str

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

networks:
    description:
    - Networks to configure. Valid value is a list of network prefixes to advertise. The
      list must be in the form of an array. Each entry in the array must include a prefix
      address and an optional route-map. For example [['10.0.0.0/16', 'routemap_LA'],
      ['192.168.1.1', 'Chicago'], ['192.168.2.0/24'], ['192.168.3.0/24', 'routemap_NYC']].
    elements: list
    type: list

table_map:
    description:
    - Apply table-map to filter routes downloaded into URIB. Valid values are a string.
    type: str

inject_map:
    description:
    - An array of route-map names which will specify prefixes to inject. Each array entry
      must first specify the inject-map name, secondly an exist-map name, and optionally
      the copy-attributes keyword which indicates that attributes should be copied from
      the aggregate. For example [['lax_inject_map', 'lax_exist_map'], ['nyc_inject_map',
      'nyc_exist_map', 'copy-attributes'], ['fsd_inject_map', 'fsd_exist_map']].
    elements: list
    type: list

redistribute:
    description:
    - A list of redistribute directives. Multiple redistribute entries are allowed. The
      list must be in the form of a nested array. the first entry of each array defines
      the source-protocol to redistribute from; the second entry defines a route-map name.
      A route-map is highly advised but may be optional on some platforms, in which case
      it may be omitted from the array list. For example [['direct', 'rm_direct'], ['lisp',
      'rm_lisp']].
    elements: list
    type: list

distance_ebgp:
    description:
    - Sets the administrative distance for eBGP routes. Valid values are Integer or keyword
      'default'.
    type: str

distance_ibgp:
    description:
    - Sets the administrative distance for iBGP routes. Valid values are Integer or keyword
      'default'.
    type: str

maximum_paths:
    description:
    - Configures the maximum number of equal-cost paths for load sharing. Valid value
      is an integer in the range 1-64.
    type: str

default_metric:
    description:
    - Sets default metrics for routes redistributed into BGP. Valid values are Integer
      or keyword 'default'
    type: str

distance_local:
    description:
    - Sets the administrative distance for local BGP routes. Valid values are Integer
      or keyword 'default'.
    type: str

dampening_state:
    description:
    - Enable/disable route-flap dampening.
    type: bool

client_to_client:
    description:
    - Configure client-to-client route reflection.
    type: bool

table_map_filter:
    description:
    - Filters routes rejected by the route-map and does not download them to the RIB.
    type: bool

dampen_igp_metric:
    description:
    - Specify dampen value for IGP metric-related changes, in seconds. Valid values are
      integer and keyword 'default'.
    type: str

suppress_inactive:
    description:
    - Advertises only active routes to peers.
    type: bool

dampening_routemap:
    description:
    - Specify route-map for route-flap dampening. Valid values are a string defining the
      name of the route-map.
    type: str

maximum_paths_ibgp:
    description:
    - Configures the maximum number of ibgp equal-cost paths for load sharing. Valid value
      is an integer in the range 1-64.
    type: str

next_hop_route_map:
    description:
    - Configure a route-map for valid nexthops. Valid values are a string defining the
      name of the route-map.
    type: str

dampening_half_time:
    description:
    - Specify decay half-life in minutes for route-flap dampening. Valid values are integer
      and keyword 'default'.
    type: str

retain_route_target:
    description:
    - Retains all of the routes or the routes which are part of configured route-map.
      Valid values are route-map names or keyword C(all) or keyword C(default).  C(all)
      retains all the routes regardless of Target-VPN community. C(default) will disable
      the retain route target option. If you are using route-map name please ensure that
      the name is not same as C(all) and C(default).
    type: str
    version_added: 1.1.0
    version_added_collection: cisco.nxos

advertise_l2vpn_evpn:
    description:
    - Advertise evpn routes.
    type: bool

dampening_reuse_time:
    description:
    - Specify route reuse time for route-flap dampening. Valid values are integer and
      keyword 'default'.
    type: str

additional_paths_send:
    description:
    - Enables the send capability of additional paths for all of the neighbors under this
      address family for which the capability has not been disabled.
    type: bool

dampening_suppress_time:
    description:
    - Specify route suppress time for route-flap dampening. Valid values are integer and
      keyword 'default'.
    type: str

additional_paths_install:
    description:
    - Install a backup path into the forwarding table and provide prefix independent convergence
      (PIC) in case of a PE-CE link failure.
    type: bool

additional_paths_receive:
    description:
    - Enables the receive capability of additional paths for all of the neighbors under
      this address family for which the capability has not been disabled.
    type: bool

additional_paths_selection:
    description:
    - Configures the capability of selecting additional paths for a prefix. Valid values
      are a string defining the name of the route-map.
    type: str

dampening_max_suppress_time:
    description:
    - Specify max suppress time for route-flap dampening stable route. Valid values are
      integer and keyword 'default'.
    type: str

default_information_originate:
    description:
    - Default information originate.
    type: bool

Outputs

commands:
  description: commands sent to the device
  returned: always
  sample:
  - router bgp 65535
  - vrf TESTING
  - address-family ipv4 unicast
  - advertise l2vpn evpn
  - retain route-target all
  type: list