community.network.ce_vlan 模块 – 在华为 CloudEngine 交换机上管理 VLAN 资源和属性。

注意

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

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

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

要在 playbook 中使用它，请指定：community.network.ce_vlan。

注意

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

已弃用

在以下版本中移除：

6.0.0 版本

原因：

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

替代方案：

未知。

概要

• 管理华为 CloudEngine 交换机上的 VLAN 配置。

别名：network.cloudengine.ce_vlan

参数

参数	注释
description 字符串	指定 VLAN 描述，至少 1 个字符，最多 80 个字符。
name 字符串	VLAN 名称，至少 1 个字符，最多 31 个字符。
state 字符串	管理资源的状态。 选项 "present" ← (默认) "absent"
vlan_id 字符串	单个 VLAN ID，范围为 1 到 4094。
vlan_range 字符串	VLAN 范围，例如 2-10 或 2,5,10-15 等。

注释

注意

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

• 推荐连接方式为 netconf。

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

示例

- name: Vlan module test
  hosts: cloudengine
  connection: local
  gather_facts: false
  vars:
    cli:
      host: "{{ inventory_hostname }}"
      port: "{{ ansible_ssh_port }}"
      username: "{{ username }}"
      password: "{{ password }}"
      transport: cli

  tasks:

  - name: Ensure a range of VLANs are not present on the switch
    community.network.ce_vlan:
      vlan_range: "2-10,20,50,55-60,100-150"
      state: absent
      provider: "{{ cli }}"

  - name: Ensure VLAN 50 exists with the name WEB
    community.network.ce_vlan:
      vlan_id: 50
      name: WEB
      state: absent
      provider: "{{ cli }}"

  - name: Ensure VLAN is NOT on the device
    community.network.ce_vlan:
      vlan_id: 50
      state: absent
      provider: "{{ cli }}"

返回值

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

键	描述
changed 布尔值	检查设备上是否进行了更改 返回：始终 示例：true
end_state 字典	执行模块后 VLAN 的键值对，或使用 vlan_range 时为 null 返回：始终 示例：{"description": "vlan for app", "name": "VLAN_APP", "vlan_id": "20"}
end_state_vlans_list 列表 / 元素=字符串	模块执行后的 VLAN 列表 返回：始终 示例：["1", "2", "3", "4", "5", "20", "100"]
existing 字典	现有 VLAN 的键值对，或使用 vlan_range 时为 null 返回：始终 示例：{"description": "", "name": "VLAN_APP", "vlan_id": "20"}
existing_vlans_list 列表 / 元素=字符串	进行更改之前交换机上现有 VLAN 的列表 返回：始终 示例： ["1", "2", "3", "4", "5", "20"]
建议值 字典	传递给模块的参数的键值对（不包括vlan_id或vlan_range） 返回：始终 示例：{"description": "vlan for app", "name": "VLAN_APP", "vlan_id": "20"}
proposed_vlans_list 列表 / 元素=字符串	建议的VLAN列表 返回：始终 示例： ["100"]
更新 列表 / 元素=字符串	发送到设备的命令字符串 返回：始终 示例： ["vlan 20", "name VLAN20"]

状态

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

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

作者

• 潘启俊 (@QijunPan)

资源链接

• 问题追踪
• 代码仓库