Documentation

netapp_e_storagepool - Manage disk groups and disk pools

New in version 2.2.

Synopsis

  • Create or remove disk groups and disk pools for NetApp E-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.
criteria_drive_count
 no
The number of disks to use for building the storage pool. The pool will be expanded if this number exceeds the number of disks already in place
criteria_drive_interface_type
 no
  • sas
  • sas4k
  • fibre
  • fibre520b
  • scsi
  • sata
  • pata
The interface type to use when selecting drives for the storage pool (no value means all interface types will be considered)
criteria_drive_min_size
 no
The minimum individual drive size (in size_unit) to consider when choosing drives for the storage pool.
criteria_drive_require_fde
 no
Whether full disk encryption ability is required for drives to be added to the storage pool
criteria_drive_type
 no
  • hdd
  • ssd
The type of disk (hdd or ssd) to use when searching for candidates to use.
criteria_min_usable_capacity
 no
The minimum size of the storage pool (in size_unit). The pool will be expanded if this value exceeds itscurrent size.
criteria_size_unit
 no gb
  • bytes
  • b
  • kb
  • mb
  • gb
  • tb
  • pb
  • eb
  • zb
  • yb
The unit used to interpret size parameters
erase_secured_drives
 no
  • true
  • false
Whether to erase secured disks before adding to storage pool
name
 yes
The name of the storage pool to manage
raid_level
 yes
  • raidAll
  • raid0
  • raid1
  • raid3
  • raid5
  • raid6
  • raidDiskPool
Only required when the requested state is 'present'. The RAID level of the storage pool to be created.
remove_volumes
 no
Prior to removing a storage pool, delete all volumes in the pool.
reserve_drive_count
 no
Set the number of drives reserved by the storage pool for reconstruction operations. Only valide on raid disk pools.
secure_pool
 no
  • true
  • false
Whether to convert to a secure storage pool. Will only work if all drives in the pool are security capable.
ssid
 yes
The ID of the array to manage (as configured on the web services proxy).
state
 yes
  • present
  • absent
Whether the specified storage pool should exist or not.
Note that removing a storage pool currently requires the removal of all defined volumes first.
validate_certs
 no True
Should https certificates be validated?

Examples

- name: No disk groups
  netapp_e_storagepool:
    ssid: "{{ ssid }}"
    name: "{{ item }}"
    state: absent
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"

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
Success message
 success string Json facts for the pool that was 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.