cisco.ios.ios_bgp_global 模块 – 配置 BGP 的资源模块。

注意

此模块是 cisco.ios 集合 (版本 9.0.3) 的一部分。

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

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

要在 playbook 中使用它，请指定：cisco.ios.ios_bgp_global。

cisco.ios 1.3.0 中的新增功能

概要

• 此模块配置和管理 Cisco IOS 上全局 bgp 的属性。

参数

参数	注释
config 字典	BGP 配置选项的字典。
aggregate_addresses 列表 / 元素=字典	配置 BGP 聚合条目
address 字符串	指定聚合地址
advertise_map 字符串	设置通告属性的条件
as_confed_set 布尔值	生成 AS 联盟集路径信息 选项 false true
as_set 布尔值	生成 AS 集路径信息 选项 false true
attribute_map 字符串	设置聚合的属性
netmask 字符串	指定聚合掩码
summary_only 布尔值	从更新中过滤更具体的路由 选项 false true
suppress_map 字符串	有条件地从更新中过滤更具体的路由
as_number 字符串	自治系统编号
auto_summary 布尔值	启用自动网络编号汇总 选项 false true
bgp 字典	启用地址族并进入其配置模式
additional_paths 字典	BGP 表中的附加路径
install 布尔值	安装到 RIB 的附加路径 选项 false true
receive 布尔值	从邻居接收附加路径 选项 false true
select 字典	选择路径的选择标准
all 布尔值	选择所有可用路径 选项 false true
best 整数	选择最佳 N 条路径 (2-3)。
best_external 布尔值	选择最佳外部路径 选项 false true
group_best 布尔值	选择组最佳路径 选项 false true
send 布尔值	将附加路径发送给邻居 选项 false true
advertise_best_external 布尔值	向内部对等体通告最佳外部路径 选项 false true
aggregate_timer 整数	配置聚合计时器 请参考供应商文档以了解有效值
always_compare_med 布尔值	允许比较来自不同邻居的 MED 选项 false true
asnotation 布尔值	更改默认的 AS 普通表示法 asdot 表示法 选项 false true
bestpath_options 字典	更改默认最佳路径选择
aigp 布尔值	如果两条路径都没有 aigp，则忽略最佳路径比较 ignore 选项 false true
compare_routerid 布尔值	比较相同 EBGP 路径的路由器 ID 选项 false true
cost_community 布尔值	成本社区 选项 false true
igp_metric 布尔值	IGP 度量 在最佳路径选择中忽略 IGP 度量 选项 false true
med 字典	MED 属性
confed 布尔值	比较联盟路径之间的 MED 选项 false true
missing_as_worst 布尔值	将缺少的 MED 视为最不理想的 选项 false true
client_to_client 字典	配置客户端到客户端路由反射
all 布尔值	集群间和集群内 (默认) 选项 false true
intra_cluster 字符串	集群内反射 集群 ID 的集群内反射
set 布尔值	设置允许的路由反射 选项 false true
cluster_id 字符串	配置路由反射器集群 ID (对等体可能会重置) A.B.C.D/请参考供应商文档以了解有效的路由反射器集群 ID
confederation 字典	AS 联盟参数
identifier 字符串	设置路由域联盟 AS AS 编号
peers 字符串	BGP 联盟中的对等 AS AS 编号
consistency_checker 字典	一致性检查器
auto_repair 字典	自动修复
interval 整数	设置 bgp 一致性检查器 请参考供应商文档以了解有效值
set 布尔值	启用自动修复 选项 false true
error_message 字典	记录错误消息
interval 整数	设置 bgp 一致性检查器 请参考供应商文档以了解有效值
set 布尔值	启用错误消息 选项 false true
dampening 字典	启用路由抖动抑制
max_suppress 整数	抑制稳定路由的最大持续时间 请参考供应商文档以了解有效值
penalty_half_time 整数	惩罚的半衰期 请参考供应商文档以了解有效值
reuse_route_val 整数	开始重新使用路由的值 请参考供应商文档以了解有效值
route_map 字符串	路由映射，用于指定抑制的标准
suppress_route_val 整数	开始抑制路由的值 请参考供应商文档以了解有效值
default 字典	配置 BGP 默认值
ipv4_unicast 布尔值	默认情况下为对等体激活 ipv4-unicast 选项 false true ← (默认)
route_target 字典	基于路由目标属性控制行为
filter 布尔值	控制自动 VPN 路由目标过滤 选项 false true ← (默认)
deterministic_med 布尔值	从相邻 AS 通告的路径中选择最佳 MED 路径 选项 false true
dmzlink_bw 布尔值	使用 DMZ 链路带宽作为 BGP 多路径的权重 选项 false true
enforce_first_as 布尔值	强制执行 EBGP 路由的第一个 AS (默认) 选项 false true
enhanced_error 布尔值	启用 BGP 增强的错误处理 选项 false true
fast_external_fallover 布尔值	如果到直接连接的外部对等体的链路断开，则立即重置会话 选项 false true
graceful_restart 字典	优雅重启功能参数
extended 布尔值	启用优雅重启扩展 选项 false true
restart_time 整数	设置重启并恢复所需的最大时间 请参考供应商文档以了解有效值
set 布尔值	设置优雅重启 选项 false true
stalepath_time 整数	设置保留重启对等体的陈旧路径的最大时间 请参考供应商文档以了解有效值
graceful_shutdown 字典	优雅关闭功能参数
community 字符串	设置 Gshut 路由的社区 社区编号/以 aa:nn 格式表示的社区编号
local_preference 整数	设置 Gshut 路由的本地首选 请参考供应商文档以了解有效值
neighbors 字典	优雅地关闭所有邻居
activate 布尔值	激活所有邻居的优雅关闭 选项 false true
time 整数	以秒为单位的时间 请参考供应商文档以了解有效值
vrfs 字典	优雅地关闭所有 vrf 邻居
activate 布尔值	激活所有邻居的优雅关闭 选项 false true
time 整数	以秒为单位的时间 请参考供应商文档以了解有效值
inject_maps 列表 / 元素=字典	指定要注入前缀的路由映射
copy_attributes 布尔值	从聚合复制属性 选项 false true
exist_map_name 字符串	路由映射名称
name 字符串	路由映射名称
listen 字典	邻居子网范围监听器
limit 整数	设置动态子网范围邻居的最大限制 请参考供应商文档以了解有效值
range 字典	子网网络范围
host_with_subnet 字符串	IPv4 子网范围 (A.B.C.D/nn) IPv6 子网范围 (X:X:X:X::X/<0-128>)
peer_group 字符串	对等体组成员
log_neighbor_changes 布尔值	记录邻居上线/下线和重置原因 选项 false true
maxas_limit 整数	允许来自任何邻居的 AS-PATH 属性，并对 AS 数进行限制 请参考供应商文档以了解有效值
maxcommunity_limit 整数	允许来自任何邻居的 COMMUNITY 属性，并对社区数进行限制 请参考供应商文档以了解有效值
maxextcommunity_limit 整数	允许来自任何邻居的 EXTENDED COMMUNITY 属性，并对扩展社区数进行限制 请参考供应商文档以了解有效值
nexthop 字典	下一跳跟踪命令
route_map 字符串	有效下一跳的路由映射
trigger 字典	下一跳跟踪
delay 整数	设置触发下一跳跟踪的延迟 请参考供应商文档以了解有效值
enable 布尔值	启用下一跳跟踪 选项 false true
nopeerup_delay_options 字典	设置 BGP 在第一个对等体启动之前等待多长时间才能开始更新延迟或优雅重启计时器（以秒为单位）
cold_boot 整数	冷启动后等待第一个对等体启动的时间 请参考供应商文档以了解有效值
nsf_switchover 整数	NSF 切换后等待第一个对等体的时间 请参考供应商文档以了解有效值
post_boot 整数	系统已启动且所有对等体都关闭后，等待第一个对等体启动的时间 请参考供应商文档以了解有效值
user_initiated 整数	管理员用户手动清除 BGP 对等体后，等待第一个对等体的时间 请参考供应商文档以了解有效值
recursion 布尔值	下一跳的递归规则 通过主机对下一跳进行递归 选项 false true
redistribute_internal 布尔值	允许将 iBGP 重分发到 IGP 中（危险） 选项 false true
refresh 字典	refresh
max_eor_time 整数	配置刷新最大 EOR 时间 请参考供应商文档以了解有效值
stalepath_time 整数	配置刷新过期路径时间 请参考供应商文档以了解有效值
regexp 布尔值	选择正则表达式引擎 启用有界执行时间正则表达式引擎 选项 false true
route_map 布尔值	路由映射控制命令 使路由映射设置命令优先于 BGP 命令，例如 next-hop unchanged 选项 false true
router_id 字典	覆盖配置的路由器标识符（对等体将重置）
address 字符串	手动配置的路由器标识符 (A.B.C.D)
interface 字符串	使用接口上的 IPv4 地址
vrf 布尔值	VRF 特定的路由器 ID 配置 自动分配每个 VRF 的 BGP 路由器 ID 选项 false true
scan_time 整数	配置后台扫描程序间隔 请参考供应商文档以了解有效值
slow_peer 字典	配置慢速对等体
detection 字典	慢速对等体检测
set 布尔值	慢速对等体检测 选项 false true
threshold 整数	设置慢速对等体检测阈值 请参考供应商文档以了解有效值
split_update_group 字典	配置慢速对等体拆分更新组
dynamic 布尔值	动态地将慢速对等体拆分为慢速更新组 选项 false true
permanent 布尔值	将慢速对等体永久保留在慢速更新组中 选项 false true
snmp 布尔值	BGP SNMP 选项 BGP SNMP 陷阱选项 使用 cbgp Peer2Type 作为陷阱索引的一部分 选项 false true
soft_reconfig_backup 布尔值	仅在未协商路由刷新时才使用软重新配置入站 选项 false true
sso 布尔值	状态切换 仅为支持路由刷新的对等体启用 SSO 选项 false true
suppress_inactive 布尔值	抑制路由表中不存在的路由 选项 false true
transport 布尔值	全局启用/禁用传输会话参数 传输路径 MTU 检测 选项 false true
update_delay 整数	设置发送更新的最大初始延迟 请参考供应商文档以了解有效值
update_group 布尔值	管理 BGP 更新组中的对等体 基于策略拆分更新组 将具有 AS 覆盖的对等体保留在不同的更新组中 选项 false true
upgrade_cli 字典	升级到分层 AFI 模式
af_mode 布尔值	升级到 AFI 模式 选项 false true
set 布尔值	启用升级到分层 AFI 模式 选项 false true
bmp 字典	BGP 监控协议
buffer_size 整数	BMP 缓冲区大小 请参考供应商文档以了解有效值
initial_refresh 字典	初始刷新选项
delay 整数	初始刷新之前的延迟
skip 布尔值	跳过所有刷新 选项 false true
server 整数	服务器信息 请参考供应商文档以了解有效值
server_options 字典	bmp 服务器选项
activate 布尔值	激活服务器 选项 false true
address 字典	跳过所有刷新
host 字符串	主机地址
port 整数	端口号 BMP 服务器
default_information 布尔值	控制默认信息的分配 分发默认路由 选项 false true
default_metric 整数	设置重分发路由的度量 请参考供应商文档以了解有效值
distance 字典	定义管理距离
admin 字典	管理距离
acl 字符串	IP 标准访问列表编号 IP 标准扩展访问列表编号 标准访问列表名称
address 字符串	IP 源地址 (A.B.C.D)
distance 整数	管理距离 请参考供应商文档以了解有效值
wildcard_bit 字符串	通配符位 (A.B.C.D)
bgp 字典	BGP 距离
routes_external 整数	AS 外部路由的距离 请参考供应商文档以了解有效值
routes_internal 整数	AS 内部路由的距离 请参考供应商文档以了解有效值
routes_local 整数	本地路由的距离 请参考供应商文档以了解有效值
mbgp 字典	MBGP 距离
routes_external 整数	AS 外部路由的距离 请参考供应商文档以了解有效值
routes_internal 整数	AS 内部路由的距离 请参考供应商文档以了解有效值
routes_local 整数	本地路由的距离 请参考供应商文档以了解有效值
distributes 列表 / 元素=字典	过滤路由更新中的网络
acl 字符串	IP 访问列表编号/名称
gateway 字符串	过滤路由更新中的前缀
in 布尔值	过滤传入的路由更新 选项 false true
interface 字符串	接口详细信息
out 布尔值	过滤传出的路由更新 选项 false true
prefix 字符串	基于网关过滤传入的更新
maximum_paths 字典	通过多条路径转发数据包
eibgp 整数	将 eBGP 和 iBGP 路径都作为多路径
ibgp 整数	iBGP 多路径
paths 整数	路径数量
maximum_secondary_paths 字典	最大辅助路径
eibgp 整数	将 eBGP 和 iBGP 路径都作为辅助多路径
ibgp 整数	iBGP 辅助多路径
paths 整数	辅助路径数量
neighbors 别名：neighbor 列表 / 元素=字典	指定邻居路由器
activate 布尔值	为此邻居启用地址族 选项 false true
additional_paths 字典	与该邻居协商附加路径功能
disable 布尔值	为此邻居禁用附加路径 选项 false true
receive 布尔值	从邻居接收附加路径 选项 false true
send 布尔值	将附加路径发送给邻居 选项 false true
advertise 字典	向该邻居通告
additional_paths 字典	通告附加路径
all 布尔值	选择所有可用路径 选项 false true
best 整数	选择最佳 N 条路径 (2-3)。
group_best 布尔值	选择组最佳路径 选项 false true
best_external 布尔值	通告最佳外部（在 RR 中最佳内部）路径 选项 false true
diverse_path 字典	通告附加路径
backup 布尔值	多路径可以是备份路径 选项 false true
mpath 布尔值	多路径可以是多路径 选项 false true
advertise_map 字典	指定用于条件通告的路由映射
exist_map 字符串	只有在前缀符合条件存在时才通告前缀 条件路由映射名称
name 字符串	通告路由映射名称
non_exist_map 字符串	只有在前缀符合条件不存在时才通告前缀 条件路由映射名称
advertisement_interval 整数	发送 BGP 路由更新之间的最小间隔
aigp 字典	邻居上的 AIGP
enable 布尔值	启用 AIGP 选项 false true
send 字典	承载 AIGP 值的成本社区或 MED
cost_community 字典	承载 AIGP 值的成本扩展社区
id 整数	社区 ID 请参考供应商文档以了解有效值
poi 字典	插入点
igp_cost 布尔值	IGP 后的插入点 选项 false true
pre_bestpath 布尔值	在开头的插入点 选项 false true
transitive 布尔值	成本社区是可传递的 选项 false true
med 布尔值	承载 AIGP 值的 MED 选项 false true
allow_policy 布尔值	为此 IBGP 邻居启用策略支持 选项 false true
allowas_in 整数	接受其中包含我的 AS 的 as-path
as_override 布尔值	发送更新时覆盖匹配的 AS 号 发送更新时保持分隔视野 选项 false true
bmp_activate 字典	为 BGP 对等体激活 BMP 监控
all 布尔值	为所有服务器激活 BMP 监控 选项 false true
server 整数	为服务器激活 BMP BMP 服务器编号 请参考供应商文档以了解有效值
capability 字典	向对等体通告功能 向对等体通告 ORF 功能 向该邻居通告前缀列表 ORF 功能
both 布尔值	向该邻居发送和接收 ORF 的功能 选项 false true
receive 布尔值	从此邻居接收 ORF 的功能 选项 false true
send 布尔值	向该邻居发送 ORF 的功能 选项 false true
cluster_id 字符串	配置路由反射器集群 ID (对等体可能会重置) 作为 32 位数量的路由反射器集群 ID，或 IP 地址格式 (A.B.C.D) 的路由反射器集群 ID
default_originate 字典	向该邻居发起默认路由
route_map 字符串	用于指定发起默认值的条件的路由映射
set 布尔值	向该邻居发起默认路由 选项 false true
描述 字符串	邻居特定描述
disable_connected_check 布尔值	使用环回地址的一跳式EBGP对等体 选项 false true
distribute_list 字典	过滤到/来自此邻居的更新
acl 字符串	IP 访问列表编号/名称
in 布尔值	过滤传入更新 选项 false true
out 布尔值	过滤传出更新 选项 false true
dmzlink_bw 布尔值	传播DMZ链路带宽 选项 false true
ebgp_multihop 字典	允许不在直接连接网络上的EBGP邻居
enable 布尔值	允许不在直接连接网络上的EBGP邻居 选项 false true
hop_count 整数	最大跳数 请参考供应商文档以了解有效值
fall_over 字典	对等路由丢失时会话失效
bfd 字典	使用BFD检测故障
multi_hop 布尔值	强制BFD多跳检测故障 选项 false true
set 布尔值	设置bfd 选项 false true
single_hop 布尔值	强制BFD单跳检测故障 选项 false true
route_map 字符串	对等路由的路由映射
filter_list 字典	建立BGP过滤器
in 布尔值	过滤传入更新 选项 false true
out 布尔值	过滤传出更新 选项 false true
path_acl 字符串	AS路径访问列表
ha_mode 字典	高可用性模式
disable 布尔值	禁用优雅重启 选项 false true
set 布尔值	为该对等体设置ha-mode和优雅重启 选项 false true
inherit 字符串	继承模板 继承对等会话模板和模板名称
local_as 字典	指定本地AS号
dual_as 布尔值	接受来自ebgp对等体的真实AS或本地AS 选项 false true
no_prepend 字典	不要将本地AS添加到来自ebgp对等体的更新中
replace_as 布尔值	在EBGP更新中用本地AS替换真实AS 选项 false true
set 布尔值	设置预置 选项 false true
number 整数	用作本地AS的AS号 请参考供应商文档以了解有效值
set 布尔值	设置本地AS号 选项 false true
log_neighbor_changes 字典	记录邻居上线/下线和重置原因
disable 布尔值	禁用记录邻居上下线和重置 选项 false true
set 布尔值	设置记录邻居上下线和重置 选项 false true
maximum_prefix 字典	从该对等体接受的最大前缀数
max_no 整数	最大前缀限制数
restart 整数	超过限制后重启BGP连接
threshold_val 整数	生成警告消息的阈值（%）
warning_only 布尔值	仅在超过限制时发出警告消息 选项 false true
neighbor_address 字符串	邻居地址 (A.B.C.D) 邻居标签 邻居IPv6地址 (X:X:X:X::X)
next_hop_self 字典	禁用此邻居的下一跳计算
all 布尔值	为接收到的eBGP和iBGP路径启用next-hop-self 选项 false true
set 布尔值	启用next-hop-self 选项 false true
next_hop_unchanged 字典	将下一跳不变传播到此邻居的iBGP路径 将下一跳不变传播到此邻居的所有路径（iBGP和eBGP）
allpaths 布尔值	将下一跳不变传播到此邻居的所有路径（iBGP和eBGP） 选项 false true
set 布尔值	启用next-hop-unchanged 选项 false true
password_options 字典	设置具有加密类型的密码
encryption 整数	加密类型（0表示禁用加密，7表示专有）
pass_key 字符串	密码
path_attribute 字典	BGP可选属性过滤
discard 字典	丢弃此邻居的匹配路径属性
in 布尔值	执行入站路径属性过滤 选项 false true
range 字典	路径属性范围
end 整数	路径属性范围结束值 请参考供应商文档以了解有效值
start 整数	路径属性范围起始值 请参考供应商文档以了解有效值
type 整数	路径属性类型 请参考供应商文档以了解有效值
treat_as_withdraw 字典	将匹配的路径属性视为撤销此邻居
in 布尔值	执行入站路径属性过滤 选项 false true
range 字典	路径属性范围
end 整数	路径属性范围结束值 请参考供应商文档以了解有效值
start 整数	路径属性范围起始值 请参考供应商文档以了解有效值
type 整数	路径属性类型 请参考供应商文档以了解有效值
peer_group 字符串	对等体组成员
remote_as 字符串	指定BGP邻居 远程邻居的AS号
remove_private_as 字典	从传出更新中删除私有AS号
all 布尔值	删除所有私有AS号 选项 false true
replace_as 布尔值	用本地AS替换所有私有AS号 选项 false true
set 布尔值	删除私有AS号 选项 false true
route_maps 列表 / 元素=字典	将路由映射列表应用于邻居
in 布尔值	将映射应用于传入路由 选项 false true
name 字符串	用本地AS替换所有私有AS号
out 布尔值	将映射应用于传出路由 选项 false true
route_reflector_client 布尔值	将邻居配置为路由反射器客户端 选项 false true
route_server_client 字典	将邻居配置为路由服务器客户端
context 字符串	为邻居指定路由服务器上下文 路由服务器上下文名称
set 布尔值	设置路由服务器客户端 选项 false true
send_community 字典	将社区属性发送到此邻居
both 布尔值	发送标准和扩展社区属性 选项 false true
extended 布尔值	发送扩展社区属性 选项 false true
set 布尔值	将社区属性发送到此邻居 选项 false true
standard 布尔值	发送标准社区属性 选项 false true
send_label 字典	将NLRI + MPLS标签发送到此对等体
explicit_null 布尔值	通告显式空标签代替隐式空标签 选项 false true
set 布尔值	将NLRI + MPLS标签发送到此对等体 选项 false true
shutdown 字典	在管理上关闭此邻居
community 整数	设置 Gshut 路由的社区
graceful 整数	优雅地关闭此邻居 以秒为单位的时间 请参考供应商文档以了解有效值
local_preference 布尔值	设置 Gshut 路由的本地首选 选项 false true
set 布尔值	关闭 选项 false true
slow_peer 字典	配置慢速对等体
detection 字典	配置慢速对等体
disable 布尔值	禁用慢速对等体检测 选项 false true
启用 布尔值	启用慢速对等体检测 选项 false true
阈值 整数	设置慢速对等体检测阈值
拆分更新组 字典	配置慢速对等体拆分更新组
动态 字典	动态地将慢速对等体拆分为慢速更新组
禁用 布尔值	禁用慢速对等体检测 选项 false true
启用 布尔值	启用慢速对等体检测 选项 false true
永久 布尔值	将慢速对等体永久保留在慢速更新组中 选项 false true
静态 布尔值	静态慢速对等体 选项 false true
软重配置 布尔值	每个邻居的软重配置 允许为此邻居进行入站软重配置 选项 false true
计时器 字典	BGP每个邻居计时器
保持时间 整数	保持时间
间隔 整数	保持活动间隔
最小保持时间 整数	邻居的最小保持时间
转换更新 字典	将更新转换为MBGP格式
NLRI 字典	指定要转换到的NLRI类型
组播 布尔值	将更新转换为组播NLRI 选项 false true
单播 布尔值	将更新处理为单播NLRI 选项 false true
设置 布尔值	设置转换更新 选项 false true
传输 字典	传输选项
连接模式 字典	指定被动或主动连接
主动 布尔值	主动建立TCP会话 选项 false true
被动 布尔值	被动建立TCP会话 选项 false true
多会话 布尔值	使用多会话进行传输 选项 false true
路径MTU发现 字典	使用传输路径MTU发现
禁用 布尔值	禁用 选项 false true
设置 布尔值	使用路径MTU发现 选项 false true
TTL安全 整数	BGP TTL安全检查 最大跳数 请参考供应商文档以了解有效值
取消抑制映射 字符串	路由映射，用于选择性地取消抑制被抑制的路由 路由映射名称
更新源 字符串	路由更新的来源
版本 整数	设置BGP版本以匹配邻居 邻居的BGP版本 请参考供应商文档以了解有效值
权重 整数	设置来自此邻居的路由的默认权重
网络 列表 / 元素=字典	指定要通过BGP通告的网络
address 字符串	指定网络地址
后门 布尔值	指定BGP后门路由 选项 false true
netmask 字符串	指定网络掩码
route_map 字符串	路由映射，用于修改属性
重新分发 列表 / 元素=字典	从另一个路由协议重新分发信息
应用程序 字典	应用程序
度量 整数	重新分发路由的度量
name 字符串	应用程序名称
route_map 字符串	路由映射引用
bgp 字典	边界网关协议 (BGP)
as_number 字符串	自治系统编号
度量 整数	重新分发路由的度量
route_map 字符串	路由映射引用
连接的 字典	连接的
度量 整数	重新分发路由的度量
route_map 字符串	路由映射引用
set 布尔值	设置顶级属性 选项 false true
eigrp 字典	增强型内部网关路由协议 (EIGRP)
as_number 字符串	自治系统编号
度量 整数	重新分发路由的度量
route_map 字符串	路由映射引用
isis 字典	ISO IS-IS
区域标签 字符串	ISO路由区域标签
clns 布尔值	OSI动态路由的重新分发 选项 false true
ip 布尔值	IP动态路由的重新分发 选项 false true
度量 整数	重新分发路由的度量
route_map 字符串	路由映射引用
iso_igrp 字典	OSI网络的IGRP
区域标签 字符串	ISO路由区域标签
route_map 字符串	路由映射引用
lisp 字典	定位器ID分离协议 (LISP)
度量 整数	重新分发路由的度量
route_map 字符串	路由映射引用
set 布尔值	设置顶级属性 选项 false true
移动的 字典	移动路由
度量 整数	重新分发路由的度量
route_map 字符串	路由映射引用
set 布尔值	设置顶级属性 选项 false true
odr 字典	按需存根路由
度量 整数	重新分发路由的度量
route_map 字符串	路由映射引用
set 布尔值	设置顶级属性 选项 false true
ospf 字典	开放最短路径优先 (OSPF)
匹配 字典	按需存根路由
外部的 布尔值	重新分发OSPF外部路由 选项 false true
内部的 布尔值	重新分发OSPF内部路由 选项 false true
nssa_external 布尔值	重新分发OSPF NSSA外部路由 选项 false true
type_1 布尔值	重新分发NSSA外部类型1路由 选项 false true
type_2 布尔值	重新分发NSSA外部类型2路由 选项 false true
度量 整数	重新分发路由的度量
进程ID 整数	进程ID
route_map 字符串	路由映射引用
vrf 字符串	VPN路由/转发实例
ospfv3 字典	OSPFv3
匹配 字典	按需存根路由
外部的 布尔值	重新分发OSPF外部路由 选项 false true
内部的 布尔值	重新分发OSPF内部路由 选项 false true
nssa_external 布尔值	重新分发OSPF NSSA外部路由 选项 false true
type_1 布尔值	重新分发NSSA外部类型1路由 选项 false true
type_2 布尔值	重新分发NSSA外部类型2路由 选项 false true
度量 整数	重新分发路由的度量
进程ID 整数	进程ID
route_map 字符串	路由映射引用
rip 字典	路由信息协议 (RIP)
度量 整数	重新分发路由的度量
route_map 字符串	路由映射引用
set 布尔值	设置顶级属性 选项 false true
静态的 字典	静态路由
clns 布尔值	OSI静态路由的重新分发 选项 false true
ip 布尔值	IP静态路由的重新分发 选项 false true
度量 整数	重新分发路由的度量
route_map 字符串	路由映射引用
set 布尔值	设置顶级属性 选项 false true
vrf 字典	指定源VRF
全局的 布尔值	全局VRF 选项 false true
name 字符串	源VRF名称
同步 布尔值	执行IGP同步 选项 false true
表映射 字典	将外部条目属性映射到路由表
filter 布尔值	选择性路由下载 选项 false true
name 字符串	路由映射名称
模板 字典	进入模板命令模式
对等策略 字符串	策略参数的模板配置
对等会话 字符串	会话参数的模板配置
计时器 字典	调整路由计时器 BGP计时器
保持时间 整数	保持时间
保持活动 整数	保持活动间隔
最小保持时间 整数	邻居的最小保持时间
运行配置 字符串	此选项仅与状态 *已解析* 配合使用。 此选项的值应为通过执行命令 **sh running-config | section ^router bgp** 从IOS设备接收到的输出。 状态 *已解析* 从 running_config 选项读取配置并将其转换为Ansible结构化数据，该数据符合资源模块的argspec，然后该值在结果中的 *已解析* 密钥中返回。
状态 字符串	配置应保留的状态 该模块对已替换和已覆盖的状态具有声明性类似的行为。 状态 *已渲染*、*已收集* 和 *已解析* 不会对设备进行任何更改。 状态 *已渲染* 将 config 选项中的配置转换为特定于平台的CLI命令，这些命令将在结果中的 *已渲染* 密钥中返回。对于状态 *已渲染*，不需要与远程主机的活动连接。 状态 *已收集* 将从设备获取运行配置，并将其转换为符合资源模块argspec格式的结构化数据，该值在结果中的 *已收集* 密钥中返回。 状态 *已解析* 从 running_config 选项读取配置，并根据资源模块参数将其转换为JSON格式，该值在结果中的 *已解析* 密钥中返回。running_config 选项的值应与在设备上执行的命令 *show running-config | section ^router bgp* 的输出格式相同。对于状态 *已解析*，不需要与远程主机的活动连接。 选项 "merged" ← (默认) "已替换" "已覆盖" "已删除" "已清除" "已收集" "已渲染" "已解析"

