community.general.dladm_vnic (0.1.1) — module

Install collection

Install with ansible-galaxy collection install community.general:==0.1.1

Add to requirements.yml

  collections:
    - name: community.general
      version: 0.1.1

Description

Create or delete VNICs on Solaris/illumos systems.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# Create 'vnic0' VNIC over 'bnx0' link
- dladm_vnic:
    name: vnic0
    link: bnx0
    state: present

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# 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

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# Remove 'vnic0' VNIC
- dladm_vnic:
    name: vnic0
    link: bnx0
    state: absent

Inputs

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

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

name:
    description:
    - VNIC name.
    required: true

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

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

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