Docs4dev
Docs
ansible / 2.10 / collections / purestorage / flasharray / purefa_pgsched_module.html

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.5.1).

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 Python library
  • 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/purestorage/flasharray/purefa_pgsched_module.html