cisco.iosxr.iosxr_bgp_templates 模块 – 管理 BGP 模板资源模块。

注意

此模块是 cisco.iosxr 集合（版本 10.2.2）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install cisco.iosxr。

要在 playbook 中使用它，请指定：cisco.iosxr.iosxr_bgp_templates。

cisco.iosxr 6.0.0 中的新增功能

概要 

此模块配置和管理 Cisco IOS-XR 平台上 BGP 模板的属性。

参数 

参数	注释
config 字典	BGP 模板配置。
as_number 字符串	自治系统编号。
neighbor 列表 / 元素=字典	BGP 邻居组配置的列表。
address_family 列表 / 元素=字典	启用地址族并进入其配置模式
advertise 字典	每个邻居的通告选项
local_labeled_route 字典	通告具有本地标签的路由
disable 布尔值	禁用本地标签路由选项 `false` `true`
set 布尔值	设置本地标签路由选项 `false` `true`
permanent_network 布尔值	允许此邻居的永久网络选项 `false` `true`
afi 字符串	地址族。选项 `"ipv4"` `"ipv6"` `"vpnv4"` `"vpnv6"` `"link-state"` `"l2vpn"`
aigp 字典	AIGP 属性
disable 布尔值	忽略 AIGP 属性。选项 `false` `true`
send_cost_community_disable 布尔值	发送 AIGP 属性。选项 `false` `true`
send_med 字典	发送 MED 选项。
disable 布尔值	禁用在 MED 中发送 AIGP 值。选项 `false` `true`
set 布尔值	在 MED 中设置 AIGP 值。选项 `false` `true`
set 布尔值	设置 AIGP 属性。选项 `false` `true`
allowas_in 字典	允许 AS 路径中存在我的 AS。
set 布尔值	设置 allowas_in 选项 `false` `true`
value 整数	AS 编号出现的次数 1-10。
as_override 字典	发送更新时覆盖匹配的 AS 编号
inheritance_disable 布尔值	防止从父级继承 as-override。选项 `false` `true`
set 布尔值	设置 as_override 选项 `false` `true`
bestpath_origin_as_allow_invalid 布尔值	更改默认路由选择条件。允许 BGP 原始 AS 旋钮。选项 `false` `true`
capability_orf_prefix 字符串	将地址前缀 ORF 功能通告给此邻居。选项 `"both"` `"send"` `"none"` `"receive"`
default_originate 字典	向此邻居发起默认路由。
inheritance_disable 布尔值	防止从父级继承 default-originate。选项 `false` `true`
route_policy 字符串	指定发起默认路由标准的路由策略
set 布尔值	设置默认路由。选项 `false` `true`
encapsulation_type_srv6 布尔值	指定封装类型选项 `false` `true`
long_lived_graceful_restart 字典	启用长期优雅重启支持。
capable 布尔值	将邻居视为 LLGR 功能邻居。选项 `false` `true`
stale_time 字典	清除长期过时路由之前等待的最长时间。
accept 整数	最大接受时间
send 整数	最大发送时间
maximum_prefix 字典	从此对等方接受的最大前缀数。
discard_extra_paths 布尔值	超出限制时丢弃额外的路径。选项 `false` `true`
max_limit 整数	最大前缀限制。<1-4294967295。
restart 整数	重启时间间隔。
threshold_value 整数	生成警告消息的阈值 (%) <1-100>。
warning_only 布尔值	超出限制时仅给出警告消息。选项 `false` `true`
multipath 布尔值	来自此邻居的路径符合多路径条件。选项 `false` `true`
next_hop_self 字典	禁用此邻居的下一跳计算。
inheritance_disable 布尔值	防止从父级继承 next_hop_self。选项 `false` `true`
set 布尔值	设置下一跳自身。选项 `false` `true`
next_hop_unchanged 字典	禁用此邻居的下一跳计算。
inheritance_disable 布尔值	防止从父级继承 next_hop_unchanged。选项 `false` `true`
multipath 布尔值	在通告多路径之前不要覆盖下一跳。选项 `false` `true`
set 布尔值	设置下一跳不变。选项 `false` `true`
optimal_route_reflection_group_name 字符串	配置最佳路由反射组。
orf_route_policy 字符串	指定 ORF 和入站过滤条件。
origin_as 字典	BGP 原始 AS 旋钮。
validation 字典	BGP 原始 AS 验证旋钮。
disable 布尔值	禁用 RPKI 原始 AS 验证。选项 `false` `true`
remove_private_AS 字典	从出站更新中删除专用 AS 编号。
entire_aspath 布尔值	仅当路径中的所有 AS 都是专用时才删除。选项 `false` `true`
inbound 布尔值	从入站更新中删除专用 AS 编号。选项 `false` `true`
inheritance_disable 布尔值	防止从父级继承 remove-private-AS。选项 `false` `true`
set 布尔值	设置删除专用 AS。选项 `false` `true`
route_policy 字典	将路由策略应用于邻居。
inbound 字符串	将路由策略应用于入站路由。
outbound 字符串	将路由策略应用于出站路由。
route_reflector_client 字典	将邻居配置为路由反射器客户端。
inheritance_disable 布尔值	防止从父级继承 route-reflector-client。选项 `false` `true`
set 布尔值	设置路由反射器客户端。选项 `false` `true`
safi 字符串	地址族修饰符选项 `"flowspec"` `"mdt"` `"multicast"` `"mvpn"` `"rt-filter"` `"tunnel"` `"unicast"` `"labeled-unicast"` `"sr-policy"` `"link-state"` `"evpn"` `"mspw"` `"vpls-vpws"`
send_community_ebgp 字典	将社区属性发送到此外部邻居。
inheritance_disable 布尔值	防止从父级继承 send_community_ebgp。选项 `false` `true`
set 布尔值	设置 send_community_ebgp。选项 `false` `true`
send_community_gshut_ebgp 字典	允许将 g-shut 社区发送到此外部邻居。
inheritance_disable 布尔值	防止从父级继承 send_community_gshut_ebgp。选项 `false` `true`
set 布尔值	设置 send_community_gshut_ebgp。选项 `false` `true`
send_extended_community_ebgp 字典	将扩展社区属性发送到此外部邻居。
inheritance_disable 布尔值	防止从父级继承 send_extended_community_ebgp。选项 `false` `true`
set 布尔值	设置 send_extended_community_ebgp。选项 `false` `true`
send_multicast_attributes 字典	将多播属性发送到此邻居。
disable 布尔值	禁用发送多播属性。选项 `false` `true`
set 布尔值	设置 send_multicast_attributes。选项 `false` `true`
signalling 字典	要禁用的信令协议，BGP 或 LDP
bgp_disable 布尔值	选择要禁用的 BGP 选项 `false` `true`
ldp_disable 布尔值	选择要禁用的 LDP 选项 `false` `true`
soft_reconfiguration 字典	每个邻居的软重配置。
inbound 字典	入站软重配置
always 布尔值	允许此邻居的入站软重配置。始终使用软重配置，即使支持路由刷新。选项 `false` `true`
inheritance_disable 布尔值	防止从父级继承 soft_reconfiguration。选项 `false` `true`
set 布尔值	设置入站选项 `false` `true`
update 字典	update
out_originator_loopcheck_disable 布尔值	禁用发起者环路检查选项 `false` `true`
out_originator_loopcheck_set 布尔值	设置发起者环路检查选项 `false` `true`
use 字符串	从此地址族的 af-group 继承配置。
weight 整数	设置来自此邻居的路由的默认权重。
advertisement_interval 整数	发送 BGP 路由更新之间的最小间隔。示例：<0-600>。
bfd 字典	配置 BFD 参数。
fast_detect 字典	启用快速检测
disable 布尔值	防止 BFD 设置从父级继承。选项 `false` `true`
set 布尔值	设置快速检测选项 `false` `true`
strict_mode 布尔值	保持邻居会话直到 BFD 会话启动选项 `false` `true`
minimum_interval 整数	指定邻居的 BFD 会话的最小间隔值。
multiplier 整数	指定邻居的 BFD 会话的乘数值。
bmp_activate 字典	为此邻居启用 BMP 日志记录。
server 整数	启用与特定服务器的 BMP 连接。示例：<1-8>。
capability 字典	向对等体通告能力。
additional_paths 字典	BGP 附加路径命令。
receive 字典	附加路径接收能力
disable 布尔值	设置接收能力选项 `false` `true`
set 布尔值	设置接收能力选项 `false` `true`
send 字典	附加路径发送能力
disable 布尔值	设置发送能力选项 `false` `true`
set 布尔值	设置发送能力选项 `false` `true`
suppress 字典	禁止向对等体通告能力。
all 字典	所有能力
inheritance_disable 布尔值	不要从父组继承此配置。选项 `false` `true`
set 布尔值	设置全部。选项 `false` `true`
four_byte_AS 字典	4 字节 AS 能力
set 布尔值	设置 4 字节 AS。选项 `false` `true`
cluster_id 字符串	充当路由反射器的此路由器的集群 ID。
description 字符串	邻居特定描述。
dmz_link_bandwidth 字典	传播 DMZ 链路带宽。
inheritance_disable 布尔值	不要从父组继承此配置。选项 `false` `true`
set 布尔值	设置 dmz-link-bandwidth。选项 `false` `true`
dscp 字符串	设置 IP DSCP（DiffServ 代码点）。有关有效条目，请参阅供应商文档。
ebgp_multihop 字典	允许不在直接连接网络上的 EBGP 邻居。
mpls 布尔值	禁用 BGP MPLS 转发。选项 `false` `true`
value 整数	最大跳数。示例：<1-255>。
ebgp_recv_extcommunity_dmz 字典	从 ebgp 邻居接收 extcommunity dmz 链路带宽。
inheritance_disable 布尔值	防止 ebgp-recv-community-dmz 从父级继承选项 `false` `true`
set 布尔值	设置 ebgp-recv-community-dmz。选项 `false` `true`
ebgp_send_extcommunity_dmz 字典	从 ebgp 邻居发送 extcommunity dmz 链路带宽。
cumulatie 布尔值	将所有多路径的累积 community dmz 链路带宽发送到 ebgp 邻居。选项 `false` `true`
inheritance_disable 布尔值	防止 ebgp-send-community-dmz 从父级继承选项 `false` `true`
set 布尔值	设置 ebgp-send-community-dmz。选项 `false` `true`
egress_engineering 字典	为此邻居启用出口对等工程。
inheritance_disable 布尔值	防止出口工程从父级继承选项 `false` `true`
set 布尔值	设置出口工程。选项 `false` `true`
enforce_first_as 字典	强制执行 EBGP 路由的第一个 AS
disable 布尔值	禁用强制执行第一个 AS 选项 `false` `true`
graceful_maintenance 字典	优雅维护的属性。这将导致邻居不优先选择来自此路由器的路由，而选择备用路由。这允许路由器优雅地投入或退出服务。
activate 字典	当在此处或在路由器 bgp 配置下激活时，路由将使用优雅维护属性进行通告。
inheritance_disable 布尔值	防止激活从父级继承。选项 `false` `true`
set 布尔值	激活。选项 `false` `true`
as_prepends 字典	将本地 AS 号预先添加到路由的 AS 路径的次数。默认值 = 0
inheritance_disable 布尔值	防止 as 预先添加从父级继承。选项 `false` `true`
value 整数	as 预先添加的值范围。示例：<0-6>。
local_preference 字典	用于向 ibgp 邻居通告路由的本地首选项。默认值 = 无触摸
inheritance_disable 布尔值	防止本地首选项从父级继承。选项 `false` `true`
value 整数	本地首选项的值范围。示例：<0-4294967295>。
set 布尔值	设置优雅维护。选项 `false` `true`
graceful_restart 字典	为此邻居启用优雅重启支持。
restart_time 整数	以秒为单位通告给邻居的重启时间 <1-4095>。
stalepath_time 整数	等待 GR 功能对等体重启的最大时间（以秒为单位）<1-4095>。
idle_watch_time 整数	等待删除空闲状态动态对等体的最大时间。
ignore_connected_check 字典	绕过单跳 eBGP 对等连接的直接连接下一跳检查
inheritance_disable 布尔值	防止 ignore-connected-check 从父级继承选项 `false` `true`
set 布尔值	设置 ignore-connected-check。选项 `false` `true`
internal_vpn_client 布尔值	在 VPN 核心中保留 ATTR_SET 中的 iBGP CE 邻居路径。选项 `false` `true`
keychain 字典	设置基于密钥链的身份验证。
inheritance_disable 布尔值	防止密钥链从父级继承。选项 `false` `true`
name 字符串	密钥链的名称 - 最多 32 个字符。
local 字典	配置本地参数
address 字典	IPv4 地址
inheritance_disable 布尔值	防止本地地址从父级继承。选项 `false` `true`
ipv4_address 字符串	IPv4 地址 <A.B.C.D>。
local_address_subnet 字符串	路由更新的本地地址子网
local_as 字典	指定本地 AS 号。
inheritance_disable 布尔值	防止本地 AS 从父级继承。选项 `false` `true`
no_prepend 字典	不要将本地 AS 预先添加到来自此邻居的通告中。
replace_as 字典	仅将本地 AS 预先添加到对此邻居的通告中。
dual_as 布尔值	双 AS 模式。选项 `false` `true`
set 布尔值	仅将本地 AS 预先添加到对此邻居的通告中。选项 `false` `true`
set 布尔值	不要将本地 AS 预先添加到来自此邻居的通告中。选项 `false` `true`
value 整数	2 字节、4 字节 AS 号
log 字典	记录每个邻居的更新消息。
log_message 字典	记录每个邻居的更新/通知消息。
in 字典	入站日志消息
disable 布尔值	禁用入站消息日志记录。选项 `false` `true`
inheritance_disable 布尔值	防止消息日志从父级继承。选项 `false` `true`
value 整数	消息日志缓冲区大小的范围 <1-100>。
out 字典	出站日志消息
disable 布尔值	禁用入站消息日志记录。选项 `false` `true`
inheritance_disable 布尔值	防止消息日志从父级继承。选项 `false` `true`
value 整数	消息日志缓冲区大小的范围 <1-100>。
maximum_peers 整数	最大动态邻居数 <1-4095>。
name 字符串	邻居组的名称。
password 字典	设置密码。
encrypted 字符串	指定将遵循加密的密码。
inheritance_disable 布尔值	防止密码从父级继承。选项 `false` `true`
peer_set 整数	将此邻居分配给用于出口对等工程的对等集 <1-255>。
precedence 字符串	设置优先级选项 `"critical"` `"flash"` `"flash-override"` `"immediate"` `"internet"` `"network"` `"priority"` `"routine"`
receive_buffer_size 整数	设置套接字和 BGP 接收缓冲区大小。示例 <512-131072>。
remote_as 整数	邻居自治系统。
remote_as_list 字符串	远程 as-list 配置
send_buffer_size 整数	设置套接字和 BGP 发送缓冲区大小。示例 <4096-131072>。
session_open_mode 字符串	使用此 TCP 打开模式建立 BGP 会话。选项 `"active-only"` `"both"` `"passive-only"`
shutdown 字典	以管理方式关闭此邻居。
inheritance_disable 布尔值	防止关闭从父级继承选项 `false` `true`
set 布尔值	关闭。选项 `false` `true`
tcp 字典	TCP 会话配置命令。
mss 字典	最大分段大小。
inheritance_disable 布尔值	防止 mss 从父级继承选项 `false` `true`
value 整数	TCP 初始最大分段大小。
timers 字典	BGP 每个邻居计时器。
holdtime 整数	保持时间 <3-65535> 或 0 禁用保持时间。
keepalive_time 整数	keepalive 间隔 <0-65535>。
min_holdtime 整数	邻居的最小可接受保持时间 <3-65535>。
ttl_security 字典	启用 EBGP TTL 安全性。
inheritance_disable 布尔值	防止 ttl-security 从父级继承选项 `false` `true`
set 布尔值	设置 ttl-security 选项 `false` `true`
update 字典	BGP 更新配置。
in 字典	入站更新消息处理。
filtering 字典	入站更新消息过滤
attribute_filter 字典	属性过滤器配置。
group 字符串	组的名称。
logging 字典	更新过滤系统日志消息。
disable 布尔值	禁用更新过滤系统日志消息。选项 `false` `true`
update_message 字典	已过滤的更新消息。
buffers 整数	存储已过滤更新消息的缓冲区数量。
update_source 字符串	路由更新的来源。有关有效值，请参阅供应商文档。
use 字典	使用邻居组和会话组模板。
neighbor_group 字符串	从邻居组继承配置。
session_group 字符串	从会话组继承地址族无关配置
running_config 字符串	此选项仅与状态 parsed 一起使用。此选项的值应为通过执行命令 show running-config router bgp 从 Iosxr 设备接收的输出。状态 parsed 从 `running_config` 选项读取配置，并根据资源模块的 argspec 将其转换为 Ansible 结构化数据，然后该值在结果的 parsed 键中返回。
state 字符串	配置应保留的状态。选项 `"deleted"` `"merged"` ← (默认) `"overridden"` `"replaced"` `"gathered"` `"rendered"` `"parsed"`