注释

注意

• 在CML上的Cisco IOS-XE 17.3版本上进行了测试。

• 此模块与连接 network_cli 配合使用。参见 https://docs.ansible.org.cn/ansible/latest/network/user_guide/platform_ios.html

• 模块示例使用回调插件 (stdout_callback = yaml) 以yaml格式生成任务输出。

示例

# Using merged

# Before state:
# -------------
#
# vios#sh running-config | section ^router bgp

- name: Merge provided configuration with device configuration
  cisco.ios.ios_bgp_global:
    config:
      as_number: 65000
      bgp:
        advertise_best_external: true
        bestpath:
          - compare_routerid: true
        dampening:
          penalty_half_time: 1
          reuse_route_val: 1
          suppress_route_val: 1
          max_suppress: 1
        default:
          ipv4_unicast: false
          route_target:
            filter: true
        graceful_shutdown:
          neighbors:
            time: 50
          community: 100
          local_preference: 100
        log_neighbor_changes: true
        nopeerup_delay:
          - post_boot: 10
      networks:
        - address: 192.0.2.3
        - address: 192.0.2.2
      neighbor:
        - address: 192.0.2.1
          description: merge neighbor
          remote_as: 100
          aigp:
            send:
              cost_community:
                id: 100
                poi:
                  igp_cost: true
                  transitive: true
          route_map:
            name: test-route
            out: true
      redistribute:
        - connected:
            metric: 10
      timers:
        keepalive: 100
        holdtime: 200
        min_holdtime: 150
    state: merged

