community.network.icx_vlan 模块 – 管理 Ruckus ICX 7000 系列交换机上的 VLAN

注意

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

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

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

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

注意

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

已弃用

在以下版本中移除：

6.0.0 版本

原因：

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

替代方案：

未知。

概要

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

别名：network.icx.icx_vlan

参数

参数	注释
aggregate 列表 / 元素=字符串	VLAN 定义列表。
associated_interfaces 列表 / 元素=字符串	这是一个意图选项，它检查给定 vlan name 的关联接口的操作状态。如果 associated_interfaces 中的值与设备上 vlan 接口的操作状态不匹配，则会导致失败。
associated_tagged 列表 / 元素=字符串	这是一个意图选项，它检查给定 vlan name 的关联标记端口和 LAG 的操作状态。如果 associated_tagged 中的值与设备上 vlan 接口的操作状态不匹配，则会导致失败。
check_running_config 布尔值	检查运行配置。这可以设置为环境变量。模块将使用环境变量值（默认：True），除非通过将其指定为模块参数来覆盖它。 选项 false true
delay 整数	剧本应等待检查声明式意图参数值的时间延迟。
interfaces 字典	要作为访问（未标记）端口添加到 vlan 的以太网端口或 LAG 列表。要添加一系列端口，请使用“to”关键字。参见示例。
name 列表 / 元素=字符串	接口或 LAG 的名称
purge 布尔值	清除未在 *name* 中定义的接口 选项 false true
ip_arp_inspection 布尔值	在 VLAN 上启用动态 ARP 检查。 选项 false true
ip_dhcp_snooping 布尔值	在 VLAN 上启用 DHCP snooping。 选项 false true
name 字符串	VLAN 的名称。
state 字符串	VLAN 配置的状态。 选项 "present" "absent"
stp 字典	为此 vlan 启用生成树 802-1w/rstp。
enabled 布尔值	管理当前 vlan 中 spanning_tree_802_1w 的状态（启用/禁用） 选项 false true
priority 字符串	配置桥的优先级。该值范围为 0 到 65535。数值越低，桥的优先级越高。因此，最高优先级为 0。默认为 32768。
type 字符串	指定生成树的类型 选项 "802-1w" ← (默认) "rstp"
tagged 字典	要作为中继（标记）端口添加到 vlan 的以太网端口或 LAG 列表。要添加一系列端口，请使用“to”关键字。参见示例。
name 列表 / 元素=字符串	接口或 LAG 的名称
purge 布尔值	清除未在 *name* 中定义的接口 选项 false true
vlan_id 字符串 / 必需	VLAN 的 ID。范围 1-4094。
associated_interfaces 列表 / 元素=字符串	这是一个意图选项，它检查给定 vlan name 的关联接口的操作状态。如果 associated_interfaces 中的值与设备上 vlan 接口的操作状态不匹配，则会导致失败。
associated_tagged 列表 / 元素=字符串	这是一个意图选项，它检查给定 vlan name 的关联标记端口和 LAG 的操作状态。如果 associated_tagged 中的值与设备上 vlan 接口的操作状态不匹配，则会导致失败。
check_running_config 布尔值	检查运行配置。这可以设置为环境变量。模块将使用环境变量值（默认：True），除非通过将其指定为模块参数来覆盖它。 选项 false true ← (默认)
delay 整数	剧本应等待检查声明式意图参数值的时间延迟。 默认： 10
interfaces 字典	要作为访问（未标记）端口添加到 vlan 的以太网端口或 LAG 列表。要添加一系列端口，请使用“to”关键字。参见示例。
name 列表 / 元素=字符串	接口或 LAG 的名称
purge 布尔值	清除未在 *name* 中定义的接口 选项 false true
ip_arp_inspection 布尔值	在 VLAN 上启用动态 ARP 检查。 选项 false true
ip_dhcp_snooping 布尔值	在 VLAN 上启用 DHCP snooping。 选项 false true
name 字符串	VLAN 的名称。
purge 布尔值	清除未在 *aggregate* 参数中定义的 VLAN。 选项 false ← (默认) true
state 字符串	VLAN 配置的状态。 选项 "present" ← (默认) "absent"
stp 字典	为此 vlan 启用生成树 802-1w/rstp。
enabled 布尔值	管理当前 vlan 中 spanning_tree_802_1w 的状态（启用/禁用） 选项 false true
priority 字符串	配置桥的优先级。该值范围为 0 到 65535。数值越低，桥的优先级越高。因此，最高优先级为 0。默认为 32768。
type 字符串	指定生成树的类型 选项 "802-1w" ← (默认) "rstp"
tagged 字典	要作为中继（标记）端口添加到 vlan 的以太网端口或 LAG 列表。要添加一系列端口，请使用“to”关键字。参见示例。
name 列表 / 元素=字符串	接口或 LAG 的名称
purge 布尔值	清除未在 *name* 中定义的接口 选项 false true
vlan_id 整数 / 必需	VLAN 的 ID。范围 1-4094。

备注

注意

• 针对 ICX 10.1 进行了测试。

• 有关使用 ICX 平台的信息，请参阅 ICX OS 平台选项指南。

示例

- name: Add a single ethernet 1/1/48 as access(untagged) port to vlan 20
  community.network.icx_vlan:
    name: test-vlan
    vlan_id: 20
    interfaces:
      name:
        - ethernet 1/1/48

- name: Add a single LAG 10 as access(untagged) port to vlan 20
  community.network.icx_vlan:
    vlan_id: 20
    interfaces:
      name:
        - lag 10

- name: Add a range of ethernet ports as trunk(tagged) ports to vlan 20 by port
  community.network.icx_vlan:
    vlan_id: 20
    tagged:
      name:
        - ethernet 1/1/40 to 1/1/48

- name: Add discontinuous lags, ethernet ports as access(untagged) and trunk(tagged) port to vlan 20.
  community.network.icx_vlan:
    vlan_id: 20
    interfaces:
      name:
        - ethernet 1/1/40 to 1/1/48
        - ethernet 2/1/1
        - lag 1
        - lag 3 to 5
    tagged:
      name:
        - ethernet 1/1/20 to 1/1/25
        - lag 1 to 3

- name: Remove an access and range of trunk ports from vlan
  community.network.icx_vlan:
    vlan_id: 20
    interfaces:
      name:
        - ethernet 1/1/40
    tagged:
      name:
        - ethernet 1/1/39 to 1/1/70

- name: Enable dhcp snooping, disable arp inspection in vlan
  community.network.icx_vlan:
    vlan_id: 20
    ip_dhcp_snooping: present
    ip_arp_inspection: absent

- name: Create vlan 20.  Enable  arp inspection in vlan. Purge all other vlans.
  community.network.icx_vlan:
    vlan_id: 20
    ip_arp_inspection: present
    purge: present

- name: Remove vlan 20.
  community.network.icx_vlan:
    vlan_id: 20
    state: absent

返回值

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

键	描述
命令 列表 / 元素=字符串	发送到设备的配置模式命令列表 返回值：始终返回 示例： ["vlan 100", "name test-vlan"]

状态

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

• 更多信息请参见 已弃用。

作者

• Ruckus Wireless (@Commscope)

资源链接

• 问题追踪器
• 代码库 (源码)