注释 

注意

此模块与连接 network_cli 一起使用。

示例 

# Using merged
# Before state:
# -------------
# RP/0/RP0/CPU0:10#show running-config router bgp
# Thu Mar 23 10:00:12.668 UTC
# % No such configuration item(s)
#
# RP/0/RP0/CPU0:10#

- name: Merge the provided configuration with the existing running configuration
  cisco.iosxr.iosxr_bgp_templates:
    config:
      as_number: 65536
      neighbor:
        - address_family:
            - advertise:
                local_labeled_route:
                  set: true
              afi: ipv4
              safi: unicast
          advertisement_interval: 10
          bfd:
            fast_detect:
              strict_mode: true
          internal_vpn_client: true
          name: neighbor-group1
          precedence: critical
        - cluster_id: '1'
          description: neighbor-group2
          dmz_link_bandwidth:
            set: true
          ebgp_multihop:
            value: 255
          egress_engineering:
            set: true
          graceful_maintenance:
            as_prepends:
              value: 0
            set: true
          ignore_connected_check:
            set: true
          internal_vpn_client: true
          local:
            address:
              inheritance_disable: true
          local_as:
            value: 6
          name: neighbor-group2
          precedence: flash
          receive_buffer_size: 512
          send_buffer_size: 4096
          session_open_mode: both
          tcp:
            mss:
              inheritance_disable: true
          ttl_security:
            set: true
          update_source: Loopback919
    state: merged

