cisco.nxos.nxos_bgp_templates 模块 – BGP 模板资源模块。

注意

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

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

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

要在剧本中使用它，请指定： cisco.nxos.nxos_bgp_templates。

cisco.nxos 4.2.0 中的新功能

概要

• 此模块管理运行 Cisco NX-OS 的设备上的 BGP 模板。

参数

参数	注释
config 字典	BGP 模板的列表。
as_number 字符串	路由器的自治系统编号。
neighbor 列表 / elements=dictionary	配置 BGP 对等模板。
address_family 列表 / elements=dictionary	配置对等的地址族。
advertise_map 字典	为条件性通告指定路由映射。
exist_map 字符串	仅当条件中存在前缀时才通告的条件路由映射。
non_exist_map 字符串	仅当条件中不存在前缀时才通告的条件路由映射。
route_map 字符串 / 必填	路由映射名称。
advertisement_interval 整数	发送 BGP 路由更新之间的最小间隔。
afi 字符串 / 必填	地址族指示器。 选项 "ipv4" "ipv6" "link-state" "l2vpn"
allowas_in 字典	接受 AS 路径中包含我的 AS 的 AS 路径。
max_occurences 整数	AS 号的出现次数，默认值为 3。
set 布尔值	激活 allowas-in 属性。 选项 false true
as_override 布尔值	在发送更新时覆盖匹配的 AS 号。 选项 false true
capability 字典	向对等体通告功能。
additional_paths 字典	附加路径功能。
receive 字符串	附加路径接收功能。 选项 "enable" "disable"
send 字符串	附加路径发送功能。 选项 "enable" "disable"
default_originate 字典	向此对等体发起默认路由。
route_map 字符串	指定发起默认路由标准的路由映射。
set 布尔值	设置 default-originate 属性。 选项 false true
disable_peer_as_check 布尔值	禁用在通告时检查对等 AS 号。 选项 false true
filter_list 字典	过滤器列表的名称。
inbound 字符串	将策略应用于传入路由。
outbound 字符串	将策略应用于传出路由。
inherit 字典	继承对等策略模板。
peer_policy 字符串	要继承的对等策略模板。
maximum_prefix 字典	来自此邻居的最大前缀数。
generate_warning_threshold 整数	生成警告的阈值百分比。
max_prefix_limit 整数	最大前缀限制。
restart_interval 整数	超过限制后重新启动 BGP 连接。
warning_only 布尔值	超过限制时仅发出警告消息。 选项 false true
next_hop_self 字典	将我们的地址设置为下一跳（非反射）。
all_routes 布尔值	将我们的地址设置为所有路由的下一跳。 选项 false true
set 布尔值	设置 next-hop-self 属性。 选项 false true
next_hop_third_party 布尔值	如果可能，计算第三方下一跳。 选项 false true
prefix_list 字典	应用前缀列表。
inbound 字符串	将策略应用于传入路由。
outbound 字符串	将策略应用于传出路由。
route_map 字典	将路由映射应用于邻居。
inbound 字符串	要应用于传入路由的策略的名称。
outbound 字符串	要应用于传出路由的策略的名称。
route_reflector_client 布尔值	将邻居配置为路由反射器客户端。 选项 false true
safi 字符串	子地址族指示器。 选项 "unicast" "multicast" "mvpn" "evpn"
send_community 字符串	将 Community 属性发送到此邻居。 选项 "standard" "extended" "both"
soft_reconfiguration_inbound 字典	软重配置。
always 布尔值	始终执行入站软重配置。 选项 false true
set 布尔值	设置 soft-reconfiguration inbound 属性。 选项 false true
soo 字符串	指定站点源 extcommunity。
suppress_inactive 布尔值	仅向对等体通告活动路由。 选项 false true
unsuppress_map 字符串	有选择地取消抑制抑制路由的路由映射。
weight 整数	为此邻居的路由设置默认权重。
bfd 字典	邻居的双向快速检测。
multihop 字典	多跳会话。
interval 字典	配置 BFD 会话间隔参数。
min_rx_interval 整数 / 必填	最小 RX 间隔。
multiplier 整数 / 必填	检测乘数。
tx_interval 整数 / 必填	TX 间隔（毫秒）。
set 布尔值	设置 BFD 多跳。 选项 false true
set 布尔值	为此邻居设置 BFD。 选项 false true
singlehop 布尔值	单跳会话。 选项 false true
bmp_activate_server 整数	指定用于激活对等体的 BMP 监控的服务器 ID。
capability 字典	能力。
suppress_4_byte_as 布尔值	禁止 4 字节 AS 能力。 选项 false true
description 字符串	邻居特定描述。
disable_connected_check 布尔值	禁用直接连接对等体的检查。 选项 false true
dont_capability_negotiate 布尔值	不与此邻居协商能力。 选项 false true
dscp 字符串	设置 TCP 传输的 DSCP 值。
dynamic_capability 布尔值	动态能力 选项 false true
ebgp_multihop 整数	指定远程对等体的多跳 TTL。
graceful_shutdown 字典	此邻居的平滑关闭。
activate 字典	发送平滑关闭社团属性。
route_map 字符串	应用路由映射以修改出站属性。
set 布尔值	设置激活。 选项 false true
inherit 字典	继承模板。
peer_session 字符串	要继承的对等会话模板。
local_as 字符串	指定 eBGP 邻居的本地 AS 号。
log_neighbor_changes 字典	记录邻居启动/关闭事件的消息。
disable 布尔值	禁用邻居启动/关闭事件的日志记录。 选项 false true
set 布尔值	设置 log-neighbor-changes。 选项 false true
low_memory 字典	在低内存情况下的行为。
exempt 布尔值	在内存压力下不要关闭此对等体。 选项 false true
name 字符串	BGP 对等模板的名称。
password 字典	为邻居配置密码。
encryption 整数	0 指定未加密的邻居密码。 3 指定将跟随 3DES 加密的邻居密码。 7 指定将跟随 Cisco 类型 7 加密的邻居密码。
key 字符串	身份验证密码。
path_attribute 列表 / elements=dictionary	BGP 路径属性可选过滤。
action 字符串	操作。 选项 "discard" "treat-as-withdraw"
range 字典	路径属性范围。
end 整数	路径属性范围结束值。
start 整数	路径属性范围起始值。
type 整数	路径属性类型
remote_as 字符串	指定邻居的自治系统号。
remove_private_as 字典	从出站更新中删除私有 AS 号。
all 布尔值	全部。 选项 false true
replace_as 布尔值	替换。 选项 false true
set 布尔值	删除私有 AS。 选项 false true
shutdown 布尔值	以管理方式关闭此邻居。 选项 false true
timers 字典	配置保活和保持定时器。
holdtime 整数	保持时间（秒）。
keepalive 整数	保活间隔（秒）。
transport 字典	BGP 传输连接。
connection_mode 字典	指定连接类型。
passive 布尔值	仅允许被动连接设置。 选项 false true
ttl_security 字典	启用 TTL 安全机制。
hops 整数	指定远程对等体的跳数。
update_source 字符串	指定 BGP 会话和更新的源。
running_config 字符串	此选项仅在状态为 parsed 时使用。 此选项的值应为通过执行命令 show running-config bgp | section 'template' 从 NX-OS 设备接收的输出。 状态 parsed 从 running_config 选项读取配置，并按照资源模块的 argspec 将其转换为 Ansible 结构化数据，然后该值将返回到结果中的 parsed 键中。
state 字符串	配置应保留的状态。 有关更多详细信息，请参阅示例。 选项 "merged" ← (默认) "replaced" "overridden" "deleted" "parsed" "gathered" "rendered"

