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.

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, Helping Testing PRs and Developing Modules.