community.network.ce_bgp_af 模块 – 管理华为 CloudEngine 交换机上的 BGP 地址族配置。

注意

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

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

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

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

注意

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

已弃用

在以下版本中删除：

版本 6.0.0

原因：

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

替代方案：

未知。

概要

  • 管理华为 CloudEngine 交换机上的 BGP 地址族配置。

别名：network.cloudengine.ce_bgp_af

参数

参数

注释

active_route_advertise

字符串

如果值为 true，则启用 BGP 以仅将 RM 中的最佳路由通告给对等方。如果值为 false，则不启用 BGP 以仅将 RM 中的最佳路由通告给对等方。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

add_path_sel_num

字符串

Add-Path 路由的数量。该值是一个介于 2 到 64 之间的整数。

af_type

字符串 / 必需

BGP 实例的地址族类型。

选项

  • "ipv4uni"

  • "ipv4multi"

  • "ipv4vpn"

  • "ipv6uni"

  • "ipv6vpn"

  • "evpn"

allow_invalid_as

字符串

允许选择 BGP 来源 AS 验证结果为“无效”的路由。如果值为 true，则无效路由可以参与路由选择。如果值为 false，则无效路由不能参与路由选择。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

always_compare_med

字符串

如果值为 true，则在 BGP 选择最佳路由时，会比较从不同自治系统中的对等方学习到的路由的 MED。如果值为 false，则在 BGP 选择最佳路由时，不会比较从不同自治系统中的对等方学习到的路由的 MED。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

as_path_neglect

字符串

如果值为 true，则在 BGP 选择最佳路由时会忽略 AS 路径属性。如果值为 false，则在 BGP 选择最佳路由时不会忽略 AS 路径属性。AS 路径长度较小的优先级较高。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

auto_frr_enable

字符串

如果值为 true，则启用 BGP 自动 FRR。如果值为 false，则禁用 BGP 自动 FRR。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

default_local_pref

字符串

设置 Local-Preference 属性。该值是一个整数。该值是一个介于 0 到 4294967295 之间的整数。

default_med

字符串

指定 BGP 路由的多出口鉴别器 (MED)。该值是一个介于 0 到 4294967295 之间的整数。

default_rt_import_enable

字符串

如果值为 true，则允许将默认路由导入 BGP 路由表。如果值为 false，则不允许将默认路由导入 BGP 路由表。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

determin_med

字符串

如果值为 true，则启用 BGP 确定性 MED。如果值为 false，则禁用 BGP 确定性 MED。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

ebgp_ecmp_nexthop_changed

字符串

如果值为 true，则在 EBGP 负载均衡场景中，通告的路由的下一跳更改为通告方本身。如果值为 false，则在 EBGP 负载均衡场景中，通告的路由的下一跳不会更改为通告方本身。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

ebgp_if_sensitive

字符串

如果值为 true，则在启用快速 EBGP 接口感知功能后，当接口变为 Down 时，会立即删除接口上的 EBGP 会话。如果值为 false，则在启用快速 EBGP 接口感知功能后，当接口变为 Down 时，不会立即删除接口上的 EBGP 会话。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

ecmp_nexthop_changed

字符串

如果值为 true，则在 BGP 负载均衡场景中，通告的路由的下一跳更改为通告方本身。如果值为 false，则在 BGP 负载均衡场景中，通告的路由的下一跳不会更改为通告方本身。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

ibgp_ecmp_nexthop_changed

字符串

如果该值为 true，则在 IBGP 负载均衡场景中，通告路由的下一跳地址会更改为通告者本身。如果该值为 false，则在 IBGP 负载均衡场景中，通告路由的下一跳地址不会更改为通告者本身。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

igp_metric_ignore

字符串

如果该值为 true，则 BGP 选择最佳路由时，不会比较下一跳 IGP 路由的度量值。如果该值为 false，则 BGP 选择最佳路由时，会比较下一跳 IGP 路由的度量值。度量值较小的路由优先级较高。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

import_process_id

字符串

导入路由协议的进程 ID。该值为 0 到 4294967295 之间的整数。

import_protocol

字符串

可以从中导入路由的路由协议。

选项

  • "direct"

  • "ospf"

  • "isis"

  • "static"

  • "rip"

  • "ospfv3"

  • "ripng"

ingress_lsp_policy_name

字符串

入口 LSP 策略名称。

load_balancing_as_path_ignore

字符串

负载均衡 AS 路径忽略。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

lowest_priority

字符串

如果该值为 true，则启用降低优先级以通告路由。如果该值为 false，则禁用降低优先级以通告路由。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

mask_len

字符串

指定 IP 地址的掩码长度。该值为 0 到 128 之间的整数。

max_load_ebgp_num

字符串

指定等价 EBGP 路由的最大数量。该值为 1 到 65535 之间的整数。

max_load_ibgp_num

字符串

指定等价 IBGP 路由的最大数量。该值为 1 到 65535 之间的整数。

maximum_load_balance

字符串

指定 BGP 路由表中等价路由的最大数量。该值为 1 到 65535 之间的整数。

med_none_as_maximum

字符串

如果该值为 true，当 BGP 选择最佳路由时，如果路由的属性未携带 MED 值，则系统使用 4294967295 作为该路由的 MED 值。如果该值为 false，如果路由的属性未携带 MED 值，则系统使用 0 作为该路由的 MED 值。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

network_address

字符串

指定 BGP 通告的 IP 地址。该值为 0 到 255 个字符的字符串。

next_hop_sel_depend_type

字符串

下一跳选择依赖类型。

选项

  • "default" ← (默认)

  • "dependTunnel"

  • "dependIp"

nexthop_third_party

字符串

如果该值为 true，则启用第三方下一跳功能。如果该值为 false，则禁用第三方下一跳功能。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