注释

注意

• 已针对 NX-OS 9.3.6 进行测试。

• 不支持 Cisco MDS

• 此模块适用于连接 network_cli 和 httpapi。

示例

# Using merged

# Before state:
# --------------
#
# nxos9k# show running-config | section "^router bgp"
# nxos9k#

- name: Merge the provided configuration with the existing running configuration
  cisco.nxos.nxos_bgp_templates:
    config:
      as_number: 65536
      neighbor:
        - name: neighbor_tmplt_1
          address_family:
            - afi: ipv4
              safi: unicast
              advertise_map:
                route_map: rmap1
                non_exist_map: nemap1
              advertisement_interval: 60
              disable_peer_as_check: true
          bmp_activate_server: 2
          capability:
            suppress_4_byte_as: true
          description: Test_BGP_PEER_TEMPLATE_1
          local_as: 65536
          remote_as: 65001

        - name: neighbor_tmplt_2
          description: Test_BGP_PEER_TEMPLATE_2
          address_family:
            - afi: ipv4
              safi: multicast
              advertise_map:
                route_map: rmap1
                exist_map: emap1
              as_override: true
              filter_list:
                inbound: flist1
                outbound: flist2
          inherit:
            peer_session: psession1
          timers:
            holdtime: 100
            keepalive: 45
