Note
This plugin is part of the community.general collection.
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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/nictagadm_module.html