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.
| Parameter | Choices/Defaults | Comments |
|---|---|---|
| etherstub boolean |
| Specifies that the nic tag will be attached to a created etherstub. Parameter etherstub is mutually exclusive with both mtu, and mac. |
| force boolean |
| 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 |
| Create or delete a SmartOS nic tag. |
- 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
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 |
© 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