# Task Output:
# ------------
# before: {}
#
# commands:
#   - router bgp 65536
#   - template peer neighbor_tmplt_1
#   - bmp-activate-server 2
#   - capability suppress 4-byte-as
#   - description Test_BGP_PEER_TEMPLATE_1
#   - local-as 65536
#   - remote-as 65001
#   - address-family ipv4 unicast
#   - advertise-map rmap1 non-exist-map nemap1
#   - advertisement-interval 60
#   - disable-peer-as-check
#   - template peer neighbor_tmplt_2
#   - description Test_BGP_PEER_TEMPLATE_2
#   - inherit peer-session psession1
#   - timers 45 100
#   - address-family ipv4 multicast
#   - advertise-map rmap1 exist-map emap1
#   - as-override
#   - filter-list flist1 in
#   - filter-list flist2 out
#
# after:
#   as_number: "65536"
#   neighbor:
#     - name: neighbor_tmplt_1
#       address_family:
#         - afi: ipv4
#           safi: unicast
#           advertise_map:
#             non_exist_map: nemap1
#             route_map: rmap1
#           advertisement_interval: 60
#           disable_peer_as_check: true
#       bmp_activate_server: 2
#       capability:
#         suppress_4_byte_as: true
#       description: Test_BGP_PEER_TEMPLATE_1
#       local_as: "65536"
#       remote_as: "65001"
#
#     - name: neighbor_tmplt_2
#       description: Test_BGP_PEER_TEMPLATE_2
#       address_family:
#         - afi: ipv4
#           safi: multicast
#           advertise_map:
#             exist_map: emap1
#             route_map: rmap1
#           as_override: true
#           filter_list:
#             inbound: flist1
#             outbound: flist2
#       inherit:
#         peer_session: psession1
#       timers:
#         holdtime: 100
#         keepalive: 45

# After state:
# --------------
#
# nxos9k# show running-config | section "^router bgp"
# router bgp 65536
#   template peer neighbor_tmplt_1
#     capability suppress 4-byte-as
#     bmp-activate-server 2
#     description Test_BGP_PEER_TEMPLATE_1
#     local-as 65536
#     remote-as 65001
#     address-family ipv4 unicast
#      advertise-map rmap1 non-exist-map nemap1
#      advertisement-interval 60
#      disable-peer-as-check
#   template peer neighbor_tmplt_2
#     description Test_BGP_PEER_TEMPLATE_2
#     inherit peer-session psession1
#     timers 45 100
#     address-family ipv4 multicast
#      advertise-map rmap1 exist-map emap1
#      as-override
#      filter-list flist1 in
#      filter-list flist2 out

# Using replaced

