cisco_nxos_show_running_config_bgp

Reference path:

ttp://platform/cisco_nxos_show_running_config_bgp.txt

---

Template to parse unique BGP ASNs from Cisco NX-OS configuration.

This template requires output of:

• show running-config bgp

ASNs are collected from the router bgp process and global or VRF remote-as and local-as statements. A peer-template name is used as the description for ASNs configured on a template or on a neighbor that inherits one. local_asn is true for router and local-as ASNs, and false for remote-as ASNs. Results are deduplicated by ASN, preserving the first occurrence and its description while keeping local_asn true if any occurrence marks the ASN as local.

Returns a normalized list of dictionaries with these keys:

• asn - AS number integer
• description - peer-template name or null
• local_asn - boolean indicating ASN belongs to the device

Example normalized output (YAML):

- asn: 65000
  description: null
  local_asn: true
- asn: 64500
  description: TRANSIT
  local_asn: false

---

Template Content

<template name="cisco_nxos_bgp_asn" results="per_template">
<doc>
Template to parse unique BGP ASNs from Cisco NX-OS configuration.

This template requires output of:

- 'show running-config bgp'

ASNs are collected from the 'router bgp' process and global or VRF
'remote-as' and 'local-as' statements. A peer-template name is used as the
description for ASNs configured on a template or on a neighbor that inherits
one. 'local_asn' is true for router and 'local-as' ASNs, and false for
'remote-as' ASNs. Results are deduplicated by ASN, preserving the first
occurrence and its description while keeping 'local_asn' true if any occurrence
marks the ASN as local.

Returns a normalized list of dictionaries with these keys:

- 'asn' - AS number integer
- 'description' - peer-template name or 'null'
- 'local_asn' - boolean indicating ASN belongs to the device

Example normalized output (YAML):

'''yaml
- asn: 65000
  description: null
  local_asn: true
- asn: 64500
  description: TRANSIT
  local_asn: false
'''

</doc>

<input>
commands = [
    "show running-config bgp"
]
platform = [
    "cisco_nxos",
    "nxos",
]
</input>

<macro>
def transform_bgp_asns_to_records(data):
    from ttp_templates.utils.cisco_nxos_process_show_running_config_bgp import transform_bgp_asns

    return transform_bgp_asns(data)
</macro>

<group name="bgp">
router bgp {{ router_asn | _start_ | to_int | let("local_asn", True) }}

  <group name="peers*">
  template peer {{ neighbor | _start_ | let("is_peer_group", True) }}
  neighbor {{ neighbor | _start_ | let("is_peer_group", False) }}
    inherit peer {{ peer_group }}

    <group name="asns*">
    remote-as {{ asn | _start_ | to_int | let("local_asn", False) }}
    local-as {{ asn | _start_ | to_int | let("local_asn", True) }} {{ local_as_options | ORPHRASE }}
    local-as {{ asn | _start_ | to_int | let("local_asn", True) }}
    </group>
  </group>

  <group name="vrfs*">
  vrf {{ vrf | _start_ }}

    <group name="local_asns*">
    local-as {{ asn | _start_ | to_int | let("local_asn", True) }} {{ local_as_options | ORPHRASE }}
    local-as {{ asn | _start_ | to_int | let("local_asn", True) }}
    </group>

    <group name="peers*">
    template peer {{ neighbor | _start_ | let("is_peer_group", True) }}
    neighbor {{ neighbor | _start_ | let("is_peer_group", False) }}
      inherit peer {{ peer_group }}

      <group name="asns*">
      remote-as {{ asn | _start_ | to_int | let("local_asn", False) }}
      local-as {{ asn | _start_ | to_int | let("local_asn", True) }} {{ local_as_options | ORPHRASE }}
      local-as {{ asn | _start_ | to_int | let("local_asn", True) }}
      </group>
    </group>
  </group>
</group>

<output macro="transform_bgp_asns_to_records"/>

</template>