/ home / community / community.network / 5.0.2 / module / dladm_vnic

community.network.dladm_vnic (5.0.2) — module

Manage VNICs on Solaris/illumos systems.

Authors: Adam Števko (@xen0l)

Install collection

Install with ansible-galaxy collection install community.network:==5.0.2

Add to requirements.yml

  collections:
    - name: community.network
      version: 5.0.2

Description

Create or delete VNICs on Solaris/illumos systems.

Usage examples

Scanned by Steampunk Spotter

- name: Create 'vnic0' VNIC over 'bnx0' link
  community.network.dladm_vnic:
    name: vnic0
    link: bnx0
    state: present

Scanned by Steampunk Spotter

- name: Create VNIC with specified MAC and VLAN tag over 'aggr0'
  community.network.dladm_vnic:
    name: vnic1
    link: aggr0
    mac: '00:00:5E:00:53:23'
    vlan: 4

Scanned by Steampunk Spotter

- name: Remove 'vnic0' VNIC
  community.network.dladm_vnic:
    name: vnic0
    link: bnx0
    state: absent

Inputs

    
mac:
    aliases:
    - macaddr
    description:
    - Sets the VNIC's MAC address. Must be valid unicast MAC address.
    required: false
    type: str

link:
    description:
    - VNIC underlying link name.
    required: true
    type: str

name:
    description:
    - VNIC name.
    required: true
    type: str

vlan:
    aliases:
    - vlan_id
    default: false
    description:
    - Enable VLAN tagging for this VNIC. The VLAN tag will have id I(vlan).
    required: false
    type: int

state:
    choices:
    - present
    - absent
    default: present
    description:
    - Create or delete Solaris/illumos VNIC.
    required: false
    type: str

temporary:
    default: false
    description:
    - Specifies that the VNIC is temporary. Temporary VNICs do not persist across reboots.
    required: false
    type: bool

Outputs

link:
  description: VNIC underlying link name
  returned: always
  sample: igb0
  type: str
mac:
  description: MAC address to use for VNIC
  returned: if mac is specified
  sample: 00:00:5E:00:53:42
  type: str
name:
  description: VNIC name
  returned: always
  sample: vnic0
  type: str
state:
  description: state of the target
  returned: always
  sample: present
  type: str
temporary:
  description: VNIC's persistence
  returned: always
  sample: 'True'
  type: bool
vlan:
  description: VLAN to use for VNIC
  returned: success
  sample: 42
  type: int