# Task Output:
# ------------
#
# before: {}
# commands:
# - router bgp 65000
# - timers bgp 100 200 150
# - bgp advertise-best-external
# - bgp bestpath compare-routerid
# - no bgp default ipv4-unicast
# - bgp dampening 1 1 1 1
# - bgp graceful-shutdown all neighbors 50 local-preference 100 community 100
# - bgp log-neighbor-changes
# - bgp nopeerup-delay post-boot 10
# - network 192.0.2.3
# - network 192.0.2.2
# - neighbor 192.0.2.1 remote-as 100
# - neighbor 192.0.2.1 description merge neighbor
# - neighbor 192.0.2.1 aigp send cost-community 100 poi igp-cost transitive
# - neighbor 192.0.2.1 route-map test-route out
# - redistribute connected metric 10
# after:
#   as_number: '65000'
#   bgp:
#     advertise_best_external: true
#     bestpath_options:
#       compare_routerid: true
#     dampening:
#       max_suppress: 1
#       penalty_half_time: 1
#       reuse_route_val: 1
#       suppress_route_val: 1
#     default:
#       ipv4_unicast: false
#       route_target:
#         filter: true
#     graceful_shutdown:
#       community: '100'
#       local_preference: 100
#       neighbors:
#         time: 50
#     log_neighbor_changes: true
#     nopeerup_delay_options:
#       post_boot: 10
#   neighbors:
#   - aigp:
#       send:
#         cost_community:
#           id: 100
#           poi:
#             igp_cost: true
#             transitive: true
#     description: merge neighbor
#     neighbor_address: 192.0.2.1
#     remote_as: '100'
#     route_maps:
#     - name: test-route
#       out: true
#   networks:
#   - address: 192.0.2.2
#   - address: 192.0.2.3
#   redistribute:
#   - connected:
#       metric: 10
#       set: true
#   timers:
#     holdtime: 200
#     keepalive: 100
#     min_holdtime: 150