# Before state:
# -------------
#
# nxos9k# show running-config | section "^router bgp"
# router bgp 65536
#   template peer neighbor_tmplt_1
#     capability suppress 4-byte-as
#     description Test_BGP_PEER_TEMPLATE_1
#     bmp-activate-server 2
#     local-as 65536
#     remote-as 65001
#     address-family ipv4 unicast
#      advertise-map rmap1 non-exist-map nemap1
#      advertisement-interval 60
#      disable-peer-as-check
#   template peer neighbor_tmplt_2
#     description Test_BGP_PEER_TEMPLATE_2
#     inherit peer-session psession1
#     timers 45 100
#     address-family ipv4 multicast
#      advertise-map rmap1 exist-map emap1
#      as-override
#      filter-list flist1 in
#      filter-list flist2 out

- name: Replace BGP templates configuration with provided configuration
  cisco.nxos.nxos_bgp_templates:
    config:
      as_number: 65536
      neighbor:
        - name: neighbor_tmplt_1
          address_family:
            - afi: ipv4
              safi: unicast
              advertise_map:
                route_map: rmap1
                non_exist_map: nemap1
              advertisement_interval: 60
              disable_peer_as_check: true
          inherit:
            peer_session: psession1
          description: Test_BGP_PEER_TEMPLATE_1
          local_as: 65537
    state: replaced

# Task output:
# ------------
#
# before:
#   as_number: "65536"
#   neighbor:
#     - name: neighbor_tmplt_1
#       address_family:
#         - afi: ipv4
#           safi: unicast
#           advertise_map:
#             non_exist_map: nemap1
#             route_map: rmap1
#           advertisement_interval: 60
#           disable_peer_as_check: true
#       bmp_activate_server: 2
#       capability:
#         suppress_4_byte_as: true
#       description: Test_BGP_PEER_TEMPLATE_1
#       local_as: "65536"
#       remote_as: "65001"
#
#     - name: neighbor_tmplt_2
#       description: Test_BGP_PEER_TEMPLATE_2
#       address_family:
#         - afi: ipv4
#           safi: multicast
#           advertise_map:
#             exist_map: emap1
#             route_map: rmap1
#           as_override: true
#           filter_list:
#             inbound: flist1
#             outbound: flist2
#       inherit:
#         peer_session: psession1
#       timers:
#         holdtime: 100
#         keepalive: 45
#
# commands:
#   - router bgp 65536
#   - template peer neighbor_tmplt_1
#   - no bmp-activate-server 2
#   - no capability suppress 4-byte-as
#   - inherit peer-session psession1
#   - local-as 65537
#   - no remote-as 65001
#
# after:
#   as_number: "65536"
#   neighbor:
#     - name: neighbor_tmplt_1
#       address_family:
#         - afi: ipv4
#           safi: unicast
#           advertise_map:
#             non_exist_map: nemap1
#             route_map: rmap1
#           advertisement_interval: 60
#           disable_peer_as_check: true
#       description: Test_BGP_PEER_TEMPLATE_1
#       inherit:
#         peer_session: psession1
#       local_as: "65537"
#
#     - name: neighbor_tmplt_2
#       description: Test_BGP_PEER_TEMPLATE_2
#       address_family:
#         - afi: ipv4
#           safi: multicast
#           advertise_map:
#             exist_map: emap1
#             route_map: rmap1
#           as_override: true
#           filter_list:
#             inbound: flist1
#             outbound: flist2
#       inherit:
#         peer_session: psession1
#       timers:
#         holdtime: 100
#         keepalive: 45

