community.network.ce_static_route_bfd 模块 – 管理华为 CloudEngine 交换机上的静态路由配置。

注意

此模块是 community.network 集合 (版本 5.1.0) 的一部分。

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

要安装它,请使用:ansible-galaxy collection install community.network

要在 playbook 中使用它,请指定:community.network.ce_static_route_bfd

注意

community.network 集合已被弃用,并将从 Ansible 12 中移除。有关更多信息,请参见 讨论主题

community.network 0.2.0 中的新增功能

已弃用

在以下版本中移除:

6.0.0 版本

原因:

此集合及其中的所有内容均未维护且已弃用。

替代方案:

未知。

概要

  • 管理华为 CloudEngine 交换机上的静态路由。

别名:network.cloudengine.ce_static_route_bfd

参数

参数

注释

aftype

字符串 / 必填

静态路由的目标 IP 地址族类型。

选项

  • "v4"

  • "v6"

bfd_session_name

字符串

bfd 名称 (范围 1-15)。

commands

列表 / 元素=字符串

传入的命令行用于发送 sys,undo ip route-static default-bfd,commit。

description

字符串

路由的名称。在 CLI 上与 name 参数一起使用。

destvrf

字符串

下一跳 IP 地址的 VPN 实例。

detect_multiplier

整数

配置 BFD 倍数 (范围 3-50)。

function_flag

字符串 / 必填

用于区分命令行功能。

选项

  • "globalBFD"

  • "singleBFD"

  • "dynamicBFD"

  • "staticBFD"

mask

字符串

静态路由的目标 IP 地址掩码。

min_rx_interval

整数

设置最小 BFD 接收间隔 (范围 50-1000)。

min_tx_interval

整数

设置最小 BFD 会话发送间隔 (范围 50-1000)。

next_hop

字符串

静态路由的下一跳地址。

nhp_interface

字符串

静态路由的下一跳接口全名。

pref

整数

路由的优先级或管理差异 (范围 1-255)。

prefix

字符串 / 必填

静态路由的目标 IP 地址。

state

字符串

指定资源的所需状态。

选项

  • "present" ← (默认)

  • "absent"

tag

整数

路由标签值(数字)。

vrf

字符串

目标 IP 地址的 VPN 实例。

备注

注意

  • 此模块要求在被管理的远程设备上启用 netconf 系统服务。

  • 推荐的连接是 netconf

  • 此模块也适用于旧版 playbook 的 local 连接。

  • 如果没有提供 vrf,则 vrf 设置为默认值。

  • 如果 state=absent,则无论非必需参数如何,都将移除路由配置。

示例

#ip route-static bfd interface-type interface-number nexthop-address [ local-address address ]
#[ min-rx-interval min-rx-interval | min-tx-interval min-tx-interval | detect-multiplier multiplier ]
- name: Config an ip route-static bfd 10GE1/0/1 3.3.3.3 min-rx-interval 50 min-tx-interval 50 detect-multiplier 5
  community.network.ce_static_route_bfd:
    function_flag: 'singleBFD'
    nhp_interface: 10GE1/0/1
    next_hop: 3.3.3.3
    min_tx_interval: 50
    min_rx_interval: 50
    detect_multiplier: 5
    aftype: v4
    state: present

#undo ip route-static bfd [ interface-type interface-number | vpn-instance vpn-instance-name ] nexthop-address
- name: Undo ip route-static bfd 10GE1/0/1 3.3.3.4
  community.network.ce_static_route_bfd:
    function_flag: 'singleBFD'
    nhp_interface: 10GE1/0/1
    next_hop: 3.3.3.4
    aftype: v4
    state: absent

#ip route-static default-bfd { min-rx-interval {min-rx-interval} | min-tx-interval {min-tx-interval} | detect-multiplier {multiplier}}
- name: Config an ip route-static default-bfd min-rx-interval 50 min-tx-interval 50 detect-multiplier 6
  community.network.ce_static_route_bfd:
    function_flag: 'globalBFD'
    min_tx_interval: 50
    min_rx_interval: 50
    detect_multiplier: 6
    aftype: v4
    state: present

- name: Undo ip route-static default-bfd
  community.network.ce_static_route_bfd:
    function_flag: 'globalBFD'
    aftype: v4
    state: absent
    commands: 'sys,undo ip route-static default-bfd,commit'

- name: Config an ipv4 static route 2.2.2.0/24 2.2.2.1 preference 1 tag 2 description test for staticBFD
  community.network.ce_static_route_bfd:
    function_flag: 'staticBFD'
    prefix: 2.2.2.2
    mask: 24
    next_hop: 2.2.2.1
    tag: 2
    description: test
    pref: 1
    aftype: v4
    bfd_session_name: btoa
    state: present

返回值

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

描述

changed

布尔值

检查设备上是否进行了更改

返回值:始终

示例: true

end_state

字典

模块执行后交换机的键值对

返回值:始终

示例: {"bfd_session_name": "btoa", "description": "testing", "function_flag": "staticBFD", "mask": "24", "next_hop": "3.3.3.3", "pref": "100", "prefix": "192.168.20.0", "tag": "null"}

existing

字典

现有交换机的键值对

返回值:始终

示例: {"bfd_session_name": "btoa", "description": "testing", "function_flag": "", "mask": "24", "next_hop": "", "pref": "101", "prefix": "192.168.20.0", "tag": "null"}

proposed

字典

传递给模块的参数的键值对

返回值:始终

示例: {"bfd_session_name": "btoa", "description": "testing", "function_flag": "staticBFD", "mask": "24", "next_hop": "3.3.3.3", "pref": "100", "prefix": "192.168.20.642", "vrf": "_public_"}

updates

列表 / 元素=字符串

发送到设备的命令列表

返回值:始终

示例: ["ip route-static 192.168.20.0 255.255.255.0 3.3.3.3 preference 100 description testing"]

状态

  • 此模块将于6.0.0版本中移除。[已弃用]

  • 更多信息请参见 已弃用

作者

  • xuxiaowei0512 (@CloudEngine-Ansible)