# Task Output
# -----------
# before: {}
# commands:
# - router bgp 65536
# - neighbor-group neighbor-group1
# - advertisement-interval 10
# - bfd fast-detect strict-mode
# - internal-vpn-client
# - precedence critical
# - address-family ipv4 unicast
# - advertise local-labeled-route
# - neighbor-group neighbor-group2
# - dmz-link-bandwidth
# - description neighbor-group2
# - cluster-id 1
# - ebgp-multihop 255
# - egress-engineering
# - internal-vpn-client
# - ignore-connected-check
# - local-as 6
# - local address inheritance-disable
# - precedence flash
# - receive-buffer-size 512
# - send-buffer-size 4096
# - session-open-mode both
# - tcp mss inheritance-disable
# - update-source Loopback919
# - ttl-security
# - graceful-maintenance
# - graceful-maintenance as-prepends 0
# after:
#   as_number: '65536'
#   neighbor:
#     - address_family:
#         - advertise:
#             local_labeled_route:
#               set: true
#           afi: ipv4
#           safi: unicast
#       advertisement_interval: 10
#       bfd:
#         fast_detect:
#           strict_mode: true
#       internal_vpn_client: true
#       name: neighbor-group1
#       precedence: critical
#     - cluster_id: '1'
#       description: neighbor-group2
#       dmz_link_bandwidth:
#         set: true
#       ebgp_multihop:
#         value: 255
#       egress_engineering:
#         set: true
#       graceful_maintenance:
#         as_prepends:
#           value: 0
#         set: true
#       ignore_connected_check:
#         set: true
#       internal_vpn_client: true
#       local:
#         address:
#           inheritance_disable: true
#       local_as:
#         value: 6
#       name: neighbor-group2
#       precedence: flash
#       receive_buffer_size: 512
#       send_buffer_size: 4096
#       session_open_mode: both
#       tcp:
#         mss:
#           inheritance_disable: true
#       ttl_security:
#         set: true
#       update_source: Loopback919