# After state:
# ------------
#
# vios#sh running-config | section ^router bgp
# router bgp 65000
#  no bgp default ipv4-unicast
#  bgp log-neighbor-changes
#  bgp nopeerup-delay post-boot 10
#  bgp graceful-shutdown all neighbors 50 local-preference 100 community 100
#  bgp bestpath compare-routerid
#  bgp dampening 1 1 1 1
#  bgp advertise-best-external
#  network 192.0.2.2
#  network 192.0.2.3
#  timers bgp 100 200 150
#  redistribute connected metric 10
#  neighbor 192.0.2.1 remote-as 100
#  neighbor 192.0.2.1 description merge neighbor
#  neighbor 192.0.2.1 aigp send cost-community 100 poi igp-cost transitive
#  neighbor 192.0.2.1 route-map test-route out

# Using replaced

# Before state:
# -------------
#
# vios#sh running-config | section ^router bgp
# router bgp 65000
#  bgp nopeerup-delay post-boot 10
#  bgp graceful-shutdown all neighbors 50 local-preference 100 community 100
#  bgp bestpath compare-routerid
#  bgp dampening 1 1 1 1
#  network 192.0.2.2
#  network 192.0.2.3
#  bgp advertise-best-external
#  neighbor 198.0.2.1 remote-as 100
#  neighbor 198.0.2.1 description merge neighbor
#  neighbor 198.0.2.1 aigp send cost-community 100 poi igp-cost transitive
#  neighbor 198.0.2.1 route-map test-route out

