W3cubDocs

/Ansible

purestorage.flasharray.purefa_pgsched – Manage protection groups replication schedules on Pure Storage FlashArrays

Note

This plugin is part of the purestorage.flasharray collection (version 1.11.0).

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 purestorage.flasharray.

To use it in a playbook, specify: purestorage.flasharray.purefa_pgsched.

New in version 1.0.0: of purestorage.flasharray

Synopsis

  • Modify or delete protection groups replication schedules on Pure Storage FlashArrays.

Requirements

The below requirements are needed on the host that executes this module.

  • python >= 2.7
  • purestorage >= 1.19
  • py-pure-client >= 1.6.0
  • netaddr
  • requests

Parameters

Parameter Choices/Defaults Comments
all_for
integer
Specifies the length of time, in seconds, to keep the snapshots on the source array before they are eradicated.
Range available 1 - 34560000.
api_token
string
FlashArray API token for admin privileged user.
blackout_end
string
Specifies the time at which to restart replication.
Provide a time in 12-hour AM/PM format, eg. 5PM
blackout_start
string
Specifies the time at which to suspend replication.
Provide a time in 12-hour AM/PM format, eg. 11AM
days
integer
Specifies the number of days to keep the per_day snapshots beyond the all_for period before they are eradicated
Max retention period is 4000 days
enabled
boolean
    Choices:
  • no
  • yes ←
Enable the schedule being configured.
fa_url
string
FlashArray management IPv4 address or Hostname.
name
string / required
The name of the protection group.
per_day
integer
Specifies the number of per_day snapshots to keep beyond the all_for period.
Maximum number is 1440
replicate_at
integer
Specifies the preferred time as HH:MM:SS, using 24-hour clock, at which to generate snapshots.
replicate_frequency
integer
Specifies the replication frequency in seconds.
Range 900 - 34560000 (FA-405, //M10, //X10i and Cloud Block Store).
Range 300 - 34560000 (all other arrays).
schedule
string / required
    Choices:
  • replication
  • snapshot
Which schedule to change.
snap_at
integer
Specifies the preferred time as HH:MM:SS, using 24-hour clock, at which to generate snapshots.
Only valid if snap_frequency is an exact multiple of 86400, ie 1 day.
snap_frequency
integer
Specifies the snapshot frequency in seconds.
Range available 300 - 34560000.
state
string
    Choices:
  • absent
  • present ←
Define whether to set or delete the protection group schedule.
target_all_for
integer
Specifies the length of time, in seconds, to keep the replicated snapshots on the targets.
Range is 1 - 34560000 seconds.
target_days
integer
Specifies the number of days to keep the target_per_day replicated snapshots beyond the target_all_for period before they are eradicated.
Max retention period is 4000 days
target_per_day
integer
Specifies the number of per_day replicated snapshots to keep beyond the target_all_for period.
Maximum number is 1440

Notes

Note

  • This module requires the purestorage and py-pure-client Python libraries
  • Additional Python librarues may be required for specific modules.
  • You must set PUREFA_URL and PUREFA_API environment variables if fa_url and api_token arguments are not passed to the module directly

Examples

- name: Update protection group snapshot schedule
  purefa_pgsched:
    name: foo
    schedule: snapshot
    enabled: true
    snap_frequency: 86400
    snap_at: 15:30:00
    per_day: 5
    all_for: 5
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Update protection group replication schedule
  purefa_pgsched:
    name: foo
    schedule: replication
    enabled: true
    replicate_frequency: 86400
    replicate_at: 15:30:00
    target_per_day: 5
    target_all_for: 5
    blackout_start: 2AM
    blackout_end: 5AM
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Delete protection group snapshot schedule
  purefa_pgsched:
    name: foo
    scheduke: snapshot
    state: absent
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Delete protection group replication schedule
  purefa_pgsched:
    name: foo
    scheduke: replication
    state: absent
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

Authors

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/purestorage/flasharray/purefa_pgsched_module.html