netapp_eseries.santricity.netapp_e_snapshot_volume – NetApp E-Series manage snapshot volumes.

Note

This plugin is part of the netapp_eseries.santricity collection (version 1.2.13).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install netapp_eseries.santricity.

To use it in a playbook, specify: netapp_eseries.santricity.netapp_e_snapshot_volume.

New in version 2.2: of netapp_eseries.santricity

Synopsis

  • Create, update, remove snapshot volumes for NetApp E/EF-Series storage arrays.

Parameters

Parameter

Comments

api_password

string / required

The password to authenticate with the SANtricity WebServices Proxy or embedded REST API.

api_url

string / required

The url to the SANtricity WebServices Proxy or embedded REST API.

api_username

string / required

The username to authenticate with the SANtricity WebServices Proxy or embedded REST API.

full_threshold

integer

The repository utilization warning threshold percentage

Default: 85

name

string / required

The name you wish to give the snapshot volume

repo_percentage

integer

The size of the view in relation to the size of the base volume

Default: 20

snapshot_image_id

string / required

The identifier of the snapshot image used to create the new snapshot volume.

Note: You’ll likely want to use the M(netapp_e_facts) module to find the ID of the image you want.

ssid

string / required

storage array ID

state

string / required

Whether to create or remove the snapshot volume

Choices:

  • absent

  • present

storage_pool_name

string / required

Name of the storage pool on which to allocate the repository volume.

validate_certs

boolean

Should https certificates be validated?

Choices:

  • no

  • yes ← (default)

view_mode

string / required

The snapshot volume access mode

Choices:

  • readOnly ← (default)

  • readWrite

  • modeUnknown

  • __Undefined

Notes

Note

  • Only full_threshold is supported for update operations. If the snapshot volume already exists and the threshold matches, then an ok status will be returned, no other changes can be made to a pre-existing snapshot volume.

Examples

- name: Snapshot volume
  netapp_e_snapshot_volume:
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}/"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    state: present
    storage_pool_name: "{{ snapshot_volume_storage_pool_name }}"
    snapshot_image_id: "{{ snapshot_volume_image_id }}"
    name: "{{ snapshot_volume_name }}"

Return Values

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

Key

Description

msg

string

Success message

Returned: success

Sample: “Json facts for the volume that was created.”

Authors

  • Kevin Hulquest (@hulquest)