Documentation

na_cdot_volume - Manage NetApp cDOT volumes

New in version 2.3.

Synopsis

  • Create or destroy volumes 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
aggregate_name
no
The name of the aggregate the flexvol should exist on. Required when state=present.
hostname
yes
The hostname or IP address of the ONTAP instance.
infinite
no False
  • True
  • False
Set True if the volume is an Infinite Volume.
name
yes
The name of the volume to manage.
online
no True
  • True
  • False
Whether the specified volume is online, or not.
password
yes
Password for the specified user.
size
no
The size of the volume 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 volume 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 None
Name of the vserver to use.

Examples

- name: Create FlexVol
  na_cdot_volume:
    state: present
    name: ansibleVolume
    infinite: False
    aggregate_name: aggr1
    size: 20
    size_unit: mb
    vserver: ansibleVServer
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Make FlexVol offline
  na_cdot_volume:
    state: present
    name: ansibleVolume
    infinite: False
    online: False
    vserver: ansibleVServer
    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, Testing Ansible and Developing Modules.