dladm_vnic – Manage VNICs on Solaris/illumos systems
dladm_vnic – Manage VNICs on Solaris/illumos systems
New in version 2.2.
Synopsis
- Create or delete VNICs on Solaris/illumos systems.
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
link - / required |
VNIC underlying link name. | |
mac - |
Default: "no" |
Sets the VNIC's MAC address. Must be valid unicast MAC address.
|
name - / required |
VNIC name. | |
state - |
|
Create or delete Solaris/illumos VNIC. |
temporary boolean |
|
Specifies that the VNIC is temporary. Temporary VNICs do not persist across reboots. |
vlan - |
Default: "no" |
Enable VLAN tagging for this VNIC. The VLAN tag will have id vlan.
|
Examples
# Create 'vnic0' VNIC over 'bnx0' link
- dladm_vnic:
name: vnic0
link: bnx0
state: present
# Create VNIC with specified MAC and VLAN tag over 'aggr0'
- dladm_vnic:
name: vnic1
link: aggr0
mac: '00:00:5E:00:53:23'
vlan: 4
# Remove 'vnic0' VNIC
- dladm_vnic:
name: vnic0
link: bnx0
state: absent
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
link string |
always |
VNIC underlying link name
Sample: igb0 |
mac string |
if mac is specified |
MAC address to use for VNIC
Sample: 00:00:5E:00:53:42 |
name string |
always |
VNIC name
Sample: vnic0 |
state string |
always |
state of the target
Sample: present |
temporary boolean |
always |
VNIC's persistence
Sample: True |
vlan integer |
success |
VLAN to use for VNIC
Sample: 42 |
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Adam Števko (@xen0l)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/dladm_vnic_module.html