# After state:
# ------------
#
# nxos9k# show running-config | section "^router bgp"
# router bgp 65536
#   template peer neighbor_tmplt_1
#     inherit peer-session psession1
#     description Test_BGP_PEER_TEMPLATE_1
#     local-as 65537
#     address-family ipv4 unicast
#      advertise-map rmap1 non-exist-map nemap1
#      advertisement-interval 60
#      disable-peer-as-check
#   template peer neighbor_tmplt_2
#     description Test_BGP_PEER_TEMPLATE_2
#     inherit peer-session psession1
#     bmp-activate-server 2
#     timers 45 100
#     address-family ipv4 multicast
#      advertise-map rmap1 exist-map emap1
#      as-override
#      filter-list flist1 in
#      filter-list flist2 out

# Using overridden
#
# Before state:
# -------------
#
# nxos9k# show running-config | section "^router bgp"
# router bgp 65536
#   template peer neighbor_tmplt_1
#     capability suppress 4-byte-as
#     description Test_BGP_PEER_TEMPLATE_1
#     bmp-activate-server 2
#     local-as 65536
#     remote-as 65001
#     address-family ipv4 unicast
#      advertise-map rmap1 non-exist-map nemap1
#      advertisement-interval 60
#      disable-peer-as-check
#   template peer neighbor_tmplt_2
#     description Test_BGP_PEER_TEMPLATE_2
#     inherit peer-session psession1
#     timers 45 100
#     address-family ipv4 multicast
#      advertise-map rmap1 exist-map emap1
#      as-override
#      filter-list flist1 in
#      filter-list flist2 out

- name: Override BGP templates configuration with provided configuration
  cisco.nxos.nxos_bgp_templates:
    config:
      as_number: 65536
      neighbor:
        - name: neighbor_tmplt_1
          address_family:
            - afi: ipv4
              safi: unicast
              advertise_map:
                route_map: rmap1
                non_exist_map: nemap1
              advertisement_interval: 60
              disable_peer_as_check: true
          inherit:
            peer_session: psession1
          description: Test_BGP_PEER_TEMPLATE_1
          local_as: 65537
    state: overridden

# Task output:
# ------------
#
# before:
#   as_number: "65536"
#   neighbor:
#     - name: neighbor_tmplt_1
#       address_family:
#         - afi: ipv4
#           safi: unicast
#           advertise_map:
#             non_exist_map: nemap1
#             route_map: rmap1
#           advertisement_interval: 60
#           disable_peer_as_check: true
#       bmp_activate_server: 2
#       capability:
#         suppress_4_byte_as: true
#       description: Test_BGP_PEER_TEMPLATE_1
#       local_as: "65536"
#       remote_as: "65001"
#
#     - name: neighbor_tmplt_2
#       description: Test_BGP_PEER_TEMPLATE_2
#       address_family:
#         - afi: ipv4
#           safi: multicast
#           advertise_map:
#             exist_map: emap1
#             route_map: rmap1
#           as_override: true
#           filter_list:
#             inbound: flist1
#             outbound: flist2
#       inherit:
#         peer_session: psession1
#       timers:
#         holdtime: 100
#         keepalive: 45
#
# commands:
#   - router bgp 65536
#   - template peer neighbor_tmplt_1
#   - no bmp-activate-server 2
#   - no capability suppress 4-byte-as
#   - inherit peer-session psession1
#   - local-as 65537
#   - no remote-as 65001
#   - no template peer neighbor_tmplt_2
#
# after:
#   as_number: "65536"
#   neighbor:
#     - name: neighbor_tmplt_1
#       address_family:
#         - afi: ipv4
#           safi: unicast
#           advertise_map:
#             non_exist_map: nemap1
#             route_map: rmap1
#           advertisement_interval: 60
#           disable_peer_as_check: true
#       description: Test_BGP_PEER_TEMPLATE_1
#       inherit:
#         peer_session: psession1
#       local_as: "65537"

# After state:
# ------------
#
# nxos9k# show running-config | section "^router bgp"
# router bgp 65536
#   template peer neighbor_tmplt_1
#     inherit peer-session psession1
#     description Test_BGP_PEER_TEMPLATE_1
#     local-as 65537
#     address-family ipv4 unicast
#      advertise-map rmap1 non-exist-map nemap1
#      advertisement-interval 60
#      disable-peer-as-check