# After state:
# ------------
# RP/0/RP0/CPU0:10#show running-config router bgp
# Thu Mar 23 10:14:33.116 UTC
# router bgp 65536
#  neighbor-group neighbor-group1
#   bfd fast-detect strict-mode
#   precedence critical
#   advertisement-interval 10
#   internal-vpn-client
#   address-family ipv4 unicast
#    advertise local-labeled-route
#   !
#  !
#  neighbor-group neighbor-group2
#   ebgp-multihop 255
#   egress-engineering
#   precedence flash
#   graceful-maintenance
#    as-prepends 0
#   !
#   tcp mss inheritance-disable
#   local-as 6
#   cluster-id 1
#   dmz-link-bandwidth
#   description neighbor-group2
#   ttl-security
#   local address inheritance-disable
#   update-source Loopback919
#   ignore-connected-check
#   session-open-mode both
#   send-buffer-size 4096
#   receive-buffer-size 512
#   internal-vpn-client
#  !
# !


# Using replaced
# Before state:
# ------------
# RP/0/RP0/CPU0:10#show running-config router bgp
# Thu Mar 23 10:14:33.116 UTC
# router bgp 65536
#  neighbor-group neighbor-group1
#   bfd fast-detect strict-mode
#   precedence critical
#   advertisement-interval 10
#   internal-vpn-client
#   address-family ipv4 unicast
#    advertise local-labeled-route
#   !
#  !
#  neighbor-group neighbor-group2
#   ebgp-multihop 255
#   egress-engineering
#   precedence flash
#   graceful-maintenance
#    as-prepends 0
#   !
#   tcp mss inheritance-disable
#   local-as 6
#   cluster-id 1
#   dmz-link-bandwidth
#   description neighbor-group2
#   ttl-security
#   local address inheritance-disable
#   update-source Loopback919
#   ignore-connected-check
#   session-open-mode both
#   send-buffer-size 4096
#   receive-buffer-size 512
#   internal-vpn-client
#  !
# !

