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>。 | |
| 允许路由器平滑地投入或退出服务。 | |
| 所有具有平滑维护配置的邻居 选择 
 | |
| 设置 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 链路带宽。 | |
| 将所有多路径的累积 community dmz 链路带宽发送到 ebgp 邻居。 选择 
 | |
| 防止 ebgp-send-community-dmz 从父级继承 选择 
 | |
| set ebgp-send-community-dmz。 选择 
 | |
| 为此邻居启用出口对等工程。 | |
| 防止 egress-engineering 从父级继承 选择 
 | |
| set egress-engineering。 选择 
 | |
| 强制执行 EBGP 路由的第一个 AS | |
| 禁用强制执行第一个 AS 选择 
 | |
| 平滑维护的属性。这将导致邻居不优先选择来自此路由器的路由,而是选择备用路由。 这允许路由器平滑地投入或退出服务。 | |
| 路由将在激活时使用平滑维护属性进行通告,无论是在此处还是在路由器 bgp 配置下。 | |
| 防止激活从父级继承。 选择 
 | |
| 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 号 | |
| 记录每个邻居的更新消息。 | |
| 记录每个邻居的更新/通知消息。 | |
| 入站日志消息 | |
| 禁用入站消息日志记录。 选择 
 | |
| 防止消息日志从父级继承。 选择 
 | |
| 消息日志缓冲区大小的范围 <1-100>。 | |
| 出站日志消息 | |
| 禁用入站消息日志记录。 选择 
 | |
| 防止消息日志从父级继承。 选择 
 | |
| 消息日志缓冲区大小的范围 <1-100>。 | |
| 邻居路由器地址。 | |
| BGP 原始 AS 设置。 | |
| BGP 原始 AS 验证设置。 | |
| 禁用 RPKI 原始 AS 验证。 选择 
 | |
| 设置密码。 | |
| 指定后面将跟随加密的密码。 | |
| 防止密码从父级继承。 选择 
 | |
| 设置套接字和 BGP 接收缓冲区大小。示例 <512-131072>。 | |
| 邻居自治系统。 | |
| 设置套接字和 BGP 发送缓冲区大小。示例 <4096-131072>。 | |
| 使用此 TCP 打开模式建立 BGP 会话。 选择 
 | |
| 以管理方式关闭此邻居。 | |
| 防止关闭从父级继承 选择 
 | |
| shutdown。 选择 
 | |
| TCP 会话配置命令。 | |
| 最大分段大小。 | |
| 防止 mss 从父级继承 选择 
 | |
| TCP 初始最大分段大小。 | |
| 每个邻居的 BGP 计时器。 | |
| 保持时间 <3-65535> 或 0 禁用保持时间。 | |
| 保持活动间隔 <0-65535>。 | |
| 启用 EBGP TTL 安全。 | |
| 防止 ttl-security 从父级继承 选择 
 | |
| set ttl-security 选择 
 | |
| BGP 更新配置。 | |
| 入站更新消息处理。 | |
| 入站更新消息过滤 | |
| 属性筛选器配置。 | |
| 组的名称。 | |
| 更新过滤 syslog 消息。 | |
| 禁用更新过滤 syslog 消息。 选择 
 | |
| 已过滤的更新消息。 | |
| 存储已过滤的更新消息的缓冲区数。 | |
| 路由更新的来源。有关有效值,请参阅供应商文档。 | |
| 使用邻居组和会话组模板。 | |
| 从邻居组继承配置。 | |
| 从会话组继承地址族无关的配置 | |
| 为所有邻居启用不间断路由支持。 | |
| 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 链路带宽。 | |
| 将所有多路径的累积 community dmz 链路带宽发送到 ebgp 邻居。 选择 
 | |
| 防止 ebgp-send-community-dmz 从父级继承 选择 
 | |
| set ebgp-send-community-dmz。 选择 
 | |
| 为此邻居启用出口对等工程。 | |
| 防止 egress-engineering 从父级继承 选择 
 | |
| set egress-engineering。 选择 
 | |
| 强制执行 EBGP 路由的第一个 AS | |
| 禁用强制执行第一个 AS 选择 
 | |
| 平滑维护的属性。这将导致邻居不优先选择来自此路由器的路由,而是选择备用路由。 这允许路由器平滑地投入或退出服务。 | |
| 路由将在激活时使用平滑维护属性进行通告,无论是在此处还是在路由器 bgp 配置下。 | |
| 防止激活从父级继承。 选择 
 | |
| 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 号 | |
| 记录每个邻居的更新消息。 | |
| 记录每个邻居的更新/通知消息。 | |
| 入站日志消息 | |
| 禁用入站消息日志记录。 选择 
 | |
| 防止消息日志从父级继承。 选择 
 | |
| 消息日志缓冲区大小的范围 <1-100>。 | |
| 出站日志消息 | |
| 禁用入站消息日志记录。 选择 
 | |
| 防止消息日志从父级继承。 选择 
 | |
| 消息日志缓冲区大小的范围 <1-100>。 | |
| 邻居路由器地址。 | |
| BGP 原始 AS 设置。 | |
| BGP 原始 AS 验证设置。 | |
| 禁用 RPKI 原始 AS 验证。 选择 
 | |
| 设置密码。 | |
| 指定后面将跟随加密的密码。 | |
| 防止密码从父级继承。 选择 
 | |
| 设置套接字和 BGP 接收缓冲区大小。示例 <512-131072>。 | |
| 邻居自治系统。 | |
| 设置套接字和 BGP 发送缓冲区大小。示例 <4096-131072>。 | |
| 使用此 TCP 打开模式建立 BGP 会话。 选择 
 | |
| 以管理方式关闭此邻居。 | |
| 防止关闭从父级继承 选择 
 | |
| shutdown。 选择 
 | |
| TCP 会话配置命令。 | |
| 最大分段大小。 | |
| 防止 mss 从父级继承 选择 
 | |
| TCP 初始最大分段大小。 | |
| 每个邻居的 BGP 计时器。 | |
| 保持时间 <3-65535> 或 0 禁用保持时间。 | |
| 保持活动间隔 <0-65535>。 | |
| 启用 EBGP TTL 安全。 | |
| 防止 ttl-security 从父级继承 选择 
 | |
| set ttl-security 选择 
 | |
| BGP 更新配置。 | |
| 入站更新消息处理。 | |
| 入站更新消息过滤 | |
| 属性筛选器配置。 | |
| 组的名称。 | |
| 更新过滤 syslog 消息。 | |
| 禁用更新过滤 syslog 消息。 选择 
 | |
| 已过滤的更新消息。 | |
| 存储已过滤的更新消息的缓冲区数。 | |
| 路由更新的来源。有关有效值,请参阅供应商文档。 | |
| 使用邻居组和会话组模板。 | |
| 从邻居组继承配置。 | |
| 从会话组继承地址族无关的配置 | |
| 路由区分符。 | |
| 自动路由区分符。 选择 
 | |
| 设置套接字参数。 | |
| 套接字接收缓冲区大小。示例:<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 选项中提供的设备原生配置解析为结构化数据。 返回: 当state 为  示例:  | |
| 任务中提供的配置以设备原生格式呈现(离线)。 返回: 当state 为  示例:  | 