- name: Replaces device configuration of listed global BGP with provided configuration
  cisco.ios.ios_bgp_global:
    config:
      as_number: 65000
      bgp:
        advertise_best_external: true
        bestpath:
          - med:
              confed: true
        log_neighbor_changes: true
        nopeerup_delay:
          - post_boot: 10
            cold_boot: 20
      networks:
        - address: 192.0.2.4
      neighbor:
        - address: 192.0.2.5
          description: replace neighbor
          remote_as: 100
          slow_peer:
            detection:
              disable: true
    state: replaced

# Task Output:
# ------------
#
# before:
#   as_number: '65000'
#   bgp:
#     advertise_best_external: true
#     bestpath_options:
#       compare_routerid: true
#     dampening:
#       max_suppress: 1
#       penalty_half_time: 1
#       reuse_route_val: 1
#       suppress_route_val: 1
#     default:
#       ipv4_unicast: true
#       route_target:
#         filter: true
#     graceful_shutdown:
#       community: '100'
#       local_preference: 100
#       neighbors:
#         time: 50
#     log_neighbor_changes: true
#     nopeerup_delay_options:
#       post_boot: 10
#   neighbors:
#   - aigp:
#       send:
#         cost_community:
#           id: 100
#           poi:
#             igp_cost: true
#             transitive: true
#     description: merge neighbor
#     neighbor_address: 198.0.2.1
#     remote_as: '100'
#     route_maps:
#     - name: test-route
#       out: true
#   networks:
#   - address: 192.0.2.2
#   - address: 192.0.2.3
#
# commands:
# - router bgp 65000
# - no bgp bestpath compare-routerid
# - bgp bestpath med confed
# - no bgp dampening 1 1 1 1
# - no bgp graceful-shutdown all neighbors 50 local-preference 100 community 100
# - bgp nopeerup-delay cold-boot 20
# - network 192.0.2.4
# - no network 192.0.2.2
# - no network 192.0.2.3
# - neighbor 192.0.2.5 remote-as 100
# - neighbor 192.0.2.5 description replace neighbor
# - neighbor 192.0.2.5 slow-peer detection disable
# - no neighbor 198.0.2.1
# after:
#   as_number: '65000'
#   bgp:
#     advertise_best_external: true
#     bestpath_options:
#       med:
#         confed: true
#     default:
#       ipv4_unicast: true
#       route_target:
#         filter: true
#     log_neighbor_changes: true
#     nopeerup_delay_options:
#       cold_boot: 20
#       post_boot: 10
#   neighbors:
#   - description: replace neighbor
#     neighbor_address: 192.0.2.5
#     remote_as: '100'
#     slow_peer:
#       detection:
#         disable: true
#   networks:
#   - address: 192.0.2.4

# After state:
# -------------
#
# vios#sh running-config | section ^router bgp
# router bgp 65000
#  bgp log-neighbor-changes
#  bgp nopeerup-delay cold-boot 20
#  bgp nopeerup-delay post-boot 10
#  bgp bestpath med confed
#  bgp advertise-best-external
#  network 192.0.2.4
#  neighbor 192.0.2.5 remote-as 100
#  neighbor 192.0.2.5 description replace neighbor
#  neighbor 192.0.2.5 slow-peer detection disable

# Using Deleted

# Before state:
# -------------
#
# vios#sh running-config | section ^router bgp
# router bgp 65000
#  bgp nopeerup-delay post-boot 10
#  bgp graceful-shutdown all neighbors 50 local-preference 100 community 100
#  bgp bestpath compare-routerid
#  bgp dampening 1 1 1 1
#  bgp advertise-best-external
#  neighbor 192.0.2.1 remote-as 100
#  neighbor 192.0.2.1 description merge neighbor
#  neighbor 192.0.2.1 aigp send cost-community 100 poi igp-cost transitive
#  neighbor 192.0.2.1 route-map test-route out

- name: "Delete global BGP (Note: This won't delete the configured global BGP)"
  cisco.ios.ios_bgp_global:
    config:
      as_number: 65000
    state: deleted

# Task Output:
# ------------
#
# before:
#   as_number: '65000'
#   bgp:
#     advertise_best_external: true
#     bestpath_options:
#       compare_routerid: true
#     dampening:
#       max_suppress: 1
#       penalty_half_time: 1
#       reuse_route_val: 1
#       suppress_route_val: 1
#     default:
#       ipv4_unicast: true
#       route_target:
#         filter: true
#     graceful_shutdown:
#       community: '100'
#       local_preference: 100
#       neighbors:
#         time: 50
#     log_neighbor_changes: true
#     nopeerup_delay_options:
#       post_boot: 10
#   neighbors:
#   - aigp:
#       send:
#         cost_community:
#           id: 100
#           poi:
#             igp_cost: true
#             transitive: true
#     description: merge neighbor
#     neighbor_address: 192.0.2.1
#     remote_as: '100'
#     route_maps:
#     - name: test-route
#       out: true
# commands:
# - router bgp 65000
# - no bgp advertise-best-external
# - no bgp bestpath compare-routerid
# - no bgp dampening 1 1 1 1
# - no bgp graceful-shutdown all neighbors 50 local-preference 100 community 100
# - no bgp log-neighbor-changes
# - no bgp nopeerup-delay post-boot 10
# - no neighbor 192.0.2.1
# after:
#   as_number: '65000'

# After state:
# -------------
#
# vios#sh running-config | section ^router bgp
# router bgp 65000

# Using Deleted without any config passed

# Before state:
# -------------
#
# vios#sh running-config | section ^router bgp
# router bgp 65000
#  bgp nopeerup-delay post-boot 10
#  bgp graceful-shutdown all neighbors 50 local-preference 100 community 100
#  bgp bestpath compare-routerid
#  bgp dampening 1 1 1 1
#  bgp advertise-best-external
#  neighbor 192.0.2.1 remote-as 100
#  neighbor 192.0.2.1 description merge neighbor
#  neighbor 192.0.2.1 aigp send cost-community 100 poi igp-cost transitive
#  neighbor 192.0.2.1 route-map test-route out