- name: Replaced given bgp_templates configuration
  cisco.iosxr.iosxr_bgp_templates:
    config:
      as_number: 65536
      neighbor:
        - address_family:
            - advertise:
                local_labeled_route:
                  set: true
              afi: ipv4
              safi: unicast
          advertisement_interval: 12
          name: neighbor-group1
          precedence: flash
        - cluster_id: '2'
          description: replace neighbor-group2
          ebgp_multihop:
            value: 254
          graceful_maintenance:
            as_prepends:
              value: 2
            set: true
          update_source: Loopback917
          name: neighbor-group2
    state: replaced

# Task Output
# -----------
# before:
#   as_number: '65536'
#   neighbor:
#     - address_family:
#         - advertise:
#             local_labeled_route:
#               set: true
#           afi: ipv4
#           safi: unicast
#       advertisement_interval: 10
#       bfd:
#         fast_detect:
#           strict_mode: true
#       internal_vpn_client: true
#       name: neighbor-group1
#       precedence: critical
#     - cluster_id: '1'
#       description: neighbor-group2
#       dmz_link_bandwidth:
#         set: true
#       ebgp_multihop:
#         value: 255
#       egress_engineering:
#         set: true
#       graceful_maintenance:
#         as_prepends:
#           value: 0
#         set: true
#       ignore_connected_check:
#         set: true
#       internal_vpn_client: true
#       local:
#         address:
#           inheritance_disable: true
#       local_as:
#         value: 6
#       name: neighbor-group2
#       precedence: flash
#       receive_buffer_size: 512
#       send_buffer_size: 4096
#       session_open_mode: both
#       tcp:
#         mss:
#           inheritance_disable: true
#       ttl_security:
#         set: true
#       update_source: Loopback919
# commands:
# - router bgp 65536
# - neighbor-group neighbor-group1
# - no bfd fast-detect strict-mode
# - no internal-vpn-client
# - advertisement-interval 12
# - precedence flash
# - neighbor-group neighbor-group2
# - no dmz-link-bandwidth
# - no egress-engineering
# - no internal-vpn-client
# - no ignore-connected-check
# - no local-as 6
# - no local address inheritance-disable
# - no precedence flash
# - no receive-buffer-size 512
# - no send-buffer-size 4096
# - no session-open-mode both
# - no tcp mss inheritance-disable
# - no ttl-security
# - description replace neighbor-group2
# - cluster-id 2
# - ebgp-multihop 254
# - update-source Loopback917
# - graceful-maintenance as-prepends 2
# after:
#   as_number: '65536'
#   neighbor:
#     - address_family:
#         - advertise:
#             local_labeled_route:
#               set: true
#           afi: ipv4
#           safi: unicast
#       advertisement_interval: 12
#       name: neighbor-group1
#       precedence: flash
#     - cluster_id: '2'
#       description: replace neighbor-group2
#       ebgp_multihop:
#         value: 254
#       graceful_maintenance:
#         as_prepends:
#           value: 2
#         set: true
#       name: neighbor-group2
#       update_source: Loopback917

