ansible.builtin.purefa_volume (v2.7.16) — module

Manage volumes on Pure Storage FlashArrays

| "added in version" 2.4 of ansible.builtin"

Authors: Simon Dodsley (@sdodsley)

preview | supported by community

Install Ansible via pip

Install with pip install ansible==2.7.16

Description

Create, delete or extend the capacity of a volume on Pure Storage FlashArray.


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Create new volume named foo
  purefa_volume:
    name: foo
    size: 1T
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: present
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Extend the size of an existing volume named foo
  purefa_volume:
    name: foo
    size: 2T
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: present
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Delete and eradicate volume named foo
  purefa_volume:
    name: foo
    eradicate: yes
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: absent
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Create clone of volume bar named foo
  purefa_volume:
    name: foo
    target: bar
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: present
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Overwrite volume bar with volume foo
  purefa_volume:
    name: foo
    target: bar
    overwrite: yes
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: present

Inputs

    
name:
    description:
    - The name of the volume.
    required: true

size:
    description:
    - Volume size in M, G, T or P units.

state:
    choices:
    - absent
    - present
    default: present
    description:
    - Define whether the volume should exist or not.

fa_url:
    description:
    - FlashArray management IPv4 address or Hostname.
    required: true
    type: str

target:
    description:
    - The name of the target volume, if copying.

api_token:
    description:
    - FlashArray API token for admin privileged user.
    required: true
    type: str

eradicate:
    default: 'no'
    description:
    - Define whether to eradicate the volume on delete or leave in trash.
    type: bool

overwrite:
    default: 'no'
    description:
    - Define whether to overwrite a target volume if it already exisits.
    type: bool