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。

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

注意

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

已弃用

在：中删除

版本 6.0.0

原因：

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

替代方案：

未知。

概要

  • 管理 BFD 会话配置，创建 BFD 会话或删除华为 CloudEngine 设备上指定的 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。

  • 对于旧版 playbook，此模块也适用于 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 (@QijunPan)