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 侦听。 选项 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 侦听。 选项 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

返回值

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

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

状态

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

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

作者

• Ruckus Wireless (@Commscope)

集合链接

• 问题跟踪器
• 存储库（源代码）