/ home / community / community.general / 8.5.0 / module / aix_devices

community.general.aix_devices (8.5.0) — module

Manages AIX devices

Authors: Kairo Araujo (@kairoaraujo)

Install collection

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

Add to requirements.yml

  collections:
    - name: community.general
      version: 8.5.0

Description

This module discovers, defines, removes and modifies attributes of AIX devices.

Usage examples

Scanned by Steampunk Spotter

- name: Scan new devices
  community.general.aix_devices:
    device: all
    state: available

Scanned by Steampunk Spotter

- name: Scan new virtual devices (vio0)
  community.general.aix_devices:
    device: vio0
    state: available

Scanned by Steampunk Spotter

- name: Removing IP alias to en0
  community.general.aix_devices:
    device: en0
    attributes:
      delalias4: 10.0.0.100,255.255.255.0

Scanned by Steampunk Spotter

- name: Removes ent2
  community.general.aix_devices:
    device: ent2
    state: removed

Scanned by Steampunk Spotter

- name: Put device en2 in Defined
  community.general.aix_devices:
    device: en2
    state: defined

Scanned by Steampunk Spotter

- name: Removes ent4 (inexistent).
  community.general.aix_devices:
    device: ent4
    state: removed

Scanned by Steampunk Spotter

- name: Put device en4 in Defined (inexistent)
  community.general.aix_devices:
    device: en4
    state: defined

Scanned by Steampunk Spotter

- name: Put vscsi1 and children devices in Defined state.
  community.general.aix_devices:
    device: vscsi1
    recursive: true
    state: defined

Scanned by Steampunk Spotter

- name: Removes vscsi1 and children devices.
  community.general.aix_devices:
    device: vscsi1
    recursive: true
    state: removed

Scanned by Steampunk Spotter

- name: Changes en1 mtu to 9000 and disables arp.
  community.general.aix_devices:
    device: en1
    attributes:
      mtu: 900
      arp: 'off'
    state: available

Scanned by Steampunk Spotter

- name: Configure IP, netmask and set en1 up.
  community.general.aix_devices:
    device: en1
    attributes:
      netaddr: 192.168.0.100
      netmask: 255.255.255.0
      state: up
    state: available

Scanned by Steampunk Spotter

- name: Adding IP alias to en0
  community.general.aix_devices:
    device: en0
    attributes:
      alias4: 10.0.0.100,255.255.255.0
    state: available

Inputs

    
force:
    default: false
    description:
    - Forces action.
    type: bool

state:
    choices:
    - available
    - defined
    - removed
    default: available
    description:
    - Controls the device state.
    - V(available) (alias V(present)) rescan a specific device or all devices (when O(device)
      is not specified).
    - V(removed) (alias V(absent) removes a device.
    - V(defined) changes device to Defined state.
    type: str

device:
    description:
    - The name of the device.
    - V(all) is valid to rescan C(available) all devices (AIX cfgmgr command).
    type: str

recursive:
    default: false
    description:
    - Removes or defines a device and children devices.
    type: bool

attributes:
    description:
    - A list of device attributes.
    type: dict