na_cdot_volume - Manage NetApp cDOT volumes
New in version 2.3.
Synopsis
- Create or destroy volumes on NetApp cDOT
Requirements
The below requirements are needed on the host that executes this 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’
Parameters
| Parameter | Choices/Defaults | Comments |
|---|---|---|
| aggregate_name | The name of the aggregate the flexvol should exist on. Required when state=present. | |
| export_policy (added in 2.6) | Default: "default" | Export policy to set for the specified junction path. |
| hostname required | The hostname or IP address of the ONTAP instance. | |
| infinite bool |
| Set True if the volume is an Infinite Volume. |
| junction_path (added in 2.6) | Junction path where to mount the volume | |
| name required | The name of the volume to manage. | |
| online bool |
| Whether the specified volume is online, or not. |
| password required | Password for the specified user. aliases: pass | |
| size | The size of the volume in (size_unit). Required when state=present. | |
| size_unit |
| The unit used to interpret the size parameter. |
| snapshot_policy (added in 2.6) | Default: "default" | Snapshot policy to set for the specified volume. |
| state required |
| Whether the specified volume should exist or not. |
| username required | 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. aliases: user | |
| vserver required | Name of the vserver to use. |
Notes
Note
- The modules prefixed with na_cdot are built to support the ONTAP storage platform.
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 }}"
junction_path: /ansibleVolume
export_policy: all_nfs_networks
snapshot_policy: daily
- 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 }}"
Status
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Maintenance
This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Community, see here.
Author
- Sumit Kumar (sumit4@netapp.com)
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/na_cdot_volume_module.html