- name: Delete global BGP without config
  cisco.ios.ios_bgp_global:
    state: deleted

# Task Output:
# ------------
#
# before:
#   as_number: '65000'
#   bgp:
#     advertise_best_external: true
#     bestpath_options:
#       compare_routerid: true
#     dampening:
#       max_suppress: 1
#       penalty_half_time: 1
#       reuse_route_val: 1
#       suppress_route_val: 1
#     default:
#       ipv4_unicast: true
#       route_target:
#         filter: true
#     graceful_shutdown:
#       community: '100'
#       local_preference: 100
#       neighbors:
#         time: 50
#     log_neighbor_changes: true
#     nopeerup_delay_options:
#       post_boot: 10
#   neighbors:
#   - aigp:
#       send:
#         cost_community:
#           id: 100
#           poi:
#             igp_cost: true
#             transitive: true
#     description: merge neighbor
#     neighbor_address: 192.0.2.1
#     remote_as: '100'
#     route_maps:
#     - name: test-route
#       out: true
# commands:
# - router bgp 65000
# - no bgp advertise-best-external
# - no bgp bestpath compare-routerid
# - no bgp dampening 1 1 1 1
# - no bgp graceful-shutdown all neighbors 50 local-preference 100 community 100
# - no bgp nopeerup-delay post-boot 10
# - no neighbor 198.51.100.1
# after:
#   as_number: '65000'

# After state:
# -------------
#
# vios#sh running-config | section ^router bgp
# router bgp 65000

# Using purged - would delete all configuration

# Before state:
# -------------
#
# vios#sh running-config | section ^router bgp
# router bgp 65000
#  bgp nopeerup-delay post-boot 10
#  bgp graceful-shutdown all neighbors 50 local-preference 100 community 100
#  bgp bestpath compare-routerid
#  bgp dampening 1 1 1 1
#  bgp advertise-best-external
#  neighbor 192.0.2.1 remote-as 100
#  neighbor 192.0.2.1 description merge neighbor
#  neighbor 192.0.2.1 aigp send cost-community 100 poi igp-cost transitive
#  neighbor 192.0.2.1 route-map test-route out

- name:
    "Delete the configured global BGP (Note: This WILL delete the the configured
    global BGP)"
  cisco.ios.ios_bgp_global:
    state: purged

# Task Output:
# ------------
#
# before:
#   as_number: '65000'
#   bgp:
#     advertise_best_external: true
#     bestpath_options:
#       compare_routerid: true
#     default:
#       ipv4_unicast: true
#       route_target:
#         filter: true
#     dampening:
#       max_suppress: 1
#       penalty_half_time: 1
#       reuse_route_val: 1
#       suppress_route_val: 1
#     graceful_shutdown:
#       community: '100'
#       local_preference: 100
#       neighbors:
#         time: 50
#     log_neighbor_changes: true
#     nopeerup_delay_options:
#       post_boot: 10
#   neighbors:
#   - aigp:
#       send:
#         cost_community:
#           id: 100
#           poi:
#             igp_cost: true
#             transitive: true
#     description: merge neighbor
#     neighbor_address: 192.0.2.1
#     remote_as: '100'
#     route_maps:
#     - name: test-route
#       out: true
# commands:
#  - no router bgp 65000
# after: {}

# After state:
# -------------
#
# vios#sh running-config | section ^router bgp

# Using gathered

# Before state:
# -------------
#
# vios#sh running-config | section ^router bgp
# router bgp 65000
#  bgp log-neighbor-changes
#  bgp nopeerup-delay post-boot 10
#  bgp graceful-shutdown all neighbors 50 local-preference 100 community 100
#  bgp bestpath compare-routerid
#  bgp dampening 1 1 1 1
#  bgp advertise-best-external
#  network 192.0.2.3
#  timers bgp 100 200 150
#  redistribute connected metric 10
#  neighbor 192.0.2.1 remote-as 100
#  neighbor 192.0.2.1 description merge neighbor
#  neighbor 192.0.2.1 aigp send cost-community 100 poi igp-cost transitive
#  neighbor 192.0.2.1 route-map test-route out

- name: Gather facts for bgp_global
  cisco.ios.ios_bgp_global:
    config:
    state: gathered

# Task Output:
# ------------
#
# gathered:
#   as_number: '65000'
#   bgp:
#     advertise_best_external: true
#     bestpath_options:
#       compare_routerid: true
#     dampening:
#       max_suppress: 1
#       penalty_half_time: 1
#       reuse_route_val: 1
#       suppress_route_val: 1
#     default:
#       ipv4_unicast: true
#       route_target:
#         filter: true
#     graceful_shutdown:
#       community: '100'
#       local_preference: 100
#       neighbors:
#         time: 50
#     log_neighbor_changes: true
#     nopeerup_delay_options:
#       post_boot: 10
#   neighbors:
#   - aigp:
#       send:
#         cost_community:
#           id: 100
#           poi:
#             igp_cost: true
#             transitive: true
#     description: merge neighbor
#     neighbor_address: 192.0.2.1
#     remote_as: '100'
#     route_maps:
#     - name: test-route
#       out: true
#   networks:
#   - address: 192.0.2.3
#   redistribute:
#   - connected:
#       metric: 10
#       set: true
#   timers:
#     holdtime: 200
#     keepalive: 100
#     min_holdtime: 150

# Using Rendered

- name: Rendered the provided configuration with the existing running configuration
  cisco.ios.ios_bgp_global:
    config:
      aggregate_addresses:
        - address: 192.0.2.1
          attribute_map: testMap1
          netmask: 255.255.255.0
          summary_only: true
        - address: 192.0.2.2
          as_set: true
          netmask: 255.255.255.0
        - address: 192.0.2.3
          as_set: true
          netmask: 255.255.255.0
      as_number: "65000"
      auto_summary: true
      bgp:
        additional_paths:
          install: true
          receive: true
        aggregate_timer: 0
        always_compare_med: true
        asnotation: true
        bestpath_options:
          aigp: true
          compare_routerid: true
          med:
            confed: true
            missing_as_worst: true
        confederation:
          identifier: "22"
        consistency_checker:
          error_message:
            interval: 10
            set: true
        dampening:
          route_map: routeMap1Test
        deterministic_med: true
        graceful_restart:
          restart_time: 2
          stalepath_time: 22
        graceful_shutdown:
          community: "77"
          local_preference: 230
          vrfs:
            time: 31
        inject_maps:
          - copy_attributes: true
            exist_map_name: Testmap3
            name: map2
          - copy_attributes: true
            exist_map_name: Testmap2
            name: map1
        listen:
          limit: 200
          range:
            host_with_subnet: 192.0.2.1/24
            peer_group: PaulNetworkGroup
        log_neighbor_changes: true
        maxas_limit: 2
        maxcommunity_limit: 3
        maxextcommunity_limit: 3
        nexthop:
          route_map: RouteMap1
          trigger:
            delay: 2
        nopeerup_delay_options:
          cold_boot: 2
          nsf_switchover: 10
          post_boot: 22
          user_initiated: 22
        recursion: true
        redistribute_internal: true
        refresh:
          max_eor_time: 700
          stalepath_time: 800
        router_id:
          vrf: true
        scan_time: 22
        slow_peer:
          detection:
            threshold: 345
          split_update_group:
            dynamic: true
            permanent: true
        sso: true
        suppress_inactive: true
        update_delay: 2
        update_group: true
      bmp:
        buffer_size: 22
        server: 2
      distance:
        bgp:
          routes_external: 2
          routes_internal: 3
          routes_local: 4
        mbgp:
          routes_external: 2
          routes_internal: 3
          routes_local: 5
      distributes:
        - in: true
          prefix: prefixTest
        - gateway: gatewayTest
          out: true
        - acl: "300"
          interface: Loopback0
          out: true
      maximum_paths:
        ibgp: 2
        paths: 2
      maximum_secondary_paths:
        ibgp: 22
        paths: 22
      neighbors:
        - neighbor_address: 192.0.2.10
          remote_as: "64500"
          update_source: Loopback1
        - activate: true
          neighbor_address: 192.0.2.11
          remote_as: "45000"
          send_community:
            extended: true
        - activate: true
          neighbor_address: 192.0.2.12
          remote_as: "45000"
        - neighbor_address: 192.0.2.13
          remote_as: "6553601"
        - advertise:
            diverse_path:
              backup: true
          neighbor_address: 192.0.2.8
          route_reflector_client: true
        - neighbor_address: 192.0.2.9
          remote_as: "64500"
          route_maps:
            - in: true
              name: rmp1
            - in: true
              name: rmp2
          update_source: Loopback0
        - activate: true
          advertise:
            additional_paths:
              group_best: true
          neighbor_address: 2001:DB8::1037
        - neighbor_address: testNebTag
          peer_group: "5"
          soft_reconfiguration: true
          version: 4
      networks:
        - address: 192.0.2.15
          backdoor: true
          netmask: 55.255.255.0
          route_map: mp1
        - address: 192.0.2.16
          backdoor: true
          netmask: 255.255.255.0
          route_map: mp2
        - address: 192.0.2.17
          backdoor: true
          netmask: 255.255.255.0
          route_map: mp2
      redistribute:
        - static:
            metric: 33
            route_map: rmp1
            set: true
        - application:
            metric: 22
            name: app1
        - application:
            metric: 33
            name: app2
            route_map: mp1
        - connected:
            metric: 22
            set: true
        - mobile:
            metric: 211
            set: true
    state: rendered

