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

注意

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

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

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

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

注意

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

已弃用

在以下版本中移除：

6.0.0 版本

原因：

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

替代方案：

未知。

概要

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

别名：network.cloudengine.ce_static_route

参数

参数

注释

aftype

字符串 / 必需

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

选项

  • "v4"

  • "v6"

description

字符串

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

destvrf

字符串

下一跳 IP 地址的 VPN 实例。

mask

字符串 / 必需

静态路由的目标 IP 掩码。

next_hop

字符串

静态路由的下一跳地址。

nhp_interface

字符串

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

pref

字符串

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

prefix

字符串 / 必需

静态路由的目标 IP 地址。

state

字符串

指定所需资源状态。

选项

  • "present" ← (默认)

  • "absent"

tag

字符串

路由标签值 (数字)。

vrf

字符串

目标 IP 地址的 VPN 实例。

备注

注意

  • 如果未提供 vrf，则 vrf 设置为默认值。

  • 如果 *state=absent*，则无论非必需参数如何，路由都将被删除。

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

  • 推荐的连接是 netconf。

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

示例

- name: Static route module test
  hosts: cloudengine
  connection: local
  gather_facts: false

  tasks:

  - name: Config a ipv4 static route, next hop is an address and that it has the proper description
    community.network.ce_static_route:
      prefix: 2.1.1.2
      mask: 24
      next_hop: 3.1.1.2
      description: 'Configured by Ansible'
      aftype: v4
  - name: Config a ipv4 static route ,next hop is an interface and that it has the proper description
    community.network.ce_static_route:
      prefix: 2.1.1.2
      mask: 24
      next_hop: 10GE1/0/1
      description: 'Configured by Ansible'
      aftype: v4
  - name: Config a ipv6 static route, next hop is an address and that it has the proper description
    community.network.ce_static_route:
      prefix: fc00:0:0:2001::1
      mask: 64
      next_hop: fc00:0:0:2004::1
      description: 'Configured by Ansible'
      aftype: v6
  - name: Config a ipv4 static route, next hop is an interface and that it has the proper description
    community.network.ce_static_route:
      prefix: fc00:0:0:2001::1
      mask: 64
      next_hop: 10GE1/0/1
      description: 'Configured by Ansible'
      aftype: v6
  - name: Config a VRF and set ipv4 static route, next hop is an address and that it has the proper description
    community.network.ce_static_route:
      vrf: vpna
      prefix: 2.1.1.2
      mask: 24
      next_hop: 3.1.1.2
      description: 'Configured by Ansible'
      aftype: v4

返回值

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

键

描述

changed

布尔值

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

返回： 始终

示例： true

end_state

字典

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

返回： 始终

示例： {"description": "testing", "mask": "24", "next_hop": "3.3.3.3", "pref": "100", "prefix": "192.168.20.0", "tag": "null"}

existing

字典

现有交换机的键值对

返回： 始终

示例： {}

proposed

字典

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

返回： 始终

示例： {"description": "testing", "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 版本中移除。[已弃用]

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

作者

  • 杨阳 (@QijunPan)