community.general.nictagadm 模块 – 管理 SmartOS 系统上的网卡标签

注意

此模块是 community.general 集合（版本 10.1.0）的一部分。

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

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

要在 playbook 中使用它，请指定：community.general.nictagadm。

概要

  • 在 SmartOS 系统上创建或删除网卡标签。

参数

参数

注释

etherstub

布尔值

指定网卡标签将附加到创建的 etherstub。

参数 etherstub 与 mtu 和 mac 互斥。

选择

  • false ←（默认）

  • true

force

布尔值

当 state=absent 时，此开关将使用 -f 参数并删除网卡标签，而不管是否存在虚拟机。

选择

  • false ←（默认）

  • true

mac

字符串

指定不创建 etherstub 时，要将网卡标签附加到的 mac 地址。

参数 mac 和 etherstub 互斥。

mtu

整数

指定所需网卡标签的 mtu 大小。

参数 mtu 和 etherstub 互斥。

name

字符串 / 必填

网卡标签的名称。

state

字符串

创建或删除 SmartOS 网卡标签。

选择

  • "absent"

  • "present" ←（默认）

属性

属性

支持

描述

check_mode

支持：完全

可以在 check_mode 中运行并返回更改状态预测，而无需修改目标。

diff_mode

支持：无

在差异模式下，将返回有关已更改的内容（或可能需要在 check_mode 中更改的内容）的详细信息。

示例

- name: Create 'storage0' on '00:1b:21:a3:f5:4d'
  community.general.nictagadm:
    name: storage0
    mac: 00:1b:21:a3:f5:4d
    mtu: 9000
    state: present

- name: Remove 'storage0' nic tag
  community.general.nictagadm:
    name: storage0
    state: absent

返回值

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

键

描述

etherstub

布尔值

指定网卡标签是否将创建并附加到 etherstub。

返回：始终

示例：false

force

布尔值

显示在删除网卡标签期间是否使用了 -f

返回：始终

示例：false

mac

字符串

网卡标签附加到的 MAC 地址。

返回：始终

示例："00:1b:21:a3:f5:4d"

mtu

整数

指定在 nictagadm add 命令期间传递的 MTU 大小。mtu 和 etherstub 是互斥的。

返回：始终

示例：1500

name

字符串

网卡标签名称

返回：始终

示例："storage0"

state

字符串

目标状态

返回：始终

示例："present"

作者

  • Bruce Smith (@SmithX10)