Documentation

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. This value must be unique for each array.
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 Return Values, the following are the fields unique to this module:

name description returned type sample
msg
State of volume
 always string Standard volume [workload_vol_1] has been created.


Status

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

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