Documentation

na_cdot_lun - Manage NetApp cDOT luns

New in version 2.3.

Synopsis

  • Create, destroy, resize luns on NetApp cDOT.

Requirements (on host that executes module)

  • 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’

Options

parameter required default choices comments
flexvol_name
no
The name of the FlexVol the lun should exist on.
Required when state=present.
force_remove
no
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_remove_fenced
no
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.
force_resize
no
Forcibly reduce the size. This is required for reducing the size of the LUN to avoid accidentally reducing the LUN size.
hostname
yes
The hostname or IP address of the ONTAP instance.
name
yes
The name of the lun to manage.
password
yes
Password for the specified user.
size
no
The size of the lun in size_unit.
Required when state=present.
size_unit
no gb
  • bytes
  • b
  • kb
  • mb
  • gb
  • tb
  • pb
  • eb
  • zb
  • yb
The unit used to interpret the size parameter.
state
yes
  • present
  • absent
Whether the specified lun should exist or not.
username
yes
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 https://goo.gl/BRu78Z.
vserver
yes
The name of the vserver to use.

Examples

- name: Create LUN
  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 }}"

- name: Resize Lun
  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 }}"

Notes

Note

  • The modules prefixed with netapp\_cdot are built to support the ONTAP storage platform.

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Support

This module is community maintained without core committer oversight.

For more information on what this means please read Module Support

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Helping Testing PRs and Developing Modules.