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 auto FRR。如果值为 false,则禁用 BGP auto 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 接口感知功能后,当接口关闭时,会立即删除接口上的 EBGP 会话。如果值为 false,则在启用快速 EBGP 接口感知功能后,当接口关闭时,不会立即删除接口上的 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 目标过滤功能。如果该值为 false,则不对接收到的 VPN 路由执行 VPN 目标过滤功能。

选择

  • "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

字符串

采用 IPv4 地址格式的路由器的 ID。该值为 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

  • 此模块还可与用于旧版剧本的 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

boolean

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

返回:始终

示例: true

end_state

dictionary

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

返回:始终

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

existing

dictionary

现有 aaa 服务器的键/值对

返回:始终

示例: {}

proposed

dictionary

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

返回:始终

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

updates

list / elements=string

发送到设备的命令

返回:始终

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

状态

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

  • 有关更多信息,请参见 已弃用

作者

  • wangdezhuang (@QijunPan)