# Task Output:
# ------------
#
# rendered:
# - router bgp 65000
# - auto-summary
# - bmp buffer-size 22
# - bmp server 2
# - distance bgp 2 3 4
# - distance mbgp 2 3 5
# - maximum-paths 2
# - maximum-paths ibgp 2
# - maximum-secondary-paths 22
# - maximum-secondary-paths ibgp 22
# - bgp additional-paths install receive
# - bgp aggregate-timer 0
# - bgp always-compare-med
# - bgp asnotation dot
# - bgp bestpath aigp ignore
# - bgp bestpath compare-routerid
# - bgp bestpath med confed missing-as-worst
# - bgp confederation identifier 22
# - bgp consistency-checker error-message interval 10
# - bgp dampening route-map routeMap1Test
# - bgp deterministic-med
# - bgp graceful-restart restart-time 2
# - bgp graceful-restart stalepath-time 22
# - bgp graceful-shutdown all vrfs 31 local-preference 230 community 77
# - bgp listen limit 200
# - bgp listen range 192.0.2.1/24 peer-group PaulNetworkGroup
# - bgp log-neighbor-changes
# - bgp maxas-limit 2
# - bgp maxcommunity-limit 3
# - bgp maxextcommunity-limit 3
# - bgp nexthop route-map RouteMap1
# - bgp nexthop trigger delay 2
# - bgp nopeerup-delay cold-boot 2
# - bgp nopeerup-delay post-boot 22
# - bgp nopeerup-delay nsf-switchover 10
# - bgp nopeerup-delay user-initiated 22
# - bgp recursion host
# - bgp redistribute-internal
# - bgp refresh max-eor-time 700
# - bgp refresh stalepath-time 800
# - bgp router-id vrf auto-assign
# - bgp scan-time 22
# - bgp slow-peer detection threshold 345
# - bgp slow-peer split-update-group dynamic permanent
# - bgp sso route-refresh-enable
# - bgp suppress-inactive
# - bgp update-delay 2
# - bgp update-group split as-override
# - bgp inject-map map2 exist-map Testmap3 copy-attributes
# - bgp inject-map map1 exist-map Testmap2 copy-attributes
# - distribute-list prefix prefixTest in
# - distribute-list gateway gatewayTest out
# - distribute-list 300 out Loopback0
# - aggregate-address 192.0.2.1 255.255.255.0 summary-only attribute-map testMap1
# - aggregate-address 192.0.2.2 255.255.255.0 as-set
# - aggregate-address 192.0.2.3 255.255.255.0 as-set
# - network 192.0.2.15 mask 55.255.255.0 route-map mp1 backdoor
# - network 192.0.2.16 mask 255.255.255.0 route-map mp2 backdoor
# - network 192.0.2.17 mask 255.255.255.0 route-map mp2 backdoor
# - neighbor 192.0.2.10 remote-as 64500
# - neighbor 192.0.2.10 update-source Loopback1
# - neighbor 192.0.2.11 remote-as 45000
# - neighbor 192.0.2.11 activate
# - neighbor 192.0.2.11 send-community extended
# - neighbor 192.0.2.12 remote-as 45000
# - neighbor 192.0.2.12 activate
# - neighbor 192.0.2.13 remote-as 6553601
# - neighbor 192.0.2.8 advertise diverse-path backup
# - neighbor 192.0.2.8 route-reflector-client
# - neighbor 192.0.2.9 remote-as 64500
# - neighbor 192.0.2.9 update-source Loopback0
# - neighbor 192.0.2.9 route-map rmp1 in
# - neighbor 192.0.2.9 route-map rmp2 in
# - neighbor 2001:DB8::1037 activate
# - neighbor 2001:DB8::1037 advertise additional-paths group-best
# - neighbor testNebTag peer-group 5
# - neighbor testNebTag soft-reconfiguration inbound
# - neighbor testNebTag version 4
# - redistribute static metric 33 route-map rmp1
# - redistribute application app1 metric 22
# - redistribute application app2 metric 33 route-map mp1
# - redistribute connected metric 22
# - redistribute mobile metric 211

# Using parsed

# File: parsed.cfg
# ----------------
#
# router bgp 65000
#  auto-summary
#  bmp buffer-size 22
#  bmp server 2
#  distance bgp 2 3 4
#  distance mbgp 2 3 5
#  maximum-paths 2
#  maximum-paths ibgp 2
#  maximum-secondary-paths 22
#  maximum-secondary-paths ibgp 22
#  description checking description as line
#  bgp additional-paths install receive
#  bgp aggregate-timer 0
#  bgp always-compare-med
#  bgp asnotation dot
#  bgp bestpath aigp ignore
#  bgp bestpath compare-routerid
#  bgp bestpath med confed missing-as-worst
#  bgp confederation identifier 22
#  bgp consistency-checker error-message interval 10
#  bgp dampening route-map routeMap1Test
#  bgp deterministic-med
#  bgp graceful-restart restart-time 2
#  bgp graceful-restart stalepath-time 22
#  bgp graceful-shutdown all vrfs 31 local-preference 230 community 77
#  bgp listen limit 200
#  bgp listen range 192.0.2.1/24 peer-group PaulNetworkGroup
#  bgp log-neighbor-changes
#  bgp maxas-limit 2
#  bgp maxcommunity-limit 3
#  bgp maxextcommunity-limit 3
#  bgp nexthop route-map RouteMap1
#  bgp nexthop trigger delay 2
#  bgp nopeerup-delay cold-boot 2
#  bgp nopeerup-delay post-boot 22
#  bgp nopeerup-delay nsf-switchover 10
#  bgp nopeerup-delay user-initiated 22
#  bgp recursion host
#  bgp redistribute-internal
#  bgp refresh max-eor-time 700
#  bgp refresh stalepath-time 800
#  bgp router-id vrf auto-assign
#  bgp scan-time 22
#  bgp slow-peer detection threshold 345
#  bgp slow-peer split-update-group dynamic permanent
#  bgp sso route-refresh-enable
#  bgp suppress-inactive
#  bgp update-delay 2
#  bgp update-group split as-override
#  bgp inject-map map2 exist-map Testmap3 copy-attributes
#  bgp inject-map map1 exist-map Testmap2 copy-attributes
#  distribute-list prefix prefixTest in
#  distribute-list gateway gatewayTest out
#  distribute-list 300 out Loopback0
#  aggregate-address 192.0.2.1 255.255.255.0 summary-only attribute-map testMap1
#  aggregate-address 192.0.2.2 255.255.255.0 as-set
#  aggregate-address 192.0.2.3 255.255.255.0 as-set
#  network 192.0.2.15 mask 55.255.255.0 route-map mp1 backdoor
#  network 192.0.2.16 mask 255.255.255.0 route-map mp2 backdoor
#  network 192.0.2.17 mask 255.255.255.0 route-map mp2 backdoor
#  neighbor 192.0.2.8 advertise diverse-path backup
#  neighbor 192.0.2.8 route-reflector-client
#  neighbor 192.0.2.9 remote-as 64500
#  neighbor 192.0.2.9 update-source Loopback0
#  neighbor 192.0.2.9 route-map rmp1 in
#  neighbor 192.0.2.9 route-map rmp2 in
#  neighbor 192.0.2.10 remote-as 64500
#  neighbor 192.0.2.10 update-source Loopback1
#  neighbor 192.0.2.11 remote-as 45000
#  neighbor 192.0.2.11 activate
#  neighbor 192.0.2.11 send-community extended
#  neighbor 192.0.2.12 remote-as 45000
#  neighbor 192.0.2.12 activate
#  neighbor 192.0.2.13 remote-as 6553601
#  neighbor 192.0.2.13 shutdown graceful 10 community 20
#  neighbor 2001:DB8::1037 activate
#  neighbor 2001:DB8::1037 advertise additional-paths group-best
#  neighbor testNebTag peer-group 5
#  neighbor testNebTag soft-reconfiguration inbound
#  neighbor testNebTag version 4
#  redistribute static metric 33 route-map rmp1
#  redistribute application app1 metric 22
#  redistribute application app2 metric 33 route-map mp1
#  redistribute connected metric 22
#  redistribute mobile metric 21

