W3cubDocs

/Ansible

netapp_e_volume - Manage storage volumes (standard and thin)

New in version 2.2.

Synopsis

Create or remove volumes (standard and thin) for NetApp E/EF-series storage arrays.

Options

parameter required default choices comments
api_password
 yes
The password to authenticate with the SANtricity WebServices Proxy or embedded REST API.
api_url
 yes
The url to the SANtricity WebServices Proxy or embedded REST API.
api_username
 yes
The username to authenticate with the SANtricity WebServices Proxy or embedded REST API.
data_assurance_enabled
 no
If data assurance should be enabled for the volume
name
 yes
The name of the volume to manage
segment_size_kb
 no 512
The segment size of the new volume
size
 yes
Required only when state = 'present'. The size of the volume in (size_unit).
size_unit
 no gb
  • bytes
  • b
  • kb
  • mb
  • gb
  • tb
  • pb
  • eb
  • zb
  • yb
The unit used to interpret the size parameter
ssd_cache_enabled
 no None (ignores existing SSD cache setting)
  • yes
  • no
  • true
  • false
Whether an existing SSD cache should be enabled on the volume (fails if no SSD cache defined)
ssid
 yes
The ID of the array to manage (as configured on the web services proxy).
state
 yes
  • present
  • absent
Whether the specified volume should exist or not.
storage_pool_name
 yes
Required only when requested state is 'present'. The name of the storage pool the volume should exist on.
thin_provision
 no
  • yes
  • no
  • true
  • false
Whether the volume should be thin provisioned. Thin volumes can only be created on disk pools (raidDiskPool).
thin_volume_max_repo_size
 no same as size (in size_unit)
Maximum size that the thin volume repository volume will automatically expand to
thin_volume_repo_size
 yes
Initial size of the thin volume repository volume (in size_unit)
validate_certs
 no True
Should https certificates be validated?

Examples

- name: No thin volume
  netapp_e_volume:
    ssid: "{{ ssid }}"
    name: NewThinVolumeByAnsible
    state: absent
    log_path: /tmp/volume.log
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"
  when: check_volume


- name: No fat volume
  netapp_e_volume:
    ssid: "{{ ssid }}"
    name: NewVolumeByAnsible
    state: absent
    log_path: /tmp/volume.log
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"
  when: check_volume

Return Values

Common return values are documented here Common Return Values, the following are the fields unique to this module:

name description returned type sample
msg

This is an Extras Module

For more information on what this means please read Extras Modules

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

© 2012–2016 Michael DeHaan
© 2016 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/netapp_e_volume_module.html