community.general.na_cdot_lun (1.3.14) — module

Install collection

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

Add to requirements.yml

  collections:
    - name: community.general
      version: 1.3.14

Description

Create, destroy, resize luns on NetApp cDOT.

Requirements

• A physical or virtual clustered Data ONTAP system. The modules were developed with Clustered Data ONTAP 8.3
• Ansible 2.2
• netapp-lib (2015.9.25). Install using 'pip install netapp-lib'

Usage examples

Scanned by Steampunk Spotter

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

- name: Create LUN
  community.general.na_cdot_lun:
    state: present
    name: ansibleLUN
    flexvol_name: ansibleVolume
    vserver: ansibleVServer
    size: 5
    size_unit: mb
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

Scanned by Steampunk Spotter

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

- name: Resize Lun
  community.general.na_cdot_lun:
    state: present
    name: ansibleLUN
    force_resize: True
    flexvol_name: ansibleVolume
    vserver: ansibleVServer
    size: 5
    size_unit: gb
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

Inputs

    
name:
    description:
    - The name of the lun to manage.
    required: true

size:
    description:
    - The size of the lun in C(size_unit).
    - Required when C(state=present).

state:
    choices:
    - present
    - absent
    description:
    - Whether the specified lun should exist or not.
    required: true

vserver:
    description:
    - The name of the vserver to use.
    required: true

hostname:
    description:
    - The hostname or IP address of the ONTAP instance.
    required: true

password:
    aliases:
    - pass
    description:
    - Password for the specified user.
    required: true

username:
    aliases:
    - user
    description:
    - This can be a Cluster-scoped or SVM-scoped account, depending on whether a Cluster-level
      or SVM-level API is required. For more information, please read the documentation
      U(https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/).
    required: true

size_unit:
    choices:
    - bytes
    - b
    - kb
    - mb
    - gb
    - tb
    - pb
    - eb
    - zb
    - yb
    default: gb
    description:
    - The unit used to interpret the size parameter.

flexvol_name:
    description:
    - The name of the FlexVol the lun should exist on.
    - Required when C(state=present).

force_remove:
    default: false
    description:
    - If "true", override checks that prevent a LUN from being destroyed if it is online
      and mapped.
    - If "false", destroying an online and mapped LUN will fail.

force_resize:
    default: false
    description:
    - Forcibly reduce the size. This is required for reducing the size of the LUN to avoid
      accidentally reducing the LUN size.

force_remove_fenced:
    default: false
    description:
    - If "true", override checks that prevent a LUN from being destroyed while it is fenced.
    - If "false", attempting to destroy a fenced LUN will fail.
    - The default if not specified is "false". This field is available in Data ONTAP 8.2
      and later.