# After state:
# ------------
# RP/0/RP0/CPU0:10#show running-config router bgp
# Thu Mar 23 10:23:34.104 UTC
# router bgp 65536
#  neighbor-group neighbor-group1
#   precedence flash
#   advertisement-interval 12
#   address-family ipv4 unicast
#    advertise local-labeled-route
#   !
#  !
#  neighbor-group neighbor-group2
#   ebgp-multihop 254
#   graceful-maintenance
#    as-prepends 2
#   !
#   cluster-id 2
#   description replace neighbor-group2
#   update-source Loopback917
#  !
# !


# Using deleted
# Before state:
# -------------
# RP/0/RP0/CPU0:10#show running-config router bgp
# Thu Mar 23 10:23:34.104 UTC
# router bgp 65536
#  neighbor-group neighbor-group1
#   precedence flash
#   advertisement-interval 12
#   address-family ipv4 unicast
#    advertise local-labeled-route
#   !
#  !
#  neighbor-group neighbor-group2
#   ebgp-multihop 254
#   graceful-maintenance
#    as-prepends 2
#   !
#   cluster-id 2
#   description replace neighbor-group2
#   update-source Loopback917
#  !
# !

- name: Delete given bgp_nbr_address_family configuration
  cisco.iosxr.iosxr_bgp_templates: &deleted
    config:
    state: deleted

# Task Output
# -----------
# before:
#   as_number: '65536'
#   neighbor:
#     - address_family:
#         - advertise:
#             local_labeled_route:
#               set: true
#           afi: ipv4
#           safi: unicast
#       advertisement_interval: 12
#       name: neighbor-group1
#       precedence: flash
#     - cluster_id: '2'
#       description: replace neighbor-group2
#       ebgp_multihop:
#         value: 254
#       graceful_maintenance:
#         as_prepends:
#           value: 2
#         set: true
#       name: neighbor-group2
#       update_source: Loopback917
# commands:
# - router bgp 65536
# - no neighbor-group neighbor-group1
# - no neighbor-group neighbor-group2
# after: {}

# After state:
# -------------
# RP/0/RP0/CPU0:10#show running-config router bgp
# Thu Mar 23 10:00:12.668 UTC
# % No such configuration item(s)
#
# RP/0/RP0/CPU0:10#

# Using gathered
# Before state:
# -------------
# RP/0/RP0/CPU0:10#show running-config router bgp
# Thu Mar 23 10:30:38.785 UTC
# router bgp 65536
#  neighbor-group neighbor-group1
#   bfd fast-detect strict-mode
#   precedence critical
#   advertisement-interval 10
#   internal-vpn-client
#   address-family ipv4 unicast
#    advertise local-labeled-route
#   !
#  !
#  neighbor-group neighbor-group2
#   ebgp-multihop 255
#   egress-engineering
#   precedence flash
#   graceful-maintenance
#    as-prepends 0
#   !
#   tcp mss inheritance-disable
#   local-as 6
#   cluster-id 1
#   dmz-link-bandwidth
#   description neighbor-group2
#   ttl-security
#   local address inheritance-disable
#   update-source Loopback919
#   ignore-connected-check
#   session-open-mode both
#   send-buffer-size 4096
#   receive-buffer-size 512
#   internal-vpn-client
#  !
# !

- name: Gather given bgp_templates configuration
  cisco.iosxr.iosxr_bgp_templates: &id001
    config:
    state: gathered

