1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
|
#!/usr/bin/python
# -*- coding: utf-8 -*-
# (c) 2021, Simon Dodsley (simon@purestorage.com)
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
from __future__ import absolute_import, division, print_function
__metaclass__ = type
ANSIBLE_METADATA = {
"metadata_version": "1.1",
"status": ["preview"],
"supported_by": "community",
}
DOCUMENTATION = r"""
---
module: purefa_maintenance
version_added: '1.7.0'
short_description: Configure Pure Storage FlashArray Maintence Windows
description:
- Configuration for Pure Storage FlashArray Maintenance Windows.
author:
- Pure Storage Ansible Team (@sdodsley) <pure-ansible-team@purestorage.com>
options:
state:
description:
- Create or delete maintennance window
type: str
default: present
choices: [ absent, present ]
timeout :
type: int
default: 3600
description:
- Maintenance window period, specified in seconds.
- Range allowed is 1 minute (60 seconds) to 24 hours (86400 seconds)
- Default setting is 1 hour (3600 seconds)
extends_documentation_fragment:
- purestorage.flasharray.purestorage.fa
"""
EXAMPLES = r"""
- name: Delete exisitng maintenance window
purestorage.flasharray.purefa_maintenance:
state: absent
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Set maintnence window to default of 1 hour
purestorage.flasharray.purefa_maintenance:
state: present
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Update existing maintnence window
purestorage.flasharray.purefa_maintenance:
state: present
timeout: 86400
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
"""
RETURN = r"""
"""
HAS_PURESTORAGE = True
try:
from pypureclient import flasharray
except ImportError:
HAS_PURESTORAGE = False
from ansible.module_utils.basic import AnsibleModule
from ansible_collections.purestorage.flasharray.plugins.module_utils.purefa import (
get_array,
purefa_argument_spec,
)
def delete_window(module, array):
"""Delete Maintenance Window"""
changed = False
if list(array.get_maintenance_windows().items):
changed = True
if not module.check_mode:
state = array.delete_maintenance_windows(names=["environment"])
if state.status_code != 200:
changed = False
module.exit_json(changed=changed)
def set_window(module, array):
"""Set Maintenace Window"""
changed = True
if not 60 <= module.params["timeout"] <= 86400:
module.fail_json(msg="Maintenance Window Timeout is out of range (60 to 86400)")
window = flasharray.MaintenanceWindowPost(timeout=module.params["timeout"] * 1000)
if not module.check_mode:
state = array.post_maintenance_windows(
names=["environment"], maintenance_window=window
)
if state.status_code != 200:
module.fail_json(msg="Setting maintenance window failed")
module.exit_json(changed=changed)
def main():
argument_spec = purefa_argument_spec()
argument_spec.update(
dict(
timeout=dict(type="int", default=3600),
state=dict(type="str", default="present", choices=["absent", "present"]),
)
)
module = AnsibleModule(argument_spec, supports_check_mode=True)
if not HAS_PURESTORAGE:
module.fail_json(msg="py-pure-client sdk is required for this module")
array = get_array(module)
if module.params["state"] == "absent":
delete_window(module, array)
else:
set_window(module, array)
module.exit_json(changed=False)
if __name__ == "__main__":
main()
|
