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 的 k/v 对，或者在使用 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 的 k/v 对，或者在使用 vlan_range 时为 null

返回： 始终

示例： {"description": "", "name": "VLAN_APP", "vlan_id": "20"}

existing_vlans_list

列表 / 元素=字符串

在进行更改之前，交换机上现有 VLAN 的列表

返回： 始终

示例： ["1", "2", "3", "4", "5", "20"]

proposed

字典

传递到模块的参数的 k/v 对（不包括 vlan_id 或 vlan_range）

返回： 始终

示例： {"description": "vlan for app", "name": "VLAN_APP", "vlan_id": "20"}

proposed_vlans_list

列表 / 元素=字符串

提议的 VLAN 列表

返回： 始终

示例： ["100"]

updates

列表 / 元素=字符串

发送到设备的命令字符串

返回： 始终

示例： ["vlan 20", "name VLAN20"]

状态

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

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

作者

  • QijunPan (@QijunPan)