nhp_relay_route_policy_name

字符串

指定用于路由迭代的路由策略的名称。该值为 1 到 40 个字符的字符串。

originator_prior

字符串

发起者优先级。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

policy_ext_comm_enable

字符串

如果该值为 true，则允许修改扩展团体属性。如果该值为 false，则不允许修改扩展团体属性。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

policy_vpn_target

字符串

如果该值为 true，则对接收到的 VPN 路由执行 VPN-Target 过滤功能。如果该值为 false，则不对接收到的 VPN 路由执行 VPN-Target 过滤功能。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

preference_external

字符串

设置 EBGP 路由的协议优先级。该值为 1 到 255 之间的整数。

preference_internal

字符串

设置 IBGP 路由的协议优先级。该值为 1 到 255 之间的整数。

preference_local

字符串

设置本地 BGP 路由的协议优先级。该值为 1 到 255 之间的整数。

prefrence_policy_name

字符串

设置一个路由策略来过滤路由，以便将配置的优先级应用于与指定策略匹配的路由。该值为 1 到 40 个字符的字符串。

reflect_between_client

字符串

如果该值为 true，则在客户端之间启用路由反射。如果该值为 false，则在客户端之间禁用路由反射。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

reflect_chg_path

字符串

如果该值为 true，则启用路由反射器以基于导出策略修改路由路径属性。如果该值为 false，则禁用路由反射器以基于导出策略修改路由路径属性。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

reflector_cluster_id

字符串

设置集群 ID。在集群中配置多个 RR 可以增强网络的稳定性。该值为 1 到 4294967295 之间的整数。

reflector_cluster_ipv4

字符串

设置集群 IPv4 地址。该值以 IPv4 地址的格式表示。

relay_delay_enable

字符串

如果该值为 true，则启用中继延迟。如果该值为 false，则禁用中继延迟。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

rib_only_enable

字符串

如果该值为 true，则 BGP 路由不能通告到 IP 路由表。如果该值为 false，则 BGP 首选的路由会通告到 IP 路由表。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

rib_only_policy_name

字符串

指定路由策略的名称。该值为 1 到 40 个字符的字符串。

route_sel_delay

字符串

路由选择延迟。该值为 0 到 3600 之间的整数。

router_id

字符串

路由器的 ID，格式为 IPv4 地址。该值为 0 到 255 个字符的字符串。该值采用点分十进制表示法。

router_id_neglect

字符串

如果该值为 true，则 BGP 选择最佳路由时会忽略路由器 ID 属性。如果该值为 false，则 BGP 选择最佳路由时不会忽略路由器 ID 属性。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

rr_filter_number

字符串

设置 RR 组支持的扩展团体过滤器数量。该值为 1 到 51 个字符的字符串。

state

字符串

指定资源的期望状态。

选项

  • "present" ← (默认)

  • "absent"

summary_automatic

字符串

如果该值为 true，则为本地导入的路由启用自动聚合。如果该值为 false，则为本地导入的路由禁用自动聚合。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

supernet_label_adv

字符串

如果该值为 true，则启用通告超网标签的功能。如果该值为 false，则禁用通告超网标签的功能。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

supernet_uni_adv

字符串

如果该值为 true，则启用通告超网单播路由的功能。如果该值为 false，则禁用通告超网单播路由的功能。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

vrf_name

字符串 / 必需

BGP 实例的名称。名称是区分大小写的字符串。只有在创建了相应的 VPN 实例之后，才能使用 BGP 实例。该值为 1 到 31 个区分大小写的字符的字符串。

vrf_rid_auto_sel

字符串

如果该值为 true，则允许 VPN BGP 实例自动选择路由器 ID。如果该值为 false，则禁止 VPN BGP 实例自动选择路由器 ID。

选项

  • "no_use" ← (默认)

  • "true"

  • "false"

注释

注意

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

  • 推荐的连接方式是 netconf。

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

示例

- name: CloudEngine BGP address family test
  hosts: cloudengine
  connection: local
  gather_facts: false
  tasks:
  - name: "Config BGP Address_Family"
    community.network.ce_bgp_af:
      state: present
      vrf_name: js
      af_type: ipv4uni
  - name: "Undo BGP Address_Family"
    community.network.ce_bgp_af:
      state: absent
      vrf_name: js
      af_type: ipv4uni
  - name: "Config import route"
    community.network.ce_bgp_af:
      state: present
      vrf_name: js
      af_type: ipv4uni
      import_protocol: ospf
      import_process_id: 123
  - name: "Undo import route"
    community.network.ce_bgp_af:
      state: absent
      vrf_name: js
      af_type: ipv4uni
      import_protocol: ospf
      import_process_id: 123
  - name: "Config network route"
    community.network.ce_bgp_af:
      state: present
      vrf_name: js
      af_type: ipv4uni
      network_address: 1.1.1.1
      mask_len: 24
  - name: "Undo network route"
    community.network.ce_bgp_af:
      state: absent
      vrf_name: js
      af_type: ipv4uni
      network_address: 1.1.1.1
      mask_len: 24

返回值

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

键

描述

changed

布尔值

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

返回: 总是

示例: true

end_state

字典

模块执行后 aaa 参数的键/值对

返回: 总是

示例: {"af_type": "ipv4uni", "vrf_name": "js"}

existing

字典

现有 aaa 服务器的键/值对

返回: 总是

示例: {}

proposed

字典

传递到模块的参数的键/值对

返回: 总是

示例: {"af_type": "ipv4uni", "state": "present", "vrf_name": "js"}

updates

列表 / 元素=字符串

发送到设备的命令

返回: 总是

示例: ["ipv4-family vpn-instance js"]

状态

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

  • 有关更多信息，请参阅 已弃用。

作者

  • wangdezhuang (@QijunPan)