# Using deleted

# Before state:
# --------------
#
# nxos9k# show running-config | section "^router bgp"
# router bgp 65536
#   template peer neighbor_tmplt_1
#     capability suppress 4-byte-as
#     description Test_BGP_PEER_TEMPLATE_1
#     bmp-activate-server 2
#     local-as 65536
#     remote-as 65001
#     address-family ipv4 unicast
#      advertise-map rmap1 non-exist-map nemap1
#      advertisement-interval 60
#      disable-peer-as-check
#   template peer neighbor_tmplt_2
#     description Test_BGP_PEER_TEMPLATE_2
#     inherit peer-session psession1
#     timers 45 100
#     address-family ipv4 multicast
#      advertise-map rmap1 exist-map emap1
#      as-override
#      filter-list flist1 in
#      filter-list flist2 out

- name: Delete BGP configs handled by this module
  cisco.nxos.nxos_bgp_templates:
    state: deleted

# Task output:
# ------------
#
# before:
#   as_number: "65536"
#   neighbor:
#     - name: neighbor_tmplt_1
#       address_family:
#         - afi: ipv4
#           safi: unicast
#           advertise_map:
#             non_exist_map: nemap1
#             route_map: rmap1
#           advertisement_interval: 60
#           disable_peer_as_check: true
#       bmp_activate_server: 2
#       capability:
#         suppress_4_byte_as: true
#       description: Test_BGP_PEER_TEMPLATE_1
#       local_as: "65536"
#       remote_as: "65001"
#
#     - name: neighbor_tmplt_2
#       description: Test_BGP_PEER_TEMPLATE_2
#       address_family:
#         - afi: ipv4
#           safi: multicast
#           advertise_map:
#             exist_map: emap1
#             route_map: rmap1
#           as_override: true
#           filter_list:
#             inbound: flist1
#             outbound: flist2
#       inherit:
#         peer_session: psession1
#       timers:
#         holdtime: 100
#         keepalive: 45
#
# commands:
#   - router bgp 65536
#   - no template peer neighbor_tmplt_1
#   - no template peer neighbor_tmplt_2
#
# after: {}

# After state:
# -------------
# nxos9k# show running-config | section "^router bgp"
# nxos9k#

返回值

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

键	描述
after 字典	模块执行后的结果配置。 已返回: 当已更改时 示例: "此输出将始终与模块 argspec 格式相同。\n"
before 字典	模块执行之前的配置。 已返回: 当 state 为 merged、 replaced、 overridden、 deleted 或 purged 时 示例: "此输出将始终与模块 argspec 格式相同。\n"
commands 列表 / 元素=字符串	推送到远程设备的命令集。 已返回: 当 state 为 merged、 replaced、 overridden、 deleted 或 purged 时 示例: ["router bgp 65536", "template peer neighbor_tmplt_1", "no bmp-activate-server 2", "no capability suppress 4-byte-as", "inherit peer-session psession1", "local-as 65537", "no remote-as 65001", "no template peer neighbor_tmplt_2"]
gathered 字典	从远程设备收集的关于网络资源的结构化数据的事实。 已返回: 当 state 为 gathered 时 示例: "此输出将始终与模块 argspec 格式相同。\n"
parsed 字典	在 running_config 选项中提供的设备原生配置按照模块 argspec 解析为结构化数据。 已返回: 当 state 为 parsed 时 示例: "此输出将始终与模块 argspec 格式相同。\n"
rendered 列表 / 元素=字符串	任务中提供的配置以设备原生格式（离线）呈现。 已返回: 当 state 为 rendered 时 示例: ["router bgp 65536", "template peer neighbor_tmplt_1", "bmp-activate-server 2", "no capability suppress 4-byte-as", "no template peer neighbor_tmplt_2"]

作者

• Nilashish Chakraborty (@NilashishC)

集合链接

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