# Task output
# -----------
# gathered:
#   as_number: '65536'
#   neighbor:
#     - address_family:
#         - advertise:
#             local_labeled_route:
#               set: true
#           afi: ipv4
#           safi: unicast
#       advertisement_interval: 10
#       bfd:
#         fast_detect:
#           strict_mode: true
#       internal_vpn_client: true
#       name: neighbor-group1
#       precedence: critical
#     - cluster_id: '1'
#       description: neighbor-group2
#       dmz_link_bandwidth:
#         set: true
#       ebgp_multihop:
#         value: 255
#       egress_engineering:
#         set: true
#       graceful_maintenance:
#         as_prepends:
#           value: 0
#         set: true
#       ignore_connected_check:
#         set: true
#       internal_vpn_client: true
#       local:
#         address:
#           inheritance_disable: true
#       local_as:
#         value: 6
#       name: neighbor-group2
#       precedence: flash
#       receive_buffer_size: 512
#       send_buffer_size: 4096
#       session_open_mode: both
#       tcp:
#         mss:
#           inheritance_disable: true
#       ttl_security:
#         set: true
#       update_source: Loopback919


# Using overridden

# Before state:
# -------------
# RP/0/RP0/CPU0:10#show running-config router bgp
# Thu Mar 23 10:30:38.785 UTC
# router bgp 65536
#  neighbor-group neighbor-group1
#   bfd fast-detect strict-mode
#   precedence critical
#   advertisement-interval 10
#   internal-vpn-client
#   address-family ipv4 unicast
#    advertise local-labeled-route
#   !
#  !
#  neighbor-group neighbor-group2
#   ebgp-multihop 255
#   egress-engineering
#   precedence flash
#   graceful-maintenance
#    as-prepends 0
#   !
#   tcp mss inheritance-disable
#   local-as 6
#   cluster-id 1
#   dmz-link-bandwidth
#   description neighbor-group2
#   ttl-security
#   local address inheritance-disable
#   update-source Loopback919
#   ignore-connected-check
#   session-open-mode both
#   send-buffer-size 4096
#   receive-buffer-size 512
#   internal-vpn-client
#  !
# !
- name: override given bgp_templates configuration
  cisco.iosxr.iosxr_bgp_templates:
    config:
      as_number: 65536
      neighbor:
        - address_family:
            - advertise:
                local_labeled_route:
                  disable: true
              afi: ipv4
              safi: unicast
          advertisement_interval: 12
          bfd:
            fast_detect:
              strict_mode: true
          name: neighbor-group1
          precedence: flash
    state: overridden

# Task Output
# -----------
# before:
#   as_number: '65536'
#   neighbor:
#     - address_family:
#         - advertise:
#             local_labeled_route:
#               set: true
#           afi: ipv4
#           safi: unicast
#       advertisement_interval: 10
#       bfd:
#         fast_detect:
#           strict_mode: true
#       internal_vpn_client: true
#       name: neighbor-group1
#       precedence: critical
#     - cluster_id: '1'
#       description: neighbor-group2
#       dmz_link_bandwidth:
#         set: true
#       ebgp_multihop:
#         value: 255
#       egress_engineering:
#         set: true
#       graceful_maintenance:
#         as_prepends:
#           value: 0
#         set: true
#       ignore_connected_check:
#         set: true
#       internal_vpn_client: true
#       local:
#         address:
#           inheritance_disable: true
#       local_as:
#         value: 6
#       name: neighbor-group2
#       precedence: flash
#       receive_buffer_size: 512
#       send_buffer_size: 4096
#       session_open_mode: both
#       tcp:
#         mss:
#           inheritance_disable: true
#       ttl_security:
#         set: true
#       update_source: Loopback919
# commands:
# - router bgp 65536
# - no neighbor-group neighbor-group2
# - neighbor-group neighbor-group1
# - no internal-vpn-client
# - advertisement-interval 12
# - precedence flash
# - address-family ipv4 unicast
# - no advertise local-labeled-route
# - advertise local-labeled-route disable
# after:
#   as_number: '65536'
#   neighbor:
#     - address_family:
#         - advertise:
#             local_labeled_route:
#               disable: true
#           afi: ipv4
#           safi: unicast
#       advertisement_interval: 12
#       bfd:
#         fast_detect:
#           strict_mode: true
#       name: neighbor-group1
#       precedence: flash


# Using rendered
- name: >-
    Render platform specific configuration lines with state rendered (without
    connecting to the device)
  cisco.iosxr.iosxr_bgp_templates:
    config:
      as_number: 65536
      neighbor:
        - address_family:
            - advertise:
                local_labeled_route:
                  set: true
              afi: ipv4
              safi: unicast
          advertisement_interval: 10
          bfd:
            fast_detect:
              strict_mode: true
          internal_vpn_client: true
          name: neighbor-group1
          precedence: critical
        - cluster_id: '1'
          description: neighbor-group2
          dmz_link_bandwidth:
            set: true
          ebgp_multihop:
            value: 255
          egress_engineering:
            set: true
          graceful_maintenance:
            as_prepends:
              value: 0
            set: true
          ignore_connected_check:
            set: true
          internal_vpn_client: true
          local:
            address:
              inheritance_disable: true
          local_as:
            value: 6
          name: neighbor-group2
          precedence: flash
          receive_buffer_size: 512
          send_buffer_size: 4096
          session_open_mode: both
          tcp:
            mss:
              inheritance_disable: true
          ttl_security:
            set: true
          update_source: Loopback919
    state: rendered

