community.general.nictagadm – Manage nic tags on SmartOS systems

Note

This plugin is part of the community.general collection (version 3.8.1).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.nictagadm.

Synopsis

  • Create or delete nic tags on SmartOS systems.

Parameters

Parameter Choices/Defaults Comments
etherstub
boolean
    Choices:
  • no
  • yes
Specifies that the nic tag will be attached to a created etherstub.
Parameter etherstub is mutually exclusive with both mtu, and mac.
force
boolean
    Choices:
  • no
  • yes
When state is absent set this switch will use the -f parameter and delete the nic tag regardless of existing VMs.
mac
string
Specifies the mac address to attach the nic tag to when not creating an etherstub.
Parameters mac and etherstub are mutually exclusive.
mtu
integer
Specifies the size of the mtu of the desired nic tag.
Parameters mtu and etherstub are mutually exclusive.
name
string / required
Name of the nic tag.
state
string
    Choices:
  • absent
  • present
Create or delete a SmartOS nic tag.

Examples

- 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

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
etherstub
boolean
always
specifies if the nic tag will create and attach to an etherstub.

force
boolean
always
Shows if -f was used during the deletion of a nic tag

mac
string
always
MAC Address that the nic tag was attached to.

Sample:
00:1b:21:a3:f5:4d
mtu
integer
always
specifies which MTU size was passed during the nictagadm add command. mtu and etherstub are mutually exclusive.

Sample:
1500
name
string
always
nic tag name

Sample:
storage0
state
string
always
state of the target

Sample:
present


Authors

  • Bruce Smith (@SmithX10)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/nictagadm_module.html