cisco.iosxr.iosxr_bgp_global 模块 – 用于配置 BGP 的资源模块。
注意
此模块是 cisco.iosxr 集合(版本 10.2.2)的一部分。
如果您正在使用 ansible
包,您可能已经安装了这个集合。它不包含在 ansible-core
中。要检查它是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用:ansible-galaxy collection install cisco.iosxr
。
要在 playbook 中使用它,请指定:cisco.iosxr.iosxr_bgp_global
。
cisco.iosxr 2.0.0 中的新增功能
概要
此模块配置和管理 Cisco IOS-XR 平台上 BGP 全局的属性。
参数
参数 |
注释 |
---|---|
BGP 全局的配置列表。 |
|
路由器的自治系统号。 |
|
配置 BFD 参数。 |
|
指定邻居的 BFD 会话的最小间隔值。 |
|
指定邻居的 BFD 会话的乘数值。 |
|
BGP 参数。 |
|
为 iBGP 对等体启用 AS 路径循环检查。 选择
|
|
在策略重新配置时启用自动软对等重置。 |
|
禁用边界网关协议 (BGP) 对等体的自动软重置。 选择
|
|
为 BGP 路由选择最佳路径选择算法。 |
|
AIGP 属性 |
|
忽略 AIGP 属性。 选择
|
|
根据 AS 路径选择最佳路径选择。 |
|
ignore 选择
|
|
multipath-relax 选择
|
|
比较相同 EBGP 路径的路由器 ID。 选择
|
|
成本社区。 |
|
忽略成本社区 选择
|
|
MED 属性 |
|
允许比较来自不同邻居的 MED。 选择
|
|
比较联盟路径之间的 MED。 选择
|
|
将缺失的 MED 视为最不喜欢的 MED。 选择
|
|
BGP 来源-AS 旋钮。 |
|
BGP 来源-AS 旋钮。 |
|
BGP 最佳路径选择将允许“无效”来源-AS 选择
|
|
BGP 来源-AS 旋钮。 |
|
BGP 最佳路径选择将使用来源-AS 有效性 选择
|
|
充当路由反射器的此路由器的群集 ID。 |
|
联盟。 |
|
设置路由域联盟 AS。 |
|
在 BGP 联盟模式下输入对等 AS。 |
|
配置默认值。 |
|
本地优先级。 请参阅供应商文档以获取有效值 |
|
对 EBGP 路由强制执行第一个 AS |
|
禁用强制执行第一个 AS 选择
|
|
如果与直接连接的外部对等体的链路断开,立即重置会话。 |
|
禁用快速外部故障转移。 选择
|
|
启用平滑重启支持。 |
|
如果配置更改强制对等重置,则平滑重置。 选择
|
|
秒内清除陈旧路由的时间 <1-6000>。 |
|
在秒内向邻居通告的重启时间 <1-4095>。 |
|
启用平滑重启。 选择
|
|
等待支持 GR 的对等体重启的最长时间(以秒为单位)<1-4095>。 |
|
将分流路径安装到 RIB/CEF。 |
|
将分流路径安装到 RIB/CEF。 选择
|
|
记录 BGP 信息 |
|
记录邻居入站/出站消息。 |
|
禁用入站出站消息。 选择
|
|
记录邻居状态信息。 |
|
记录邻居启动/关闭和重置原因。 |
|
detail 选择
|
|
disable 选择
|
|
可以配置的最大邻居数 |
|
最大邻居数 <1-15000>。 |
|
更改多路径选择标准 |
|
AS 路径 |
|
忽略多路径选择的 AS 路径相关检查。 |
|
忽略多路径选择的 AS 路径之后的所有内容。 选择
|
|
BGP 来源-AS 旋钮。 |
|
BGP 来源-AS 验证旋钮。 |
|
禁用 RPKI 来源-AS 验证。 选择
|
|
向对等体发出来源-AS 有效性信号。 |
|
向 iBGP 对等体发出来源-AS 有效性信号 选择
|
|
在 RPKI 更新和 BGP 表遍历之间等待的时间。 |
|
前缀验证时间(以秒为单位)。 |
|
RPKI 更新后不自动进行前缀验证。 选择
|
|
重新分发内部 BGP 路由。 选择
|
|
配置路由器 ID。示例 - A.B.C.D IPv4 地址。 |
|
为通用扫描器配置后台扫描器间隔。示例 - <5-3600>。 |
|
使没有策略的 eBGP 邻居传递所有路由(思科支持)。 选择
|
|
设置发送更新的最大初始延迟,单位为秒。示例:<0-3600>。 |
|
控制默认信息的发布。 |
|
发布默认路由。 选择
|
|
默认度量值。示例:<1-4294967295>。 |
|
允许路由器平滑地加入或退出服务。 |
|
所有配置了 graceful-maintenance 的邻居。 选择
|
|
设置 iBGP 对等体的选项。 |
|
设置路由策略的选项。 |
|
设置出站策略的选项。 |
|
允许策略修改所有属性。 选择
|
|
启用 mpls 参数。 |
|
在 BGP mpls 激活模式下输入 mpls 接口。 |
|
要启用 mpls 的接口名称。 |
|
连接到 PIM/PIM6。 选择
|
|
指定一个邻居路由器。 |
|
发送 BGP 路由更新之间的最小间隔,单位为秒。示例:<0-600>。 |
|
配置 BFD 参数。 |
|
启用快速检测。 |
|
防止 BFD 设置从父级继承。 选择
|
|
set fast-detect 选择
|
|
保持邻居会话,直到 BFD 会话启动。 选择
|
|
指定邻居的 BFD 会话的最小间隔值。 |
|
指定邻居的 BFD 会话的乘数值。 |
|
为此邻居启用 BMP 日志记录。 |
|
启用与特定服务器的 BMP 连接。示例:<1-8>。 |
|
向对等体通告能力。 |
|
BGP additional-paths 命令。 |
|
额外的路径接收能力。 |
|
set receive capability 选择
|
|
set receive capability 选择
|
|
额外的路径发送能力。 |
|
set send capability 选择
|
|
set send capability 选择
|
|
禁止向对等体通告能力。 |
|
所有能力。 |
|
不从父组继承此配置。 选择
|
|
set all。 选择
|
|
4 字节 AS 能力。 |
|
set 4_byte_as。 选择
|
|
充当路由反射器的此路由器的群集 ID。 |
|
邻居的特定描述。 |
|
传播 DMZ 链路带宽。 |
|
不从父组继承此配置。 选择
|
|
set dmz-link-bandwidth。 选择
|
|
设置 IP DSCP(差分服务代码点)。请参阅供应商文档以获取有效条目。 |
|
允许不在直接连接网络上的 EBGP 邻居。 |
|
禁用 BGP MPLS 转发。 选择
|
|
最大跳数。示例:<1-255>。 |
|
从 ebgp 邻居接收 extcommunity dmz 链路带宽。 |
|
防止从父级继承 ebgp-recv-community-dmz。 选择
|
|
set ebgp-recv-community-dmz。 选择
|
|
从 ebgp 邻居发送 extcommunity dmz 链路带宽。 |
|
将所有多路径的累积社区 dmz 链路带宽发送到 ebgp 邻居。 选择
|
|
防止从父级继承 ebgp-send-community-dmz。 选择
|
|
set ebgp-send-community-dmz。 选择
|
|
为此邻居启用出口对等工程。 |
|
防止从父级继承 egress-engineering。 选择
|
|
set egress-engineering。 选择
|
|
对 EBGP 路由强制执行第一个 AS |
|
禁用强制执行第一个 AS 选择
|
|
用于平滑维护的属性。这将导致邻居不优先选择来自此路由器的路由,而选择替代路由。这允许路由器平滑地加入或退出服务。 |
|
在激活时,将使用平滑维护属性通告路由,无论是在此处还是在路由器 bgp 配置下激活。 |
|
防止从父级继承 activate。 选择
|
|
activate。 选择
|
|
将本地 AS 号添加到路由 AS 路径的次数。默认值 = 0。 |
|
防止从父级继承 as prepends。 选择
|
|
as prepends 的取值范围。示例:<0-6>。 |
|
用于向 ibgp 邻居通告路由的本地首选项。默认值 = 无触碰。 |
|
防止从父级继承本地首选项。 选择
|
|
本地首选项的取值范围。示例:<0-4294967295>。 |
|
set graceful maintenance。 选择
|
|
为此邻居启用平滑重启支持。 |
|
在秒内向邻居通告的重启时间 <1-4095>。 |
|
等待支持 GR 的对等体重启的最长时间(以秒为单位)<1-4095>。 |
|
绕过单跳 eBGP 对等连接的直接连接下一跳检查。 |
|
防止从父级继承 ignore-connected-check。 选择
|
|
set ignore-connected-check。 选择
|
|
设置基于密钥链的身份验证。 |
|
防止从父级继承密钥链。 选择
|
|
密钥链的名称 - 最多 32 个字符。 |
|
配置本地参数。 |
|
IPv4 地址。 |
|
防止从父级继承本地地址。 选择
|
|
IPv4 地址 <A.B.C.D>。 |
|
指定本地 AS 号。 |
|
防止从父级继承本地 AS。 选择
|
|
不将本地 AS 添加到来自此邻居的通告。 |
|
仅将本地 AS 添加到发送到此邻居的通告。 |
|
双 AS 模式。 选择
|
|
仅将本地 AS 添加到发送到此邻居的通告。 选择
|
|
不将本地 AS 添加到来自此邻居的通告。 选择
|
|
2 字节、4 字节 AS 号。 |
|
记录每个邻居的更新消息。 |
|
记录每个邻居的更新/通知消息。 |
|
入站日志消息。 |
|
禁用入站消息日志记录。 选择
|
|
防止从父级继承 msg 日志。 选择
|
|
消息日志缓冲区大小的范围 <1-100>。 |
|
出站日志消息。 |
|
禁用入站消息日志记录。 选择
|
|
防止从父级继承 msg 日志。 选择
|
|
消息日志缓冲区大小的范围 <1-100>。 |
|
邻居路由器地址。 |
|
BGP 来源-AS 旋钮。 |
|
BGP 来源-AS 验证旋钮。 |
|
禁用 RPKI 来源-AS 验证。 选择
|
|
设置密码。 |
|
指定将跟随一个加密密码。 |
|
防止从父级继承密码。 选择
|
|
设置套接字和 BGP 接收缓冲区大小。示例:<512-131072>。 |
|
邻居自治系统。 |
|
设置套接字和 BGP 发送缓冲区大小。示例:<4096-131072>。 |
|
使用此 TCP 打开模式建立 BGP 会话。 选择
|
|
管理性地关闭此邻居。 |
|
防止从父级继承 shutdown。 选择
|
|
shutdown。 选择
|
|
TCP 会话配置命令。 |
|
最大段大小。 |
|
防止从父级继承 mss。 选择
|
|
TCP 初始最大段大小。 |
|
每个邻居的 BGP 定时器。 |
|
保持时间 <3-65535> 或 0(禁用保持时间)。 |
|
保持活动间隔 <0-65535>。 |
|
启用 EBGP TTL 安全性。 |
|
防止从父级继承 ttl-security。 选择
|
|
set ttl-security。 选择
|
|
BGP 更新配置。 |
|
入站更新消息处理。 |
|
入站更新消息过滤。 |
|
属性筛选器配置。 |
|
组的名称。 |
|
更新过滤系统日志消息。 |
|
禁用更新过滤系统日志消息。 选择
|
|
已过滤的更新消息。 |
|
用于存储已过滤更新消息的缓冲区数量。 |
|
路由更新的来源。有关有效值,请参阅供应商文档。 |
|
使用邻居组和会话组模板。 |
|
从邻居组继承配置。 |
|
从会话组继承独立于地址族的配置。 |
|
为所有邻居启用不间断路由支持。 |
|
disable nsr 选择
|
|
set nsr 选择
|
|
配置 RPKI。 |
|
配置 RPKI 路由。A.B.C.D/长度 或 X:X::X/长度 网络/最小前缀长度。 |
|
最大前缀长度。示例:<1-128>。 |
|
原始自治系统号(以 asplain 格式)。示例:<1-4294967295>。 |
|
A.B.C.D/长度 或 X:X::X/长度 网络/最小前缀长度。 |
|
配置 RPKI 缓存服务器。 |
|
rpki 服务器的地址。 |
|
缓存关闭后等待清除过时路由的时间。 |
|
发送 RPKI 缓存服务器的串行查询之间的时间间隔。 |
|
不定期发送串行查询。 选择
|
|
清除时间(秒)<30-360>。 |
|
等待 RPKI 缓存服务器响应的时间。 |
|
无限期等待响应。 选择
|
|
清除时间(秒)<15-3600>。 |
|
关闭 RPKI 缓存服务器。 选择
|
|
为 RPKI 缓存服务器指定传输方法。 |
|
使用 SSH 连接到 RPKI 缓存服务器。 |
|
为 RPKI 缓存服务器传输指定端口号。 |
|
使用 TCP(未加密)连接到 RPKI 缓存服务器。 |
|
为 RPKI 缓存服务器传输指定端口号。 |
|
设置套接字参数。 |
|
套接字接收缓冲区大小。示例:<512-131072>。 |
|
套接字发送缓冲区大小。示例:<4096-131072>。 |
|
每个邻居的 BGP 定时器。 |
|
保持时间 <3-65535> 或 0(禁用保持时间)。 |
|
保持活动间隔 <0-65535>。 |
|
BGP 更新配置。 |
|
入站更新消息处理。 |
|
入站更新消息错误处理。 |
|
入站更新消息基本错误处理。 |
|
用于 EBGP 邻居的入站更新消息基本错误处理。 |
|
disable 选择
|
|
用于 ibgp 邻居的入站更新消息基本错误处理。 |
|
disable 选择
|
|
入站更新消息扩展错误处理。 |
|
用于 EBGP 邻居的入站更新消息扩展错误处理。 选择
|
|
用于 ibgp 邻居的入站更新消息扩展错误处理。 选择
|
|
更新生成期间瞬态内存使用的上限。示例:<16-2048>。 |
|
BGP 更新生成配置。 |
|
启用更新生成事件的日志记录。 选择
|
|
指定 VRF 名称。 |
|
配置 BFD 参数。 |
|
指定邻居的 BFD 会话的最小间隔值。 |
|
指定邻居的 BFD 会话的乘数值。 |
|
BGP 命令。 |
|
在策略重新配置时启用自动软对等重置。 |
|
禁用边界网关协议 (BGP) 对等体的自动软重置。 选择
|
|
为 BGP 路由选择最佳路径选择算法。 |
|
AIGP 属性 |
|
忽略 AIGP 属性。 选择
|
|
根据 AS 路径选择最佳路径选择。 |
|
ignore 选择
|
|
multipath-relax 选择
|
|
比较相同 EBGP 路径的路由器 ID。 选择
|
|
成本社区。 |
|
忽略成本社区 选择
|
|
MED 属性 |
|
允许比较来自不同邻居的 MED。 选择
|
|
比较联盟路径之间的 MED。 选择
|
|
将缺失的 MED 视为最不喜欢的 MED。 选择
|
|
BGP 来源-AS 旋钮。 |
|
BGP 来源-AS 旋钮。 |
|
BGP 最佳路径选择将允许“无效”来源-AS 选择
|
|
BGP 来源-AS 旋钮。 |
|
BGP 最佳路径选择将使用来源-AS 有效性 选择
|
|
配置默认值。 |
|
本地优先级。 请参阅供应商文档以获取有效值 |
|
对 EBGP 路由强制执行第一个 AS |
|
禁用强制执行第一个 AS 选择
|
|
如果与直接连接的外部对等体的链路断开,立即重置会话。 |
|
禁用快速外部故障转移。 选择
|
|
记录 BGP 信息 |
|
记录邻居入站/出站消息。 |
|
禁用入站出站消息。 选择
|
|
记录邻居状态信息。 |
|
记录邻居启动/关闭和重置原因。 |
|
detail 选择
|
|
disable 选择
|
|
更改多路径选择标准 |
|
AS 路径 |
|
忽略多路径选择的 AS 路径相关检查。 |
|
忽略多路径选择的 AS 路径之后的所有内容。 选择
|
|
重新分发内部 BGP 路由。 选择
|
|
配置路由器 ID。示例 - A.B.C.D IPv4 地址。 |
|
使没有策略的 eBGP 邻居传递所有路由(思科支持)。 选择
|
|
控制默认信息的发布。 |
|
发布默认路由。 选择
|
|
默认度量值。示例:<1-4294967295>。 |
|
启用 mpls 参数。 |
|
在 BGP mpls 激活模式下输入 mpls 接口。 |
|
要启用 mpls 的接口名称。 |
|
指定一个邻居路由器。 |
|
发送 BGP 路由更新之间的最小间隔,单位为秒。示例:<0-600>。 |
|
配置 BFD 参数。 |
|
启用快速检测。 |
|
防止 BFD 设置从父级继承。 选择
|
|
set fast-detect 选择
|
|
保持邻居会话,直到 BFD 会话启动。 选择
|
|
指定邻居的 BFD 会话的最小间隔值。 |
|
指定邻居的 BFD 会话的乘数值。 |
|
为此邻居启用 BMP 日志记录。 |
|
启用与特定服务器的 BMP 连接。示例:<1-8>。 |
|
向对等体通告能力。 |
|
BGP additional-paths 命令。 |
|
额外的路径接收能力。 |
|
set receive capability 选择
|
|
set receive capability 选择
|
|
额外的路径发送能力。 |
|
set send capability 选择
|
|
set send capability 选择
|
|
禁止向对等体通告能力。 |
|
所有能力。 |
|
不从父组继承此配置。 选择
|
|
set all。 选择
|
|
4 字节 AS 能力。 |
|
set 4_byte_as。 选择
|
|
充当路由反射器的此路由器的群集 ID。 |
|
邻居的特定描述。 |
|
传播 DMZ 链路带宽。 |
|
不从父组继承此配置。 选择
|
|
set dmz-link-bandwidth。 选择
|
|
设置 IP DSCP(差分服务代码点)。请参阅供应商文档以获取有效条目。 |
|
允许不在直接连接网络上的 EBGP 邻居。 |
|
禁用 BGP MPLS 转发。 选择
|
|
最大跳数。示例:<1-255>。 |
|
从 ebgp 邻居接收 extcommunity dmz 链路带宽。 |
|
防止从父级继承 ebgp-recv-community-dmz。 选择
|
|
set ebgp-recv-community-dmz。 选择
|
|
从 ebgp 邻居发送 extcommunity dmz 链路带宽。 |
|
将所有多路径的累积社区 dmz 链路带宽发送到 ebgp 邻居。 选择
|
|
防止从父级继承 ebgp-send-community-dmz。 选择
|
|
set ebgp-send-community-dmz。 选择
|
|
为此邻居启用出口对等工程。 |
|
防止从父级继承 egress-engineering。 选择
|
|
set egress-engineering。 选择
|
|
对 EBGP 路由强制执行第一个 AS |
|
禁用强制执行第一个 AS 选择
|
|
用于平滑维护的属性。这将导致邻居不优先选择来自此路由器的路由,而选择替代路由。这允许路由器平滑地加入或退出服务。 |
|
在激活时,将使用平滑维护属性通告路由,无论是在此处还是在路由器 bgp 配置下激活。 |
|
防止从父级继承 activate。 选择
|
|
activate。 选择
|
|
将本地 AS 号添加到路由 AS 路径的次数。默认值 = 0。 |
|
防止从父级继承 as prepends。 选择
|
|
as prepends 的取值范围。示例:<0-6>。 |
|
用于向 ibgp 邻居通告路由的本地首选项。默认值 = 无触碰。 |
|
防止从父级继承本地首选项。 选择
|
|
本地首选项的取值范围。示例:<0-4294967295>。 |
|
set graceful maintenance。 选择
|
|
为此邻居启用平滑重启支持。 |
|
在秒内向邻居通告的重启时间 <1-4095>。 |
|
等待支持 GR 的对等体重启的最长时间(以秒为单位)<1-4095>。 |
|
绕过单跳 eBGP 对等连接的直接连接下一跳检查。 |
|
防止从父级继承 ignore-connected-check。 选择
|
|
set ignore-connected-check。 选择
|
|
设置基于密钥链的身份验证。 |
|
防止从父级继承密钥链。 选择
|
|
密钥链的名称 - 最多 32 个字符。 |
|
配置本地参数。 |
|
IPv4 地址。 |
|
防止从父级继承本地地址。 选择
|
|
IPv4 地址 <A.B.C.D>。 |
|
指定本地 AS 号。 |
|
防止从父级继承本地 AS。 选择
|
|
不将本地 AS 添加到来自此邻居的通告。 |
|
仅将本地 AS 添加到发送到此邻居的通告。 |
|
双 AS 模式。 选择
|
|
仅将本地 AS 添加到发送到此邻居的通告。 选择
|
|
不将本地 AS 添加到来自此邻居的通告。 选择
|
|
2 字节、4 字节 AS 号。 |
|
记录每个邻居的更新消息。 |
|
记录每个邻居的更新/通知消息。 |
|
入站日志消息。 |
|
禁用入站消息日志记录。 选择
|
|
防止从父级继承 msg 日志。 选择
|
|
消息日志缓冲区大小的范围 <1-100>。 |
|
出站日志消息。 |
|
禁用入站消息日志记录。 选择
|
|
防止从父级继承 msg 日志。 选择
|
|
消息日志缓冲区大小的范围 <1-100>。 |
|
邻居路由器地址。 |
|
BGP 来源-AS 旋钮。 |
|
BGP 来源-AS 验证旋钮。 |
|
禁用 RPKI 来源-AS 验证。 选择
|
|
设置密码。 |
|
指定将跟随一个加密密码。 |
|
防止从父级继承密码。 选择
|
|
设置套接字和 BGP 接收缓冲区大小。示例:<512-131072>。 |
|
邻居自治系统。 |
|
设置套接字和 BGP 发送缓冲区大小。示例:<4096-131072>。 |
|
使用此 TCP 打开模式建立 BGP 会话。 选择
|
|
管理性地关闭此邻居。 |
|
防止从父级继承 shutdown。 选择
|
|
shutdown。 选择
|
|
TCP 会话配置命令。 |
|
最大段大小。 |
|
防止从父级继承 mss。 选择
|
|
TCP 初始最大段大小。 |
|
每个邻居的 BGP 定时器。 |
|
保持时间 <3-65535> 或 0(禁用保持时间)。 |
|
保持活动间隔 <0-65535>。 |
|
启用 EBGP TTL 安全性。 |
|
防止从父级继承 ttl-security。 选择
|
|
set ttl-security。 选择
|
|
BGP 更新配置。 |
|
入站更新消息处理。 |
|
入站更新消息过滤。 |
|
属性筛选器配置。 |
|
组的名称。 |
|
更新过滤系统日志消息。 |
|
禁用更新过滤系统日志消息。 选择
|
|
已过滤的更新消息。 |
|
用于存储已过滤更新消息的缓冲区数量。 |
|
路由更新的来源。有关有效值,请参阅供应商文档。 |
|
使用邻居组和会话组模板。 |
|
从邻居组继承配置。 |
|
从会话组继承独立于地址族的配置。 |
|
路由区分符。 |
|
自动路由区分符。 选择
|
|
设置套接字参数。 |
|
套接字接收缓冲区大小。示例:<512-131072>。 |
|
套接字发送缓冲区大小。示例:<4096-131072>。 |
|
每个邻居的 BGP 定时器。 |
|
保持时间 <3-65535> 或 0(禁用保持时间)。 |
|
保持活动间隔 <0-65535>。 |
|
VRF 名称。 |
|
配置应保留的状态。- 状态purged 从目标设备删除所有 BGP 配置。使用此状态时请务必小心。 - 状态deleted 仅删除此模块管理的 BGP 属性,而不完全否定 BGP 进程。从而保留 BGP 上下文下的地址族相关配置。 - 如果邻居或要删除的 VRF 上下文中存在地址族配置行,则运行状态deleted 和 replaced 将导致错误。请使用 cisco.iosxr.iosxr_bgp_address_family 或 cisco.iosxr.iosxr_bgp_neighbor_address_family 模块进行事先清理。- 有关更多详细信息,请参阅示例。 |
|
配置应保留的状态。 选择
|
注释
注意
此模块与连接
network_cli
协同工作。
示例
# Using merged
#
# Before state
# ------------
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 09:38:36.245 UTC
# % No such configuration item(s)
# RP/0/0/CPU0:10#
- name: Merge the following BGP global configuration
cisco.iosxr.iosxr_bgp_global:
config:
as_number: 65536
default_metric: 5
socket:
receive_buffer_size: 514
send_buffer_size: 4098
bgp:
confederation:
identifier: 4
bestpath:
med:
confed: true
cluster_id: 5
router_id: 192.0.2.10
neighbors:
- neighbor: 192.0.2.13
remote_as: 65538
bfd:
fast_detect:
strict_mode: true
multiplier: 6
minimum_interval: 20
vrfs:
- vrf: vrf1
default_metric: 5
#
# Task Output:
# ---------------
#
# before: {}
# commands:
# - router bgp 65536
# - bgp cluster-id 5
# - bgp router-id 192.0.2.10
# - bgp bestpath med confed
# - bgp confederation identifier 4
# - default-metric 5
# - socket receive-buffer-size 514
# - socket send-buffer-size 4098
# - neighbor 192.0.2.13
# - bfd fast-detect strict-mode
# - bfd minimum-interval 20
# - bfd multiplier 6
# - remote-as 65538
# - vrf vrf1
# - default-metric 5
#
# after:
# as_number: '65536'
# bgp:
# bestpath:
# med:
# confed: true
# cluster_id: '5'
# confederation:
# identifier: 4
# router_id: 192.0.2.10
# default_metric: 5
# neighbors:
# - bfd:
# fast_detect:
# strict_mode: true
# minimum_interval: 20
# multiplier: 6
# neighbor_address: 192.0.2.13
# remote_as: 65538
# socket:
# receive_buffer_size: 514
# send_buffer_size: 4098
# vrfs:
# - default_metric: 5
# vrf: vrf1
#
# After state
# -----------
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 09:44:32.480 UTC
# router bgp 65536
# bgp confederation identifier 4
# bgp router-id 192.0.2.10
# bgp cluster-id 5
# default-metric 5
# socket send-buffer-size 4098
# bgp bestpath med confed
# socket receive-buffer-size 514
# neighbor 192.0.2.13
# remote-as 65538
# bfd fast-detect strict-mode
# bfd multiplier 6
# bfd minimum-interval 20
# !
# vrf vrf1
# default-metric 5
# !
# !
# Using replaced
#
# Before state
# ------------
#
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 09:44:32.480 UTC
# router bgp 65536
# bgp confederation identifier 4
# bgp router-id 192.0.2.10
# bgp cluster-id 5
# default-metric 5
# socket send-buffer-size 4098
# bgp bestpath med confed
# socket receive-buffer-size 514
# neighbor 192.0.2.13
# remote-as 65538
# bfd fast-detect strict-mode
# bfd multiplier 6
# bfd minimum-interval 20
# !
# vrf vrf1
# default-metric 5
# !
# !
- name: Replace the following configuration
cisco.iosxr.iosxr_bgp_global:
state: replaced
config:
as_number: 65536
default_metric: 4
socket:
receive_buffer_size: 514
send_buffer_size: 4098
bgp:
confederation:
identifier: 4
bestpath:
med:
confed: true
cluster_id: 5
router_id: 192.0.2.10
neighbors:
- neighbor: 192.0.2.14
remote_as: 65538
bfd:
fast_detect:
strict_mode: true
multiplier: 6
minimum_interval: 20
vrfs:
- vrf: vrf1
default_metric: 5
#
# Task Output:
# -------------
#
# before:
# as_number: '65536'
# bgp:
# bestpath:
# med:
# confed: true
# cluster_id: '5'
# confederation:
# identifier: 4
# router_id: 192.0.2.10
# default_metric: 5
# neighbors:
# - bfd:
# fast_detect:
# strict_mode: true
# minimum_interval: 20
# multiplier: 6
# neighbor_address: 192.0.2.13
# remote_as: 65538
# socket:
# receive_buffer_size: 514
# send_buffer_size: 4098
# vrfs:
# - default_metric: 5
# vrf: vrf1
#
# commands:
# - router bgp 65536
# - default-metric 4
# - neighbor 192.0.2.14
# - bfd fast-detect strict-mode
# - bfd minimum-interval 20
# - bfd multiplier 6
# - remote-as 65538
# - no neighbor 192.0.2.13
#
# after:
# as_number: '65536'
# bgp:
# bestpath:
# med:
# confed: true
# cluster_id: '5'
# confederation:
# identifier: 4
# router_id: 192.0.2.10
# default_metric: 4
# neighbors:
# - bfd:
# fast_detect:
# strict_mode: true
# minimum_interval: 20
# multiplier: 6
# neighbor_address: 192.0.2.14
# remote_as: 65538
# socket:
# receive_buffer_size: 514
# send_buffer_size: 4098
# vrfs:
# - default_metric: 5
# vrf: vrf1
#
# After state
# -----------
#
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 09:54:11.161 UTC
# router bgp 65536
# bgp confederation identifier 4
# bgp router-id 192.0.2.10
# bgp cluster-id 5
# default-metric 4
# socket send-buffer-size 4098
# bgp bestpath med confed
# socket receive-buffer-size 514
# neighbor 192.0.2.14
# remote-as 65538
# bfd fast-detect strict-mode
# bfd multiplier 6
# bfd minimum-interval 20
# !
# vrf vrf1
# default-metric 5
# !
# !
# Using overridden
#
# Before state
# ------------
#
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 09:44:32.480 UTC
# router bgp 65536
# bgp confederation identifier 4
# bgp router-id 192.0.2.10
# bgp cluster-id 5
# default-metric 5
# socket send-buffer-size 4098
# bgp bestpath med confed
# socket receive-buffer-size 514
# neighbor 192.0.2.13
# remote-as 65538
# bfd fast-detect strict-mode
# bfd multiplier 6
# bfd minimum-interval 20
# !
# vrf vrf1
# default-metric 5
# !
# !
- name: Override running config with provided configuration
cisco.iosxr.iosxr_bgp_global:
state: overridden
config:
as_number: 65536
default_metric: 4
socket:
receive_buffer_size: 514
send_buffer_size: 4098
bgp:
confederation:
identifier: 4
bestpath:
med:
confed: true
cluster_id: 5
router_id: 192.0.2.10
neighbors:
- neighbor: 192.0.2.14
remote_as: 65538
bfd:
fast_detect:
strict_mode: true
multiplier: 6
minimum_interval: 20
vrfs:
- vrf: vrf1
default_metric: 5
#
# Task Output:
# -------------
#
# before:
# as_number: '65536'
# bgp:
# bestpath:
# med:
# confed: true
# cluster_id: '5'
# confederation:
# identifier: 4
# router_id: 192.0.2.10
# default_metric: 5
# neighbors:
# - bfd:
# fast_detect:
# strict_mode: true
# minimum_interval: 20
# multiplier: 6
# neighbor_address: 192.0.2.13
# remote_as: 65538
# socket:
# receive_buffer_size: 514
# send_buffer_size: 4098
# vrfs:
# - default_metric: 5
# vrf: vrf1
#
# commands:
# - router bgp 65536
# - default-metric 4
# - neighbor 192.0.2.14
# - bfd fast-detect strict-mode
# - bfd minimum-interval 20
# - bfd multiplier 6
# - remote-as 65538
# - no neighbor 192.0.2.13
#
# after:
# as_number: '65536'
# bgp:
# bestpath:
# med:
# confed: true
# cluster_id: '5'
# confederation:
# identifier: 4
# router_id: 192.0.2.10
# default_metric: 4
# neighbors:
# - bfd:
# fast_detect:
# strict_mode: true
# minimum_interval: 20
# multiplier: 6
# neighbor_address: 192.0.2.14
# remote_as: 65538
# socket:
# receive_buffer_size: 514
# send_buffer_size: 4098
# vrfs:
# - default_metric: 5
# vrf: vrf1
# After state
# -----------
#
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 09:54:11.161 UTC
# router bgp 65536
# bgp confederation identifier 4
# bgp router-id 192.0.2.10
# bgp cluster-id 5
# default-metric 4
# socket send-buffer-size 4098
# bgp bestpath med confed
# socket receive-buffer-size 514
# neighbor 192.0.2.14
# remote-as 65538
# bfd fast-detect strict-mode
# bfd multiplier 6
# bfd minimum-interval 20
# !
# vrf vrf1
# default-metric 5
# !
# !
# Using deleted
#
# Before state
# ------------
#
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 09:54:11.161 UTC
# router bgp 65536
# bgp confederation identifier 4
# bgp router-id 192.0.2.10
# bgp cluster-id 5
# default-metric 4
# socket send-buffer-size 4098
# bgp bestpath med confed
# socket receive-buffer-size 514
# neighbor 192.0.2.14
# remote-as 65538
# bfd fast-detect strict-mode
# bfd multiplier 6
# bfd minimum-interval 20
# !
# vrf vrf1
# default-metric 5
# !
# !
#
- name: Delete BGP configurations handled by this module
cisco.iosxr.iosxr_bgp_global:
config:
as_number: 65536
state: deleted
#
# Task Output:
# -------------
#
# before:
# as_number: '65536'
# bgp:
# bestpath:
# med:
# confed: true
# cluster_id: '5'
# confederation:
# identifier: 4
# router_id: 192.0.2.10
# default_metric: 4
# neighbors:
# - bfd:
# fast_detect:
# strict_mode: true
# minimum_interval: 20
# multiplier: 6
# neighbor_address: 192.0.2.14
# remote_as: 65538
# socket:
# receive_buffer_size: 514
# send_buffer_size: 4098
# vrfs:
# - default_metric: 5
# vrf: vrf1
#
# commands:
# - router bgp 65536
# - no bgp cluster-id 5
# - no bgp router-id 192.0.2.10
# - no bgp bestpath med confed
# - no bgp confederation identifier 4
# - no default-metric 4
# - no socket receive-buffer-size 514
# - no socket send-buffer-size 4098
# - no neighbor 192.0.2.14
# - no vrf vrf1
#
# after:
# as_number: '65536'
#
# After state
# -----------
#
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 10:01:08.232 UTC
# router bgp 65536
# !
#
# Using purged
#
# Before state
# ------------
#
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 09:54:11.161 UTC
# router bgp 65536
# bgp confederation identifier 4
# bgp router-id 192.0.2.10
# bgp cluster-id 5
# default-metric 5
# socket send-buffer-size 4098
# bgp bestpath med confed
# socket receive-buffer-size 514
# neighbor 192.0.2.13
# remote-as 65538
# bfd fast-detect strict-mode
# bfd multiplier 6
# bfd minimum-interval 20
# !
# vrf vrf1
# default-metric 5
# !
# !
#
- name: Purge all BGP configurations from the device
cisco.iosxr.iosxr_bgp_global:
state: purged
#
# Task Output:
# -------------
#
# before:
# as_number: '65536'
# bgp:
# bestpath:
# med:
# confed: true
# cluster_id: '5'
# confederation:
# identifier: 4
# router_id: 192.0.2.10
# default_metric: 5
# neighbors:
# - bfd:
# fast_detect:
# strict_mode: true
# minimum_interval: 20
# multiplier: 6
# neighbor_address: 192.0.2.13
# remote_as: 65538
# socket:
# receive_buffer_size: 514
# send_buffer_size: 4098
# vrfs:
# - default_metric: 5
# vrf: vrf1
#
# commands:
# - no router bgp 65536
#
# after: {}
#
# After state
# -----------
#
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 09:38:36.245 UTC
# % No such configuration item(s)
# RP/0/0/CPU0:10#
#
#
# Using Rendered
# -----------------
#
- name: >-
Render platform specific configuration lines (without connecting to the
device)
cisco.iosxr.iosxr_bgp_global:
state: rendered
config:
as_number: 1
default_metric: 4
vrfs:
- vrf: vrf3
bfd:
minimum_interval: 20
multiplier: 10
bgp:
fast_external_fallover:
disable: true
router_id: 1.2.3.4
auto_policy_soft_reset:
disable: true
timers:
keepalive_time: 20
holdtime: 30
- vrf: vrf2
bgp:
enforce_first_as:
disable: true
default_metric: 4
neighbors:
- neighbor: 1.1.1.3
remote_as: 2
graceful_maintenance:
set: true
activate:
inheritance_disable: true
local_preference:
value: 1
as_prepends:
value: 2
#
# Task output
# -----------------------
# rendered:
# - router bgp 1
# - default-metric 4
# - vrf vrf3
# - bfd multiplier 10
# - bfd minimum-interval 20
# - bgp auto-policy-soft-reset disable
# - bgp fast-external-fallover disable
# - bgp router-id 1.2.3.4
# - timers bgp 20 30
# - vrf vrf2
# - neighbor 1.1.1.3
# - remote-as 2
# - graceful-maintenance
# - graceful-maintenance activate inheritance-disable
# - graceful-maintenance local-preference 1
# - graceful-maintenance as-prepends 2
# - bgp enforce-first-as disable
# - default-metric 4
# Using parsed
#
# parsed.cfg
# ------------
# router bgp 65536
# bgp confederation identifier 4
# bgp router-id 192.0.2.10
# bgp cluster-id 5
# default-metric 4
# socket send-buffer-size 4098
# bgp bestpath med confed
# socket receive-buffer-size 514
# neighbor 192.0.2.11
# remote-as 65537
# cluster-id 3
# !
# neighbor 192.0.2.14
# remote-as 65538
# bfd fast-detect strict-mode
# bfd multiplier 6
# bfd minimum-interval 20
# !
# !
#
- name: Parse externally provided BGP config
cisco.iosxr.iosxr_bgp_global:
running_config: "{{ lookup('file', 'parsed.cfg') }}"
state: parsed
# Task output
# -----------------------
# parsed:
# as_number: '65536'
# bgp:
# bestpath:
# med:
# confed: true
# cluster_id: '5'
# confederation:
# identifier: 4
# router_id: 192.0.2.10
# default_metric: 4
# neighbors:
# - cluster_id: '3'
# neighbor_address: 192.0.2.11
# remote_as: 65537
# - bfd:
# fast_detect:
# strict_mode: true
# minimum_interval: 20
# multiplier: 6
# neighbor_address: 192.0.2.14
# remote_as: 65538
# socket:
# receive_buffer_size: 514
# send_buffer_size: 4098
# Using gathered
#
# Before state
# ------------
#
# RP/0/0/CPU0:10#show running-config router bgp
# Thu Feb 4 09:38:36.245 UTC
# router bgp 65536
# bgp confederation identifier 4
# bgp router-id 192.0.2.10
# bgp cluster-id 5
# default-metric 5
# socket send-buffer-size 4098
# bgp bestpath med confed
# socket receive-buffer-size 514
# neighbor 192.0.2.13
# remote-as 65538
# bfd fast-detect strict-mode
# bfd multiplier 6
# bfd minimum-interval 20
# !
# vrf vrf1
# default-metric 5
# !
# !
- name: Gather bgp global facts
cisco.iosxr.iosxr_bgp_global:
state: gathered
# Task Output:
# ------------
#
# gathered:
# as_number: '65536'
# bgp:
# bestpath:
# med:
# confed: true
# cluster_id: '5'
# confederation:
# identifier: 4
# router_id: 192.0.2.10
# default_metric: 5
# neighbors:
# - bfd:
# fast_detect:
# strict_mode: true
# minimum_interval: 20
# multiplier: 6
# neighbor_address: 192.0.2.13
# remote_as: 65538
# socket:
# receive_buffer_size: 514
# send_buffer_size: 4098
# vrfs:
# - default_metric: 5
# vrf: vrf1
返回值
常见返回值记录在此处,以下是此模块独有的字段
键 |
描述 |
---|---|
生成的配置模型调用。 返回: 当更改时 示例: |
|
模型调用之前的配置。 返回: 总是 示例: |
|
推送到远程设备的命令集。 返回: 总是 示例: |
|
从远程设备收集的网络资源的事实,以结构化数据的形式呈现。 返回: 当state 为 示例: |
|
在running_config选项中提供的设备原生配置,按照模块 argspec 解析为结构化数据。 返回: 当state 为 示例: |
|
任务中提供的配置以设备原生格式呈现(离线)。 返回: 当state 为 示例: |