community.network.ce_bfd_session 模块 – 管理华为 CloudEngine 设备上的 BFD 会话配置。

注意

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

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

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

要在剧本中使用它，请指定： community.network.ce_bfd_session。

注意

community.network 集合已被弃用，并将从 Ansible 12 中移除。请参阅 讨论主题 以了解更多信息。

已弃用

在以下版本中移除：

6.0.0 版本

原因：

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

替代方案：

未知。

概要

• 管理 BFD 会话配置，在华为 CloudEngine 设备上创建 BFD 会话或删除指定的 BFD 会话。

别名：network.cloudengine.ce_bfd_session

参数

参数	注释
addr_type 字符串	指定对端 IP 地址类型。 选项 "ipv4"
create_type 字符串	BFD 会话创建模式，当前创建的 BFD 会话仅支持静态或静态自动协商模式。 选项 "static" ← (默认) "auto"
dest_addr 字符串	指定绑定到 BFD 会话的对端 IP 地址。
local_discr 字符串	当模式为 auto 时，不需要配置 BFD 会话本地标识符。
out_if_name 字符串	指定绑定到 BFD 会话的接口的类型和编号。
remote_discr 字符串	当模式为 auto 时，不需要配置 BFD 会话远程标识符。
session_name 字符串 / 必需	指定 BFD 会话的名称。该值为 1 到 15 个区分大小写的字符组成的字符串，不包含空格。
src_addr 字符串	指示 BFD 数据包中携带的源 IP 地址。
state 字符串	确定设备上是否应存在配置。 选项 "present" ← (默认) "absent"
use_default_ip 布尔值	指示绑定到 BFD 会话的默认多播 IP 地址。默认情况下，BFD 使用多播 IP 地址 224.0.0.184。您可以通过运行 default-ip-address 命令来设置多播 IP 地址。该值为布尔类型。 选项 false ← (默认) true
vrf_name 字符串	指定绑定到 BFD 会话的虚拟专用网络 (VPN) 实例的名称。该值为 1 到 31 个区分大小写的字符组成的字符串，不支持空格。当字符串周围使用双引号时，字符串中允许使用空格。值 "_public_" 是保留值，不能用作 VPN 实例名称。

备注

注意

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

• 推荐连接方式为 netconf。

• 此模块也适用于旧版剧本中的 local 连接。

示例

- name: Bfd session module test
  hosts: cloudengine
  connection: local
  gather_facts: false

  tasks:
  - name: Configuring Single-hop BFD for Detecting Faults on a Layer 2 Link
    community.network.ce_bfd_session:
      session_name: bfd_l2link
      use_default_ip: true
      out_if_name: 10GE1/0/1
      local_discr: 163
      remote_discr: 163

  - name: Configuring Single-Hop BFD on a VLANIF Interface
    community.network.ce_bfd_session:
      session_name: bfd_vlanif
      dest_addr: 10.1.1.6
      out_if_name: Vlanif100
      local_discr: 163
      remote_discr: 163

  - name: Configuring Multi-Hop BFD
    community.network.ce_bfd_session:
      session_name: bfd_multi_hop
      dest_addr: 10.1.1.1
      local_discr: 163
      remote_discr: 163

返回值

公共返回值已记录在 此处，以下是此模块特有的字段

键	描述
changed 布尔值	检查设备上是否进行了更改 返回：始终 示例： true
end_state 字典	模块执行后的配置的键值对 返回：始终 示例： {"session": {"addrType": "IPV4", "createType": "SESS_STATIC", "destAddr": null, "outIfName": "10GE1/0/1", "sessName": "bfd_l2link", "srcAddr": null, "useDefaultIp": "true", "vrfName": null}}
existing 字典	现有配置的键值对 返回：始终 示例： {"session": {}}
proposed 字典	传递到模块的参数的键值对 返回：始终 示例： {"addr_type": null, "create_type": null, "dest_addr": null, "out_if_name": "10GE1/0/1", "session_name": "bfd_l2link", "src_addr": null, "state": "present", "use_default_ip": true, "vrf_name": null}
更新 列表 / 元素=字符串	发送到设备的命令 返回：始终 示例： ["bfd bfd_l2link bind peer-ip default-ip interface 10ge1/0/1"]

状态

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

• 更多信息请参见 已弃用。

作者

• 潘启军 (@QijunPan)

资源链接

• 问题跟踪器
• 代码仓库