# Task Output
# -----------
# rendered:
# - router bgp 65536
# - neighbor-group neighbor-group1
# - advertisement-interval 10
# - bfd fast-detect strict-mode
# - internal-vpn-client
# - precedence critical
# - address-family ipv4 unicast
# - advertise local-labeled-route
# - neighbor-group neighbor-group2
# - dmz-link-bandwidth
# - description neighbor-group2
# - cluster-id 1
# - ebgp-multihop 255
# - egress-engineering
# - internal-vpn-client
# - ignore-connected-check
# - local-as 6
# - local address inheritance-disable
# - precedence flash
# - receive-buffer-size 512
# - send-buffer-size 4096
# - session-open-mode both
# - tcp mss inheritance-disable
# - update-source Loopback919
# - ttl-security
# - graceful-maintenance
# - graceful-maintenance as-prepends 0


# Using parsed
- name: Parse externally provided BGP configuration
  register: result
  cisco.iosxr.iosxr_bgp_templates:
    running_config: "{{ lookup('file', 'parsed.cfg') }}"
    state: parsed

# content of pared.cfg
# router bgp 65536
#  neighbor-group neighbor-group1
#   bfd fast-detect strict-mode
#   precedence critical
#   advertisement-interval 10
#   internal-vpn-client
#   address-family ipv4 unicast
#    advertise local-labeled-route
#   !
#  !
#  neighbor-group neighbor-group2
#   ebgp-multihop 255
#   egress-engineering
#   precedence flash
#   graceful-maintenance
#    as-prepends 0
#   !
#   tcp mss inheritance-disable
#   local-as 6
#   cluster-id 1
#   dmz-link-bandwidth
#   description neighbor-group2
#   ttl-security
#   local address inheritance-disable
#   update-source Loopback919
#   idle-watch-time 30
#   ignore-connected-check
#   session-open-mode both
#   send-buffer-size 4096
#   receive-buffer-size 512
#   internal-vpn-client
#  !
# !
# Task output
# -----------
# parsed:
#   as_number: '65536'
#   neighbor:
#     - address_family:
#         - advertise:
#             local_labeled_route:
#               set: true
#           afi: ipv4
#           safi: unicast
#       advertisement_interval: 10
#       bfd:
#         fast_detect:
#           strict_mode: true
#       internal_vpn_client: true
#       name: neighbor-group1
#       precedence: critical
#     - cluster_id: '1'
#       description: neighbor-group2
#       dmz_link_bandwidth:
#         set: true
#       ebgp_multihop:
#         value: 255
#       egress_engineering:
#         set: true
#       graceful_maintenance:
#         as_prepends:
#           value: 0
#         set: true
#       ignore_connected_check:
#         set: true
#       internal_vpn_client: true
#       local:
#         address:
#           inheritance_disable: true
#       local_as:
#         value: 6
#       name: neighbor-group2
#       precedence: flash
#       receive_buffer_size: 512
#       send_buffer_size: 4096
#       session_open_mode: both
#       tcp:
#         mss:
#           inheritance_disable: true
#       ttl_security:
#         set: true
#       update_source: Loopback919

返回值 

常用返回值记录在此处此处，以下是此模块独有的字段

键	描述
after 字典	模块执行后的结果配置。返回：当更改时示例： `"此输出将始终与模块 argspec 的格式相同。\n"`
before 字典	模块执行之前的配置。返回：当 state 为 `merged`、`replaced`、`overridden`、`deleted` 或 `purged` 时示例： `"此输出将始终与模块 argspec 的格式相同。\n"`
commands 列表 / 元素 = 字符串	推送到远程设备的命令集。返回：当 state 为 `merged`、`replaced`、`overridden`、`deleted` 或 `purged` 时示例： `["router bgp 65536", "neighbor-group neighbor-group1", "advertisement-interval 10", "bfd fast-detect strict-mode", "internal-vpn-client"]`
gathered 列表 / 元素 = 字符串	从远程设备收集的关于网络资源的结构化数据的事实。返回：当 state 为 `gathered` 时示例： `["此输出将始终与模块 argspec 的格式相同。\n"]`
parsed 列表 / 元素 = 字符串	根据模块 argspec 解析为结构化数据的 running_config 选项中提供的设备本机配置。返回: 当state为`parsed`时示例： `["此输出将始终与模块 argspec 的格式相同。\n"]`
已渲染列表 / 元素 = 字符串	任务中提供的配置以设备原生格式（离线）渲染。返回: 当state为`rendered`时示例： `["router bgp 65536", "neighbor-group neighbor-group1", "advertisement-interval 10", "bfd fast-detect strict-mode", "internal-vpn-client"]`

作者

Ashwini Mhatre (@amhatre)