community.network.dladm_vnic 模块 – 管理 Solaris/illumos 系统上的 VNIC。

注意

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

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

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

要在剧本中使用它,请指定:community.network.dladm_vnic

注意

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

已弃用

在以下版本中移除:

版本 6.0.0

原因:

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

替代方案:

未知。

概要

  • 在 Solaris/illumos 系统上创建或删除 VNIC。

别名:network.illumos.dladm_vnic

参数

参数

注释

字符串 / 必需

VNIC 底层链接名称。

mac

别名:macaddr

字符串

设置 VNIC 的 MAC 地址。必须是有效的单播 MAC 地址。

name

字符串 / 必需

VNIC 名称。

state

字符串

创建或删除 Solaris/illumos VNIC。

选项

  • "present" ← (默认)

  • "absent"

temporary

布尔值

指定 VNIC 是临时的。临时 VNIC 不会在重启后保留。

选项

  • false ← (默认)

  • true

vlan

别名:vlan_id

整数

为此 VNIC 启用 VLAN 标记。VLAN 标记的 ID 将为 vlan

默认: false

示例

- name: Create 'vnic0' VNIC over 'bnx0' link
  community.network.dladm_vnic:
    name: vnic0
    link: bnx0
    state: present

- name: Create VNIC with specified MAC and VLAN tag over 'aggr0'
  community.network.dladm_vnic:
    name: vnic1
    link: aggr0
    mac: '00:00:5E:00:53:23'
    vlan: 4

- name: Remove 'vnic0' VNIC
  community.network.dladm_vnic:
    name: vnic0
    link: bnx0
    state: absent

返回值

常见的返回值记录在此处,以下是此模块独有的字段

描述

字符串

VNIC 底层链接名称

返回: 始终

示例: "igb0"

mac

字符串

用于 VNIC 的 MAC 地址

返回: 如果指定了 mac

示例: "00:00:5E:00:53:42"

name

字符串

VNIC 名称

返回: 始终

示例: "vnic0"

state

字符串

目标状态

返回: 始终

示例: "present"

temporary

布尔值

VNIC 的持久性

返回: 始终

示例: true

vlan

整数

用于 VNIC 的 VLAN

返回: 成功

示例: 42

状态

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

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

作者

  • Adam Števko (@xen0l)