- name: Parse the commands for provided configuration
  cisco.ios.ios_bgp_global:
    running_config: "{{ lookup('file', 'parsed.cfg') }}"
    state: parsed

# Task Output:
# ------------
#
# parsed:
#     aggregate_addresses:
#     - address: 192.0.2.1
#       attribute_map: testMap1
#       netmask: 255.255.255.0
#       summary_only: true
#     - address: 192.0.2.2
#       as_set: true
#       netmask: 255.255.255.0
#     - address: 192.0.2.3
#       as_set: true
#       netmask: 255.255.255.0
#     as_number: '65000'
#     auto_summary: true
#     bgp:
#       additional_paths:
#         install: true
#         receive: true
#       aggregate_timer: 0
#       always_compare_med: true
#       asnotation: true
#       bestpath_options:
#         aigp: true
#         compare_routerid: true
#         med:
#           confed: true
#           missing_as_worst: true
#       confederation:
#         identifier: '22'
#       consistency_checker:
#         error_message:
#           interval: 10
#           set: true
#       dampening:
#         route_map: routeMap1Test
#       deterministic_med: true
#       graceful_restart:
#         restart_time: 2
#         stalepath_time: 22
#       graceful_shutdown:
#         community: '77'
#         local_preference: 230
#         vrfs:
#           time: 31
#       inject_maps:
#       - copy_attributes: true
#         exist_map_name: Testmap3
#         name: map2
#       - copy_attributes: true
#         exist_map_name: Testmap2
#         name: map1
#       listen:
#         limit: 200
#         range:
#           host_with_subnet: 192.0.2.1/24
#           peer_group: PaulNetworkGroup
#       log_neighbor_changes: true
#       maxas_limit: 2
#       maxcommunity_limit: 3
#       maxextcommunity_limit: 3
#       nexthop:
#         route_map: RouteMap1
#         trigger:
#           delay: 2
#       nopeerup_delay_options:
#         cold_boot: 2
#         nsf_switchover: 10
#         post_boot: 22
#         user_initiated: 22
#       recursion: true
#       redistribute_internal: true
#       refresh:
#         max_eor_time: 700
#         stalepath_time: 800
#       router_id:
#         vrf: true
#       scan_time: 22
#       slow_peer:
#         detection:
#           threshold: 345
#         split_update_group:
#           dynamic: true
#           permanent: true
#       sso: true
#       suppress_inactive: true
#       update_delay: 2
#       update_group: true
#     bmp:
#       buffer_size: 22
#       server: 2
#     distance:
#       bgp:
#         routes_external: 2
#         routes_internal: 3
#         routes_local: 4
#       mbgp:
#         routes_external: 2
#         routes_internal: 3
#         routes_local: 5
#     distributes:
#     - in: true
#       prefix: prefixTest
#     - gateway: gatewayTest
#       out: true
#     - acl: '300'
#       interface: Loopback0
#       out: true
#     maximum_paths:
#       ibgp: 2
#       paths: 2
#     maximum_secondary_paths:
#       ibgp: 22
#       paths: 22
#     neighbors:
#     - neighbor_address: 192.0.2.10
#       remote_as: '64500'
#       update_source: Loopback1
#     - activate: true
#       neighbor_address: 192.0.2.11
#       remote_as: '45000'
#       send_community:
#         extended: true
#     - activate: true
#       neighbor_address: 192.0.2.12
#       remote_as: '45000'
#     - neighbor_address: 192.0.2.13
#       remote_as: '6553601'
#     - advertise:
#         diverse_path:
#           backup: true
#       neighbor_address: 192.0.2.8
#       route_reflector_client: true
#     - neighbor_address: 192.0.2.9
#       remote_as: '64500'
#       route_maps:
#       - in: true
#         name: rmp1
#       - in: true
#         name: rmp2
#       update_source: Loopback0
#     - activate: true
#       advertise:
#         additional_paths:
#           group_best: true
#       neighbor_address: 2001:DB8::1037
#     - neighbor_address: testNebTag
#       peer_group: '5'
#       soft_reconfiguration: true
#       version: 4
#     networks:
#     - address: 192.0.2.15
#       backdoor: true
#       netmask: 55.255.255.0
#       route_map: mp1
#     - address: 192.0.2.16
#       backdoor: true
#       netmask: 255.255.255.0
#       route_map: mp2
#     - address: 192.0.2.17
#       backdoor: true
#       netmask: 255.255.255.0
#       route_map: mp2
#     redistribute:
#     - static:
#         metric: 33
#         route_map: rmp1
#         set: true
#     - application:
#         metric: 22
#         name: app1
#     - application:
#         metric: 33
#         name: app2
#         route_map: mp1
#     - connected:
#         metric: 22
#         set: true
#     - mobile:
#         metric: 21
#         set: true

返回值

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

键	描述
之后 字典	模块执行后的最终配置。 已返回：发生更改时 示例： "This output will always be in the same format as the module argspec.\n"
之前 字典	模块执行之前的配置。 已返回：当 *状态* 为 merged、replaced、overridden、deleted 或 purged 时 示例： "This output will always be in the same format as the module argspec.\n"
命令 列表 / 元素=字符串	推送到远程设备的命令集。 已返回：当 *状态* 为 merged、replaced、overridden、deleted 或 purged 时 示例： ["router bgp 65000", "neighbor 198.51.100.1 aigp send cost-community 100 poi igp-cost transitive", "bgp graceful-shutdown all neighbors 50 local-preference 100 community 100"]
已收集 列表 / 元素=字符串	从远程设备收集到的网络资源信息，作为结构化数据。 已返回：当 *状态* 为 gathered 时 示例： ["This output will always be in the same format as the module argspec.\n"]
已解析 列表 / 元素=字符串	根据模块argspec，将*运行配置*选项中提供的设备原生配置解析为结构化数据。 已返回：当 *状态* 为 parsed 时 示例： ["This output will always be in the same format as the module argspec.\n"]
已渲染 列表 / 元素=字符串	以设备原生格式（离线）呈现的任务中提供的配置。 已返回：当 *状态* 为 rendered 时 示例： ["router bgp 65000", "neighbor 198.51.100.1 aigp send cost-community 100 poi igp-cost transitive", "bgp graceful-shutdown all neighbors 50 local-preference 100 community 100"]

作者

• Sumit Jaiswal (@justjais)

• Sagar Paul (@KB-perByte)

集合链接

• 问题跟踪器
• 存储库（源代码）