W3cubDocs

/Ansible 2.11

netapp.elementsw.na_elementsw_snapshot_schedule – NetApp Element Software Snapshot Schedules

Note

This plugin is part of the netapp.elementsw collection (version 20.11.0).

To install it use: ansible-galaxy collection install netapp.elementsw.

To use it in a playbook, specify: netapp.elementsw.na_elementsw_snapshot_schedule.

New in version 2.7.0: of netapp.elementsw

Synopsis

  • Create, destroy, or update snapshot schedules on ElementSW

Requirements

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

  • The modules were developed with SolidFire 10.1
  • solidfire-sdk-python (1.1.0.92) or greater. Install using ‘pip install solidfire-sdk-python’

Parameters

Parameter Choices/Defaults Comments
account_id
string
Account ID for the owner of this volume.
It accepts either account_name or account_id
if account_id is digit, it will consider as account_id
If account_id is string, it will consider as account_name
days_of_month_hours
integer
Time specified in hours
days_of_month_minutes
integer
Time specified in minutes.
days_of_month_monthdays
list / elements=integer
List of days of the month (1-31)
days_of_week_hours
integer
Time specified in hours
days_of_week_minutes
integer
Time specified in minutes.
days_of_week_weekdays
list / elements=string
List of days of the week (Sunday to Saturday)
hostname
string / required
The hostname or IP address of the SolidFire cluster.
For na_elementsw_cluster, the Management IP (MIP) or hostname of the node to initiate the cluster creation from.
name
string / required
Name for the snapshot schedule.
It accepts either schedule_id or schedule_name
if name is digit, it will consider as schedule_id
If name is string, it will consider as schedule_name
password
string / required
Password for the specified user.

aliases: pass
paused
boolean
    Choices:
  • no
  • yes
Pause / Resume a schedule.
recurring
boolean
    Choices:
  • no
  • yes
Should the schedule recur?
retention
string
Retention period for the snapshot.
Format is 'HH:mm:ss'.
schedule_type
string
    Choices:
  • DaysOfWeekFrequency
  • DaysOfMonthFrequency
  • TimeIntervalFrequency
Schedule type for creating schedule.
snapshot_name
string
Name for the created snapshots.
starting_date
string
Starting date for the schedule.
Required when state=present.
Format: 2016-12-01T00:00:00Z
state
string
    Choices:
  • present ←
  • absent
Whether the specified schedule should exist or not.
time_interval_days
integer
Time interval in days.
time_interval_hours
integer
Time interval in hours.
time_interval_minutes
integer
Time interval in minutes.
username
string / required
Please ensure that the user has the adequate permissions. For more information, please read the official documentation https://mysupport.netapp.com/documentation/docweb/index.html?productID=62636&language=en-US.

aliases: user
volumes
list / elements=string
Volume IDs that you want to set the snapshot schedule for.
It accepts both volume_name and volume_id

Notes

Note

  • The modules prefixed with na\_elementsw are built to support the SolidFire storage platform.

Examples

- name: Create Snapshot schedule
  na_elementsw_snapshot_schedule:
    hostname: "{{ elementsw_hostname }}"
    username: "{{ elementsw_username }}"
    password: "{{ elementsw_password }}"
    state: present
    name: Schedule_A
    schedule_type: TimeIntervalFrequency
    time_interval_days: 1
    starting_date: '2016-12-01T00:00:00Z'
    retention: '24:00:00'
    volumes:
    - 7
    - test
    account_id: 1

- name: Update Snapshot schedule
  na_elementsw_snapshot_schedule:
    hostname: "{{ elementsw_hostname }}"
    username: "{{ elementsw_username }}"
    password: "{{ elementsw_password }}"
    state: present
    name: Schedule_A
    schedule_type: TimeIntervalFrequency
    time_interval_days: 1
    starting_date: '2016-12-01T00:00:00Z'
    retention: '24:00:00'
    volumes:
    - 8
    - test1
    account_id: 1

- name: Delete Snapshot schedule
  na_elementsw_snapshot_schedule:
    hostname: "{{ elementsw_hostname }}"
    username: "{{ elementsw_username }}"
    password: "{{ elementsw_password }}"
    state: absent
    name: 6

Return Values

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

Key Returned Description
schedule_id
string
success
Schedule ID of the newly created schedule


Authors

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/netapp/elementsw/na_elementsw_snapshot_schedule_module.html