community.network.icx_l3_interface 模块 – 管理 Ruckus ICX 7000 系列交换机上的三层接口

注意

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

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

要安装它,请使用: ansible-galaxy collection install community.network

要在 playbook 中使用它,请指定: community.network.icx_l3_interface

注意

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

已弃用

在以下版本中移除:

6.0.0 版本

原因:

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

替代方案:

未知。

概要

  • 此模块提供对 ICX 网络设备上的三层接口的声明式管理。

别名:network.icx.icx_l3_interface

参数

参数

注释

aggregate

列表 / 元素=字典

三层接口定义列表。aggregate 列表中的每个条目都应定义接口名称 name 和可选的 ipv4ipv6 地址。

check_running_config

布尔值

检查运行配置。这可以设置为环境变量。模块将使用环境变量值(默认:True),除非通过将其指定为模块参数来覆盖它。

选项

  • false

  • true

ipv4

字符串

要为 *name* 选项中提到的三层接口设置的 IPv4 地址。地址格式为 <ipv4 地址>/<掩码>,掩码是 0-32 范围内的数字,例如 192.168.0.1/24

ipv6

字符串

要为 *name* 选项中提到的三层接口设置的 IPv6 地址。地址格式为 <ipv6 地址>/<掩码>,掩码是 0-128 范围内的数字,例如 fd5d:12c9:2201:1::1/64。

mode

字符串

指定 ipv4 地址是否应该是动态的/通告给 ospf/不通告给 ospf。只有在配置了 ipv4 地址并且它不是辅助 IP 地址时才应指定此选项。

选项

  • "dynamic"

  • "ospf-ignore"

  • "ospf-passive"

name

字符串

要配置的三层接口的名称,例如 GigabitEthernet0/2、ve 10、ethernet 1/1/1

replace

字符串

替换接口上配置的主 IP 地址。

选项

  • "yes"

  • "no"

secondary

字符串

指定配置的地址是辅助 IP 地址。如果省略此关键字,则配置的地址为主 IP 地址。

选项

  • "yes"

  • "no"

state

字符串

三层接口配置的状态。它指示配置是否应该存在于远程设备上。

选项

  • "present"

  • "absent"

check_running_config

布尔值

检查运行配置。这可以设置为环境变量。模块将使用环境变量值(默认:True),除非通过将其指定为模块参数来覆盖它。

选项

  • false

  • true ← (默认)

ipv4

字符串

要为 *name* 选项中提到的三层接口设置的 IPv4 地址。地址格式为 <ipv4 地址>/<掩码>,掩码是 0-32 范围内的数字,例如 192.168.0.1/24

ipv6

字符串

要为 *name* 选项中提到的三层接口设置的 IPv6 地址。地址格式为 <ipv6 地址>/<掩码>,掩码是 0-128 范围内的数字,例如 fd5d:12c9:2201:1::1/64。

mode

字符串

指定 ipv4 地址是否应该是动态的/通告给 ospf/不通告给 ospf。只有在配置了 ipv4 地址并且它不是辅助 IP 地址时才应指定此选项。

选项

  • "dynamic"

  • "ospf-ignore"

  • "ospf-passive"

name

字符串

要配置的三层接口的名称,例如 GigabitEthernet0/2、ve 10、ethernet 1/1/1

replace

字符串

替换接口上配置的主 IP 地址。

选项

  • "yes"

  • "no"

secondary

字符串

指定配置的地址是辅助 IP 地址。如果省略此关键字,则配置的地址为主 IP 地址。

选项

  • "yes"

  • "no"

state

字符串

三层接口配置的状态。它指示配置是否应该存在于远程设备上。

选项

  • "present" ← (默认)

  • "absent"

备注

注意

示例

- name: Remove ethernet 1/1/1 IPv4 and IPv6 address
  community.network.icx_l3_interface:
    name: ethernet 1/1/1
    ipv4: 192.168.0.1/24
    ipv6: "fd5d:12c9:2201:1::1/64"
    state: absent

- name: Replace ethernet 1/1/1 primary IPv4 address
  community.network.icx_l3_interface:
    name: ethernet 1/1/1
    ipv4: 192.168.0.1/24
    replace: true
    state: absent

- name: Replace ethernet 1/1/1 dynamic IPv4 address
  community.network.icx_l3_interface:
    name: ethernet 1/1/1
    ipv4: 192.168.0.1/24
    mode: dynamic
    state: absent

- name: Set ethernet 1/1/1 secondary IPv4 address
  community.network.icx_l3_interface:
    name: ethernet 1/1/1
    ipv4: 192.168.0.1/24
    secondary: true
    state: absent

- name: Set ethernet 1/1/1 IPv4 address
  community.network.icx_l3_interface:
    name: ethernet 1/1/1
    ipv4: 192.168.0.1/24

- name: Set ethernet 1/1/1 IPv6 address
  community.network.icx_l3_interface:
    name: ethernet 1/1/1
    ipv6: "fd5d:12c9:2201:1::1/64"

- name: Set IP addresses on aggregate
  community.network.icx_l3_interface:
    aggregate:
      - { name: GigabitEthernet0/3, ipv4: 192.168.2.10/24 }
      - { name: GigabitEthernet0/3, ipv4: 192.168.3.10/24, ipv6: "fd5d:12c9:2201:1::1/64" }

- name: Remove IP addresses on aggregate
  community.network.icx_l3_interface:
    aggregate:
      - { name: GigabitEthernet0/3, ipv4: 192.168.2.10/24 }
      - { name: GigabitEthernet0/3, ipv4: 192.168.3.10/24, ipv6: "fd5d:12c9:2201:1::1/64" }
    state: absent


- name: Set the ipv4 and ipv6 of a virtual ethernet(ve)
  community.network.icx_l3_interface:
    name: ve 100
    ipv4: 192.168.0.1
    ipv6: "2001:0db8:85a3:0000:0000:8a2e:0370:7334"

返回值

常见的返回值在此处有说明 这里,以下是此模块特有的字段

描述

commands

列表 / 元素=字符串

要发送到设备的配置模式命令列表

返回:始终返回,除了使用 Netconf 传输来管理设备的平台。

示例: ["interface ethernet 1/1/1", "ip address 192.168.0.1 255.255.255.0", "ipv6 address fd5d:12c9:2201:1::1/64"]

状态

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

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

作者

  • Ruckus Wireless (@Commscope)