Debian Codegraph @

ansible_collections/netapp/ontap/CHANGELOG.md

raw
1 # Release Notes
2
3 ## 23.5.0
4
5 ### Major Changes
6 - na_ontap_debug - AWS Lambda support added to the module.
7 - na_ontap_job_schedule - AWS Lambda support added to the module.
8 - na_ontap_rest_info - AWS Lambda support added to the module.
9 - na_ontap_restit - AWS Lambda support added to the module.
10 - na_ontap_wait_for_condition - AWS Lambda support added to the module.
11 - na_ontap_dns - AWS Lambda support added to the module.
12 - na_ontap_domain_tunnel - AWS Lambda support added to the module.
13 - na_ontap_flexcache - AWS Lambda support added to the module.
14 - na_ontap_iscsi - AWS Lambda support added to the module.
15 - na_ontap_iscsi_security - AWS Lambda support added to the module.
16 - na_ontap_efficiency_policy - AWS Lambda support added to the module.
17 - na_ontap_export_policy_rule - AWS Lambda support added to the module.
18 - na_ontap_export_policy - AWS Lambda support added to the module.
19 - na_ontap_snapmirror_policy - AWS Lambda support added to the module.
20 - na_ontap_snapshot_policy - AWS Lambda support added to the module.
21 - na_ontap_local_hosts - AWS Lambda support added to the module.
22 - na_ontap_qos_policy_group - AWS Lambda support added to the module.
23 - na_ontap_quotas - AWS Lambda support added to the module.
24 - na_ontap_ldap_client - AWS Lambda support added to the module.
25 - na_ontap_name_mappings - AWS Lambda support added to the module.
26 - na_ontap_name_service_switch - AWS Lambda support added to the module.
27 - na_ontap_nfs - AWS Lambda support added to the module.
28 - na_ontap_qtree - AWS Lambda support added to the module.
29 - na_ontap_vserver_peer_permissions - AWS Lambda support added to the module.
30 - Updated ONTAP personality check functionality.
31
32 ### Minor Changes
33 - na_ontap_svm - Added option `anti_ransomware_default_volume_state` in REST.
34 - na_ontap_s3_users - new options `access_key` & `secret_key` added.
35 - na_ontap_security_certificates - Added support to generate certificate signing requests (CSRs) in REST.
36 - na_ontap_volume - new option `anti_ransomware.state` added in REST, requires ONTAP 9.10 or later.
37 - na_ontap_volume - updated docs for `tiering_policy`.
38 - updated `README` with information on ASA r2 support.
39
40 ### Bug Fixes
41 - na_ontap_export_policy_rule - Fixed issue in re-indexing of an existing rule.
42 - na_ontap_volume_efficiency - Fixed issue with GET timeout by adding new `rest_timeout` option.
43 - na_ontap_cifs_server - Fixed issue with updating comments when using REST API.
44 - na_ontap_vserver_delete - Added `check_mode` to the task that deletes the vserver to ensure support for dry-run mode.
45 - na_ontap_user_role - fixed issue when creating user role privileges with empty or null query.
46 - na_ontap_vserver_delete - Added `retry_count` variable to the task that collects and deletes volumes to ensure support for retries when errors are encountered during volume deletion.
47 - na_ontap_vserver_delete- Added gathering of NVMe subsystems and deletion of them before deleting the vserver to fix errors when NVMe subsystems are present.
48
49 ## 23.4.0
50
51 ### New Modules
52 - na_ontap_autoupdate_config - REST only support for managing configurations for automatic updates, requires ONTAP 9.10.1 or later.
53 - na_ontap_cg - REST only support for managing consistency groups, requires ONTAP 9.10.1 or later.
54
55 ### Major Changes
56 - na_ontap_snapmirror - AWS Lambda support added to the module.
57 - na_ontap_cluster_peer - AWS Lambda support added to the module.
58 - na_ontap_vserver_peer - AWS Lambda support added to the module.
59 - na_ontap_volume_autosize - AWS Lambda support added to the module.
60 - na_ontap_volume_efficiency- AWS Lambda support added to the module.
61 - na_ontap_volume_clone - AWS Lambda support added to the module.
62 - na_ontap_lun_map - AWS Lambda support added to the module.
63 - na_ontap_lun_map_reporting_nodes - AWS Lambda support added to the module.
64 - na_ontap_lun_copy - AWS Lambda support added to the module.
65 - na_ontap_igroup_initiator - AWS Lambda support added to the module.
66 - na_ontap_igroup - AWS Lambda support added to the module.
67 - na_ontap_cifs - AWS Lambda support added to the module.
68 - na_ontap_cifs_privileges - AWS Lambda support added to the module.
69 - na_ontap_cifs_server - AWS Lambda support added to the module.
70 - na_ontap_cifs_unix_symlink_mapping - AWS Lambda support added to the module.
71 - na_ontap_cifs_acl - AWS Lambda support added to the module.
72 - na_ontap_cifs_local_group_member - AWS Lambda support added to the module.
73 - na_ontap_cifs_local_group - AWS Lambda support added to the module.
74 - na_ontap_cifs_local_user - AWS Lambda support added to the module.
75 - na_ontap_cifs_local_user_set_password - AWS Lambda support added to the module.
76 - na_ontap_s3_buckets - AWS Lambda support added to the module.
77 - na_ontap_s3_groups - AWS Lambda support added to the module.
78 - na_ontap_s3_policies - AWS Lambda support added to the module.
79 - na_ontap_s3_services - AWS Lambda support added to the module.
80 - na_ontap_s3_users - AWS Lambda support added to the module.
81
82 ### Minor Changes
83 - na_ontap_snapmirror - updated documentation for `identity_preserve` and `max_transfer_rate`.
84 - na_ontap_nfs - new option `credential_cache` added in REST.
85 - na_ontap_ldap_client - Added options `group_dn` and `user_dn` in REST.
86 - na_ontap_lun - updated documentation for unsupported REST parameters.
87 - na_ontap_snapmirror - new options `time_out`, `wait_for_completion` added in REST.
88 - na_ontap_volume_efficiency- Added `wait_for_completion` and `time_out` parameters to fix time out errors for long running operations.
89
90 ### Bug Fixes
91 - na_ontap_vserver_audit - updated documentation for `log`.
92 - na_ontap_volume - Fixed issue with volume rename.
93 - na_ontap_lun - Updated module with alias `volume_name` for `flexvol_name`.
94 - na_ontap_snapmirror_policy - updated examples for creating and modifying snapmirror policy.
95 - na_ontap_qtree - Updated module with alias `volume_name` for `flexvol_name`.
96 - na_ontap_service_processor_network - fixed issue with interface state not being applied correctly,
97 resolved ipv6 comparison issue and idempotency issue with ZAPI abd REST.
98 - na_ontap_user_role - Removed special handling of `DEFAULT` path and normalized empty query in privileges to None for consistency.
99 - na_ontap_export_policy_rule - Fixed issue where rule_index was not being applied to create body,
100 and added logic to detect when a create action is actually a re-index of an existing rule.
101
102 ## 23.3.0
103
104 ### Major Changes
105 - na_ontap_interface - AWS Lambda support added to the module.
106 - na_ontap_lun - AWS Lambda support added to the module.
107 - na_ontap_snapshot - AWS Lambda support added to the module.
108 - na_ontap_svm - AWS Lambda support added to the module.
109
110 ### Minor Changes
111 - na_ontap_ems_filter - new option `parameter_criteria` added in REST, requires ONTAP 9.13.1 or later.
112 - na_ontap_net_ifgrp - Update `mode` parameter to specify allowed values.
113
114 ### Bug Fixes
115 - na_ontap_qtree - updated documentation for `unix_permissions` parameter to clarify its usage.
116 - na_ontap_aggregate - fixed issue with disabling software encryption in REST.
117 - na_ontap_firmware_upgrade - Updated documentation for `node` parameter and added examples.
118 - na_ontap_cg_snapshot - fixed issue with ZAPI by removing default value for `consistency_type`.
119 - na_ontap_cifs_local_group - fixed issue with idempotency.
120 - na_ontap_net_vlan - Fixed state detection when VLAN exists but is not in broadcast domain.
121 - na_ontap_job_schedule - Fix documentation formatting issue.
122
123 ## 23.2.0
124
125 ### Minor Changes
126 - na_ontap_net_port - Added REST support for `flowcontrol_admin` and `ipspace`.
127 - na_ontap_cg_snapshot - new option `consistency_type` added in REST.
128 - na_ontap_job_schedule - new option `vserver` added in REST.
129 - na_ontap_autosupport - Replaced private cli with REST API.
130 - na_ontap_nfs - new protocol options added in REST.
131 - na_ontap_job_schedule - new option `interval` added in REST.
132 - na_ontap_lun - new option `provisioning_options` added in REST, requires ONTAP 9.16.1 or later.
133 - na_ontap_software_update - updated documentation for `validate_after_download` parameter.
134 - na_ontap_snapshot - new option `snaplock_expiry_time` added in REST, requires ONTAP 9.15.1 or later.
135 - na_ontap_volume_clone - new options `time_out`, `wait_for_completion` added in REST.
136 - na_ontap_security_ssh - new option `host_key_algorithms`, requires ONTAP 9.16.1 or later.
137 - na_ontap_rest_info - added error handling when API doesn't return zero records.
138 - na_ontap_rest_info - support added for `application/consistency-groups/metrics`.
139 - na_ontap_rest_info - support added for `application/consistency-groups/snapshots`.
140 - na_ontap_svm - new option `storage_limit_threshold_alert` added in REST, requires ONTAP 9.13.1 or later.
141 - na_ontap_svm - new options `auto_enable_analytics`, `auto_enable_activity_tracking` added in REST, requires ONTAP 9.12.1 or later.
142 - na_ontap_nfs - added REST support for option `nfsv3_fsid_change` (requires ONTAP 9.11.0 or later), and for `nfsv4_fsid_change`, `nfsv40_referrals`, and `nfsv41_referrals` (requires ONTAP 9.13.1 or later).
143 - na_ontap_quotas - updated docs for `quota_target` and `type`.
144 - na_ontap_user - updated docs for `vserver` option.
145 - na_ontap_volume_autosize - updated docs for `increment_size` & `reset`.
146 - na_ontap_aggregate - AWS Lambda support added to the module.
147 - na_ontap_volume - AWS Lambda support added to the module.
148 - modified ZAPI deprecation messages and warnings.
149 - updated `README` template; added 'Support' section.
150
151 ### Bug Fixes
152 - na_ontap_snapmirror - fixed intermittent issue with creating relationship.
153 - na_ontap_volume - fix idempotency issue with `nas_application_template` and `size_change_threshold`.
154 - na_ontap_volume - fix idempotency issue with `nas_application_template` and `size_change_threshold`.
155 - Added manual utf-8 encoding to handle unicode characters in passwords for HTTP Basic Authentication in netapp module utilities.
156 - na_ontap_ntfs_dacl - fixed typo in short description.
157
158 ## 23.1.0
159
160 ### Minor Changes
161 - na_ontap_support_config_backup - new option `set_password` added in REST.
162 - na_ontap_cluster_peer - new option `local_name_for_peer` and `local_name_for_source` added in REST.
163 - na_ontap_s3_buckets - new option `snapshot_policy` added in REST, requires ONTAP 9.16.1 or later.
164 - na_ontap_volume - new option `tiering_object_tags` added in REST.
165 - na_ontap_cluster_peer - new option `local_name_for_peer` and `local_name_for_source` added in REST.
166 - na_ontap_snapmirror - new option `quick_resync` added in REST.
167 - na_ontap_nfs - new option `nfsv3_hide_snapdir` added in REST.
168 - na_ontap_user - added `totp` option for `application_dicts.second_authentication_method` in REST.
169 - na_ontap_security_certificates - updated examples for create server type certificate and install with intermediate certificates.
170 - na_ontap_cifs_acl - added example showing ACL deletion.
171 - na_ontap_svm - new option `storage_limit` added in REST, requires ONTAP 9.13.1 or later.
172 - na_ontap_rest_cli - added `next` key to enable API pagination support.
173 - updated `README`, added `CHANGELOG.md` for release notes.
174
175 ### Bug Fixes
176 - na_ontap_cg_snapshot - fixed issue with CG not being found with given volumes in REST.
177 - na_ontap_firmware_upgrade - fixed typo in example.
178 - na_ontap_user - fixed issue with idempotency while creating a user account in REST.
179 - na_ontap_volume - fixed indentation in example.
180 - na_ontap_ndmp - fix idempotency issue and added example for ndmp user generate password in REST.
181 - Corrected typo in email address from `[email protected]` to `[email protected]` across Ansible collection.
182
183 ### New Modules
184 - na_ontap_autoupdate_support - REST only support to enable automatic software update, requires ONTAP 9.10 or later.
185
186 ## 23.0.0
187
188 ### Bug Fixes
189 - na_ontap_snapmirror - fix delete snapmirror timeout issue by retrying in REST.
190 - na_ontap_quotas - changed examples in documentation for `type`.
191 - na_ontap_ems_config - fix issue with supporting check mode when proxy_password is not set in REST.
192 - na_ontap_user_role - fix issue with modifying privileges in REST.
193 - na_ontap_software_update - updated documentation for `https`.
194
195 ### Minor Changes
196 - na_ontap_volume - updated documentation for `snapshot_auto_delete`.
197 - na_ontap_ndmp - Added get method to generate and retrieve ndmp user passowrd in REST.
198 - all modules - defaults to certificate based authentication if `username,password` and `cert_filepath/key_filepath` are set.
199 - updated ZAPI deprecation warnings in README & module utilities.
200
201 ### Major Changes
202 - `netapp-lib` library is now an optional requirement.
203 - na_ontap_nvme_namespace - added compatibility for ASA r2 systems.
204 - na_ontap_lun - added compatibility for ASA r2 systems.
205 - na_ontap_lun_map_reporting_nodes - added compatibility for ASA r2 systems.
206 - na_ontap_lun_map - added compatibility for ASA r2 systems.
207 - na_ontap_nvme_subsystem - added compatibility for ASA r2 systems.
208 - na_ontap_lun_copy - added check to prevent use on unsupported ASA r2 systems.
209
210 ### New Modules
211 - na_ontap_mav_approval_group - REST only support for managing multi-admin verification (MAV) approval group, requires ONTAP 9.11 or later.
212 - na_ontap_mav_config - REST only support for managing multi-admin verification (MAV) global setting, requires ONTAP 9.11 or later.
213 - na_ontap_mav_rule - REST only support for managing multi-admin verification (MAV) rule, requires ONTAP 9.11 or later.
214 - na_ontap_support_config_backup - REST only support for retrieving and modifying configuration backup, requires ONTAP 9.6 or later.
215 - na_ontap_storage_unit - Supported with ASA r2 systems for managing storage unit operations, requires ONTAP 9.16.1 or later.
216 - na_ontap_storage_unit_snapshot - Supported with ASA r2 systems for managing storage unit snapshots, requires ONTAP 9.16.1 or later.
217
218 ## 22.14.0
219
220 ### Minor Changes
221 - na_ontap_svm - updated documentation for `allowed_protocols` & `services`.
222 - na_ontap_volume - new option `large_size_enabled` added in REST, requires ONTAP 9.12 or later.
223 - na_ontap_dns - updated documentation for `vserver`.
224 - multiple modules - standardized hostname, username, and password parameters to use `netapp_hostname`, `netapp_username`, and `netapp_password` as values.
225 - multiple modules - updated examples to use Fully Qualified Collection Name.
226 - na_ontap_rest_cli - added POST and DELETE examples.
227 - updated dead link in doc_fragments.
228 - na_ontap_flexcache - new options `relative_size`, `override_encryption`, `atime_scrub`, `cifs_change_notify_enabled`, `global_file_locking_enabled`, `guarantee_type`, `dr_cache` added in REST.
229 - na_ontap_snapmirror - new option `quiesced_time_out` added to wait for quiesce job to complete.
230
231 ### Bug Fixes
232 - Resolved Ansible lint issues.
233 - na_ontap_aggregate - fix issue with modifying `raid_type` in REST.
234 - na_ontap_kerberos_interface - updated example in module documentation.
235 - na_ontap_qtree - fix timeout issue with qtree delete in REST.
236
237 ## 22.13.0
238
239 ### Minor Changes
240 - na_ontap_svm - added `allowed` option for `s3` service, requires ONTAP 9.7 or later.
241 - na_ontap_rest_info - removed example which has option `gather_subset` set to `all` from documentation.
242 - na_ontap_cifs_server - added new option `comment` for cifs server, requires ONTAP 9.6 or later.
243 - all modules supporting only REST - change in documentation for `use_rest`, updated `extends_documentation_fragment`.
244 - na_ontap_s3_services - new option `is_http_enabled`, `is_https_enabled`, `port` and `secure_port` added in REST, requires ONTAP 9.8 or later.
245 - na_ontap_flexcache - new option to enable `writeback` added in REST, requires ONTAP 9.12 or later.
246 - na_ontap_s3_users - new option `regenerate_keys` and `delete_keys` added in REST, `delete_keys` requires ONTAP 9.14 or later.
247 - na_ontap_active_directory - return error message when attempting to modify `account_name`.
248 - na_ontap_s3_buckets - new option `versioning_state` added, requires ONTAP 9.11.1 or later.
249 - na_ontap_volume - new option `granular_data` added in REST, requires ONTAP 9.12 or later.
250 - na_ontap_volume - new option `nas_application_template.cifs_share_name` added in REST, requires ONTAP 9.11 or later.
251 - na_ontap_volume - new option `nas_application_template.snaplock.*` added in REST, requires ONTAP 9.12 or later.
252 - na_ontap_volume - new option `nas_application_template.snapshot_locking_enabled` added in REST, requires ONTAP 9.13.1 or later.
253
254 ### Bug Fixes
255 - na_ontap_snapshot_policy - fix issue with `retention_period` in REST.
256 - all modules supporting REST - avoid duplicate calls to api/cluster to get ONTAP version.
257 - na_ontap_rest_info - rectified subset name to `cluster/firmware/history`.
258 - na_ontap_broadcast_domain - fix issue with port modification in REST.
259 - na_ontap_flexcache - fix typo error in the query 'origins.cluster.name' in REST.
260
261 ### New Modules
262 - na_ontap_bgp_config - REST only support for managing BGP configuration for a node, requires ONTAP 9.6 or later.
263 - na_ontap_cifs_privileges - REST only support for managing privileges of the local or Active Directory user or group, requires ONTAP 9.10.1 or later.
264
265 ## 22.12.0
266
267 ### Minor Changes
268 - na_ontap_bgp_peer_group - added new option `use_peer_as_next_hop`, requires ONTAP 9.9 or later.
269 - na_ontap_volume - new option `snapshot_locking` added in REST, requires ONTAP 9.12 or later.
270 - na_ontap_volume - new option `activity_tracking` added in REST, requires ONTAP 9.10 or later.
271 - na_ontap_snapshot_policy - new option `retention_period` added in REST, requires ONTAP 9.12 or later.
272 - na_ontap_security_key_manager - added warning message in REST when passphrase is not changed.
273 - Requires Ansible 2.15 or higher.
274 - na_ontap_cifs - added REST support for option `vscan_fileop_profile`, requires ONTAP 9.15.1 or later.
275 - all modules supporting ZAPI & REST - throw authentication error instead of falling back to ZAPI when username/password is incorrect.
276 - na_ontap_rest_cli - return command output for GET and OPTIONS verbs during check mode.
277
278 ### Bug Fixes
279 - na_ontap_export_policy_rule - fix issue with idempotency in REST.
280 - na_ontap_volume_efficiency - fix issue with modifying volume efficiency in REST.
281 - na_ontap_volume - added error message while trying to modify efficiency configuration for a volume in REST, when efficiency is disabled.
282 - na_ontap_quotas - fix error with `quota_target` while trying to set default user quota rule in REST.
283 - na_ontap_rest_info - fixed issue with capturing error.
284 - na_ontap_flexcache - add warning for flexcache relationship deletion in ZAPI.
285 - na_ontap_user_role - fix issue with setting multiple permissions with REST.
286 - na_ontap_qtree - add warning for job still running for deletion operation in REST, when wait_for_completion is not set.
287 - na_ontap_snapshot_policy - fix issue with idempotency when `snapmirror_label` is set to empty in REST.
288 - na_ontap_file_security_permissions - set `apply_to` as optional and default value as true.
289
290 ## 22.11.0
291
292 ### Minor Changes
293 - na_ontap_vserver_audit - new options `schedule.*` added under `log.rotation`, requires ONTAP 9.6 or later.
294 - na_ontap_cifs - new option `offline_files` added in REST, requires ONTAP 9.10 or later.
295 - na_ontap_net_ifgrp - updated documentation for parameter `name`.
296 - na_ontap_security_config - added warning for missing `supported_cipher_suites` to maintain idempotency in REST.
297
298 ### Bug Fixes
299 - na_ontap_fpolicy_policy - fixed issue with idempotency in REST.
300 - na_ontap_dns - fix issue with modifying DNS servers in REST.
301 - na_ontap_quotas - fixed issue with idempotency in REST.
302
303 ## 22.10.0
304
305 ### Minor Changes
306 - na_ontap_rest_info - added warning message if given subset doesn't support option `owning_resource`.
307 - na_ontap_export_policy_rule - added `actions` and `modify` in module output.
308 - na_ontap_file_security_permissions_acl - added `actions` and `modify` in module output.
309 - na_ontap_igroup_initiator - added `actions` in module output.
310 - na_ontap_name_mappings - added `actions` and `modify` in module output.
311 - na_ontap_node - added `modify` in module output.
312 - na_ontap_lun_map - added `actions` in module output.
313 - na_ontap_lun_map_reporting_nodes - added `actions` in module output.
314 - na_ontap_storage_auto_giveback - added information on modifed attributes in module output.
315 - na_ontap_vscan_scanner_pool - added REST support to Vscan Scanner Pools Configuration module, requires ONTAP 9.6 or later.
316 - na_ontap_cifs_server - new option `is_multichannel_enabled` added in REST, requires ONTAP 9.10 or later.
317 - na_ontap_vserver_audit - new options `schedule.*` added under `log.rotation`.
318
319 ### Bug Fixes
320 - na_ontap_igroup_initiator - fixed issue with idempotency.
321
322 ## 22.9.0
323
324 ### New Options
325 - na_ontap_cifs_server - new option `lm_compatibility_level` added in REST, requires ONTAP 9.8 or later.
326 - na_ontap_cluster - new option `certificate.uuid` added in REST, requires ONTAP 9.10 or later.
327 - na_ontap_ems_destination - new options `syslog`, `port`, `transport`, `message_format`, `timestamp_format_override` and `hostname_format_override` added in REST, requires ONTAP 9.12.1 or later.
328
329 ### Minor Changes
330 - na_ontap_s3_services - create, modify S3 service returns `s3_service_info` in module output.
331 - na_ontap_nfs - fix error with `windows` in REST for ONTAP 9.10 or earlier.
332 - na_ontap_cluster_peer - added REST only support for modifying remote intercluster addresses in cluster peer relation.
333 - na_ontap_snapmirror - updated resync and resume operation for synchronous snapmirror relationship in REST.
334
335 ### Bug Fixes
336 - na_ontap_snapshot_policy - fix issue with modifying snapshot policy in REST.
337 - na_ontap_volume - modified `type` to be case insensitive in REST.
338 - na_ontap_security_certificates - fix error with ontap_info returned in module output in REST.
339
340 ### New Modules
341 - na_ontap_snmp_config - REST only support for modifying SNMP configuration, requires ONTAP 9.7 or later.
342 - na_ontap_cli_timeout - REST only support for setting CLI inactivity timeout value, requires ONTAP 9.6 or later.
343 - na_ontap_cifs_unix_symlink_mapping - REST only support for managing UNIX symbolic link mapping for CIFS clients, requires ONTAP 9.6 or later.
344
345 ## 22.8.3
346
347 ### Bug Fixes
348 - na_ontap_vserver_peer - fix issue with peering multiple clusters with same vserver name in REST.
349 - na_ontap_ems_destination - fix field error with `certificate.name` for ONTAP 9.11.1 or later in REST.
350 - na_ontap_snmp - fix for getting error when `authentication_method` set to default with ZAPI.
351
352 ## 22.8.1
353
354 ### Bug Fixes
355 - na_ontap_dns - fix keyerror for uuid when DNS is set to vserver in REST.
356 - na_ontap_volume - fix invalid field error with 'space.snapshot.autodelete' in REST.
357
358 ## 22.8.0
359
360 ### New Options
361 - na_ontap_lun - new option `qtree_name` added in REST.
362 - na_ontap_rest_info - new option `hal_linking` added.
363 - na_ontap_cifs_server - new option `default_site` added in REST, requires ONTAP 9.13.1 or later.
364 - na_ontap_ems_destination - new option `certificate`, `ca` added.
365 - na_ontap_volume - added new REST only options `vol_nearly_full_threshold_percent` and `vol_full_threshold_percent`, requires ONTAP 9.9 or later.
366 - na_ontap_qos_policy_group - added new REST only options `expected_iops_allocation` and `peak_iops_allocation`, requires ONTAP 9.10.1 or later.
367
368 ### Minor Changes
369 - na_ontap_user - added warning message when password is not changed.
370 - na_ontap_restit - returns changed as False for GET method.
371 - na_ontap_kerberos_realm - added REST support for `admin_server_ip`, `admin_server_port`, `pw_server_ip`, `pw_server_port` and `clock_skew`, requires ONTAP 9.13.1 or later.
372 - na_ontap_volume - added REST support for `atime_update` requires ONTAP 9.8 or later, `snapdir_access` and `snapshot_auto_delete` requires ONTAP 9.13.1 or later.
373 - na_ontap_net_ifgrp - return `name` and other details of a newly created interface group in module output in REST.
374 - na_ontap_cg_snapshot - added REST support to the cg snapshot module, requires ONTAP 9.10.1 or later.
375 - na_ontap_snmp - added REST support for `snmpv3` user.
376
377 ### Bug Fixes
378 - na_ontap_nfs - fix `default_user` under `windows` not getting modified, if not set previously, in REST.
379 - na_ontap_dns - fix DNS not working with Cluster mode.
380 - na_ontap_ems_filter - fix modify operation to add rule in existing filter.
381 - na_ontap_svm - fix REST version warning for `ndmp` under `services`.
382 - na_ontap_login_messages - fix idempotency issue in Cluster scope in REST.
383
384 ### New Modules
385 - na_ontap_ems_config - REST only support for modifying EMS configuration, requires ONTAP 9.6 or later.
386
387 ## 22.7.0
388
389 ### New Options
390 - na_ontap_s3_buckets - new option `nas_path` added, requires ONTAP 9.12.1 or later.
391
392 ### Minor Changes
393 - na_ontap_name_mappings - added choices `s3_win` and `s3_unix` to `direction`, requires ONTAP 9.12.1 or later.
394
395 ### Bug Fixes
396 - na_ontap_login_messages - fix `banner` and `motd_message` not idempotent when trailing '\n' is present.
397 - na_ontap_login_messages - fix idempotent issue on `show_cluster_motd` option when try to set banner or motd_message for the first time in REST.
398
399 ### New Modules
400 - na_ontap_active_directory_domain_controllers - Added REST support for ONTAP 9.12.0 or later and cli support for lower versions.
401
402 ## 22.6.0
403
404 ### New Options
405 - na_ontap_aggregate - new REST only option `tags` added, requires ONTAP 9.13.1 or later version.
406 - na_ontap_qos_policy_group - new REST only option `adaptive_qos_options.block_size` added, requires ONTAP 9.10.1 or later version.
407 - na_ontap_s3_buckets - new option `type` added, requires ONTAP 9.12.1 or later.
408 - na_ontap_volume - new REST only option `tags` added, requires ONTAP 9.13.1 or later version.
409
410 ### Minor Changes
411 - retry create or modify when getting temporarily locked from changes error in REST.
412 - na_ontap_export_policy - added `name` to modify in module output if export policy is renamed.
413 - na_ontap_broadcast_domain - skip checking modify when `state` is absent.
414 - na_ontap_qos_policy_group - skip checking modify when `state` is absent.
415
416 ### Bug Fixes
417 - na_ontap_export_policy - fix cannot delete export policy if `from_name` option is set.
418 - na_ontap_file_security_permissions_acl - fix idempotent issue on `propagation_mode` option.
419 - na_ontap_qos_policy_group - one occurrence of msg missing in call to fail_json.
420 - na_ontap_s3_groups - fix error when current s3 groups has no users configured.
421 - na_ontap_s3_groups - fix cannot modify `policies` if not configured in create.
422 - na_ontap_security_certificates - fix duplicate entry error when `vserver` option is set with admin vserver.
423 - na_ontap_snapmirror_policy - fix cannot disable `is_network_compression_enabled` in REST.
424 - na_ontap_svm - skip modify validation when trying to delete svm.
425 - na_ontap_qos_adaptive_policy_group - rename group when from_name is present and state is present.
426
427 ### New Modules
428 - na_ontap_kerberos_interface - Enable or disable Kerberos interface config, requires ONTAP 9.7 or later version.
429
430 ## 22.5.0
431
432 ### New Options
433 - na_ontap_cifs - new options `browsable` and `show_previous_versions` added in REST.
434
435 ### Minor Changes
436 - na_ontap_cifs - removed default value for `unix_symlink` as its not supported with ZAPI.
437 - na_ontap_cifs - updated documentation and examples for REST.
438 - na_ontap_file_security_permissions - updated module examples.
439 - na_ontap_ipspace - improved module fail error message in REST.
440 - na_ontap_rest_info - improved documentation for `parameters` option.
441 - na_ontap_security_config - updated documentation for `supported_cipher_suites`.
442 - na_ontap_user: option ``vserver`` is not required with REST, ignore this option to create cluster scoped user.
443
444 ### Bug Fixes
445 - na_ontap_cifs - throw error if set `unix_symlink` in ZAPI.
446 - na_ontap_cifs - throw error if used options that require recent ONTAP version.
447 - na_ontap_file_security_permissions - error if more than one desired ACLs has same user, access, access_control and apply_to.
448 - na_ontap_file_security_permissions - fix idempotency issue on `acls.propagation_mode` option.
449 - na_ontap_file_security_permissions - fix TypeError when current acls is None.
450 - na_ontap_ipspace - fix cannot delete ipspace if `from_ipspace` is present.
451 - na_ontap_iscsi_security - error module if use_rest never is set.
452 - na_ontap_iscsi_security - fix KeyError on `outbound_username` option.
453 - na_ontap_qtree - ignore job entry doesn't exist error when creating qtree with REST to bypass ONTAP issue with FSx.
454 - na_ontap_quotas - ignore job entry doesn't exist error when creating quota with REST to bypass ONTAP issue with FSx.
455 - na_ontap_security_config - fix error on specifying protocol version `TLSv1.1` when fips is enabled.
456 - na_ontap_snapmirror - error if identity_preservation set in ZAPI.
457 - na_ontap_snapmirror - Added option `identity_preservation` support from ONTAP 9.11.1 in REST.
458
459 ## 22.4.1
460
461 ### Bug Fixes
462 - na_ontap_snapmirror - fix invalid value error for return_timeout, modified the value to 120 seconds.
463
464 ## 22.4.0
465
466 ### New Options
467 - na_ontap_security_config - new option `supported_cipher_suites` added in REST.
468 - na_ontap_snapmirror - new option `identity_preservation` added in REST.
469
470 ### Minor Changes
471 - na_ontap_user_role - add support for rest-role `privileges.access` choices `read_create`, `read_modify` and `read_create_modify`, supported only with REST and requires ONTAP 9.11.1 or later versions.
472 - na_ontap_user_role - `command_directory_name` requires 9.11.1 or later with REST.
473 - na_ontap_rest_cli - returns changed only for verbs POST, PATCH and DELETE.
474 - na_ontap_snapmirror - wait 600 seconds for snapmirror creation to complete in REST.
475 - na_ontap_security_config - Replaced private cli with REST API for GET and PATCH.
476 - na_ontap_security_config - Added support for protocol version `TLSV1.3`.
477
478 ### Bug Fixes
479 - na_ontap_interface - fix incorrect warning raised when try to rename interface.
480 - na_ontap_ldap_client - fix duplicate entry error when used cluster vserver in REST.
481 - na_ontap_ldap_client - fix KeyError on `name` in ZAPI.
482 - na_ontap_san_create - Role documentation correct to from nas to san.
483 - na_ontap_user - fix KeyError vserver in ZAPI.
484 - na_ontap_user_role - report error when command/command directory path set in REST for ONTAP earlier versions.
485 - na_ontap_volume - fix error when try to unmount volume and modify snaplock attribute.
486 - na_ontap_volume - fix idempotent issue when try to offline and modify other volume options.
487 - na_ontap_vserver_audit - fix invalid field value error of log retention count and duration.
488 - na_ontap_vserver_audit - Added `log_path` option in modify.
489
490 ### New Modules
491 - na_ontap_ems_filter - Create, delete, or modify EMS filters.
492
493 ## 22.3.0
494
495 ### New Options
496 - na_ontap_aggregate - new option `allow_flexgroups` added.
497 - na_ontap_cifs - new options `access_based_enumeration`, `change_notify`, `encryption`,`home_directory`, `oplocks`, `show_snapshot`, `allow_unencrypted_access`, `namespace_caching` and `continuously_available` added in REST.
498 - na_ontap_nfs - new options `root`, `windows` and `security` added in REST.
499 - na_ontap_volume_efficiency - new option `volume_name` added.
500
501 ### Minor Changes
502 - na_ontap_dns - `skip_validation` option requires 9.9.1 or later with REST and ignored for cluster DNS operations.
503 - na_ontap_dns - support cluster scope for modify and delete.
504 - na_ontap_interface - do not attempt to migrate FC interface if desired `home_port`, `home_node` and `current_port`, `current_node` are same.
505 - na_ontap_license - support for NLF v2 license files.
506 - na_ontap_user_role - `path` is required if `privileges` set in REST.
507 - na_ontap_user_role - `command_directory_name` is required if `privileges` not set in REST.
508 - na_ontap_volume_efficiency - updated private cli with REST API.
509 - na_ontap_volume_efficiency - REST support for `policy` requires 9.7 or later, `path` requires 9.9.1 or later and `volume_efficiency` and `start_ve_scan_old_data` requires 9.11.1 or later.
510 - na_ontap_volume_efficiency - `schedule`, `start_ve_scan_all`, `start_ve_build_metadata`, `start_ve_delete_checkpoint`, `start_ve_queue_operation`, `start_ve_qos_policy` and `stop_ve_all_operations` options are not supported with REST.
511
512 ### Bug Fixes
513 - na_ontap_aggregate - try to offline aggregate when disk add operation is in progress in ZAPI.
514 - na_ontap_interface - fix idempotency issue when `home_port` not set in creating FC interface.
515 - na_ontap_rest_info - fix field issue with private/cli and support/autosupport/check APIs.
516 - na_ontap_snapshot - fix cannot modify `snapmirror_label`, `expiry_time` and `comment` if not configured in create.
517 - na_ontap_user_role - fix AttributeError 'NetAppOntapUserRole' object has no attribute 'name'.
518 - na_ontap_user_role - fix duplicate entry error in ZAPI.
519 - na_ontap_user_role - fix entry does not exist error when trying to delete privilege in REST.
520 - na_ontap_user_role - fix KeyError on `vserver`, `command_directory_name` in ZAPI and `path`, `query` in REST.
521 - na_ontap_volume_efficiency - fix idempotent issue when state is absent and efficiency options are set in ZAPI.
522
523 ### New Modules
524 - na_ontap_vserver_audit - added REST only support for create, modify and delete vserver audit configuration.
525 - na_ontap_vserver_peer_permissions - added REST only support for create, modify and delete vserver peer permissions for an SVM.
526
527 ## 22.2.0
528
529 ### New Options
530 - na_ontap_interface - new option `fail_if_subnet_conflicts` - requires REST and ONTAP 9.11.1 or later.
531 - na_ontap_interface - option `subnet_name` is now supported with REST with ONTAP 9.11.1 or later.
532 - na_ontap_snapmirror - support `schedule` with REST and ONTAP 9.11.1, add alias `transfer_schedule`.
533 - na_ontap_snapmirror_policy - new option `copy_latest_source_snapshot`, `create_snapshot_on_source` and `sync_type` added in REST.
534 - na_ontap_snapmirror_policy - new option `transfer_schedule` for async policy types.
535 - na_ontap_snapmirror_policy - Added new choices sync and async for policy type in REST.
536 - na_ontap_iscsi - new option `target_alias` added in REST.
537
538 ### Minor Changes
539 - na_ontap_active_directory - add `fqdn` as aliases for `domain`.
540 - na_ontap_snapmirror_policy - warn when replacing policy type `async_mirror`, `mirror_vault` and `vault` with policy type `async` and `strict_sync_mirror`, `sync_mirror` with `sync` in REST.
541 - na_ontap_snapmirror_policy - add unsupported options in ZAPI.
542 - na_ontap_snapmirror_policy - add support for cluster scoped policy with REST.
543 - na_ontap_svm - warn in case of mismatch in language option spelling.
544
545 ### Bug Fixes
546 - na_ontap_quotas - fix duplicate entry error when trying to add quota rule in REST.
547 - na_ontap_quotas - fix entry does not exist error when trying to modify quota status in REST.
548 - na_ontap_security_ipsec_policy - fix cannot get current security IPsec policy with ipspace.
549 - na_ontap_security_ipsec_policy - fix KeyError on `authentication_method`.
550 - na_ontap_security_key_manager - requires 9.7+ to work with REST.
551 - na_ontap_snapmirror_policy - fixed idempotency issue on `identity_preservation` option when using REST.
552 - na_ontap_snapmirror_policy - fix desired policy type not configured in cli with REST.
553 - na_ontap_snapmirror_policy - deleting all retention rules would trigger an error when the existing policy requires at least one rule.
554 - na_ontap_snapmirror_policy - index error on rules with ONTAP 9.12.1 as not all fields are present.
555 - na_ontap_volume - fixed bug preventing unmount and taking a volume off line at the same time
556
557 ### Added REST support to existing modules
558 - na_ontap_active_directory - REST requires ONTAP 9.12.1 or later.
559
560 ### New Modules
561 - na_ontap_cifs_local_user - ability to create/modify/delete a cifs local user
562
563
564 ## 22.1.0
565
566 ### New Options
567 - na_ontap_interface - new option `probe_port` for Azure load balancer.
568 - na_ontap_snapmirror_policy - new option `copy_all_source_snapshots` added in REST.
569
570 ### Minor Changes
571 - na_ontap_aggregate - add support for `service_state` option from ONTAP 9.11.1 or later in REST.
572 - na_ontap_aggregate - add `name` to modify in module output if aggregate is renamed.
573 - na_ontap_cifs_local_group_member - Added REST API support to retrieve, add and remove CIFS group member.
574 - na_ontap_cifs_local_group_member - REST support is from ONTAP 9.10.1 or later.
575 - na_ontap_cifs_server - skip `service_state` option in create if not set.
576 - na_ontap_quotas - for qtree type, allow quota_target in path format /vol/vol_name/qtree_name in REST.
577 - na_ontap_volume - report error if vserver does not exist or is not a data vserver on create.
578
579 ### Bug Fixes
580 - na_ontap_active_directory - updated doc as only ZAPI is supported at present, force an error with use_rest always.
581 - na_ontap_aggregate - fix examples in documentation.
582 - na_ontap_aggregate - allow adding disks before trying to offline aggregate.
583 - na_ontap_aggregate - error if `unmount_volumes` set in REST, by default REST unmount volumes when trying to offline aggregate.
584 - na_ontap_aggregate - fix `service_state` option skipped if its set to offline in create.
585 - na_ontap_cg_snapshot - updated doc with deprecation warning as it is a ZAPI only module.
586 - na_ontap_cifs_server - fix `service_state` is stopped when trying to modify cifs server in REST.
587 - na_ontap_file_directory_policy - updated doc with deprecation warning as it is a ZAPI only module.
588 - na_ontap_file_security_permissions - updated notes to indicate ONTAP 9.9.1 or later is required.
589 - na_ontap_file_security_permissions_acl - updated notes to indicate ONTAP 9.9.1 or later is required.
590 - na_ontap_interface - fix cannot set `location.home_node.name` and `location.node.name` error when trying to create or modify fc interface.
591 - na_ontap_interface - fix unexpected argument error with `ipspace` when trying to get fc interface.
592 - na_ontap_interface - fix error when trying to migrate fc interface in REST.
593 - na_ontap_qtree - fix cannot get current qtree if enclosed in curly braces.
594 - na_ontap_quota_policy - updated doc with deprecation warning as it is a ZAPI only module.
595 - na_ontap_quotas - fix default tree quota rule gets modified when `quota_target` is set in REST.
596 - na_ontap_quotas - fix user/group quota rule without qtree gets modified when `qtree` is set.
597 - na_ontap_svm_options - updated doc with deprecation warning as it is a ZAPI only module.
598
599 ### New Modules
600 - na_ontap_cifs_local_group - added REST only support for create, modify, rename and delete CIFS local group of an SVM.
601 - na_ontap_security_ipsec_ca_certificate - add or delete IPsec CA certificate.
602 - na_ontap_security_ipsec_config - Manage IPsec configuration.
603 - na_ontap_security_ipsec_policy - Create, modify and delete security IPsec policy.
604
605 ## 22.0.1
606
607 ### Bug Fixes
608 - na_ontap_interface - fix `netmask` not idempotent in REST.
609 - na_ontap_mcc_mediator - Fix error that would prevent mediator deletion.
610
611 ### Minor Changes
612 - na_ontap_interface - allow setting `netmask` with netmask length in ZAPI.
613
614 ## 22.0.0
615
616 ### Major Changes
617 - With this release all modules except for the modules called up above now support REST.
618 - ZAPI calls will continue to work, but will return a warning that they are deprecated and users should migrate to REST.
619
620 ### New Rest Info
621 - na_ontap_rest_info - support added for protocols/active-directory.
622 - na_ontap_rest_info - support added for protocols/cifs/group-policies.
623 - na_ontap_rest_info - support added for protocols/nfs/connected-client-settings.
624 - na_ontap_rest_info - support added for security/aws-kms.
625
626 ### Minor Changes
627 - na_ontap_debug - report python executable version and path.
628 - na_ontap_net_routes - `metric` option is supported from ONTAP 9.11.0 or later in REST.
629 - na_ontap_service_policy - update services for 9.11.1 - make it easier to add new services.
630 - na_ontap_snapmirror - `schedule` is handled through `policy` for REST.
631 - na_ontap_snapmirror_policy - improve error reporting and report errors in check_mode.
632 - na_ontap_volume - `wait_for_completion` and `check_interval` is now supported for volume move and encryption in REST.
633
634 ### New Options
635 - na_ontap_export_policy_rule - `allow_suid`, `allow_device_creation` and `chown_mode` is now supported from ONTAP 9.9.1 or later in REST.
636 - na_ontap_export_policy_rule - `allow_device_creation` and `chown_mode` is now supported in ZAPI.
637 - na_ontap_ldap_client - new option `skip_config_validation`.
638 - na_ontap_service_policy - new options `known_services` and `additional_services`.
639 - na_ontap_snapmirror_policy - new option `identity_preservation` added.
640 - na_ontap_snapmirror_policy - `name` added as an alias for `policy_name`.
641 - na_ontap_volume - new option `max_wait_time` added.
642 - na_ontap_volume - new REST option `analytics` added.
643 - tracing - allow to selectively trace headers and authentication.
644
645 ### Bug Fixes
646 - iso8601 filters - fix documentation generation issue.
647 - na_ontap_info - Added vserver in key_fields of net_interface_info.
648 - na_ontap_interface - fix error where an `address` with an IPV6 ip would try to modify each time playbook was run.
649 - na_ontap_ldap_client - `servers` not accepted when using ZAPI and `ldap_servers` not handling a single server properly.
650 - na_ontap_rest_info - fixed error where module would fail silently when using `owning_resouce` and a non-existent vserver.
651 - na_ontap_user_role - fixed Invalid JSON input. Expecting "privileges" to be an array.
652 - na_ontap_volume - fix error when trying to move encrypted volume and `encrypt` is True in REST.
653 - na_ontap_volume - fix error when trying to unencrypt volume in REST.
654 - na_ontap_volume - fix KeyError on `aggregate_name` when trying to unencrypt volume in ZAPI.
655 - na_ontap_volume - `snapdir_access` is not supported by REST and will currently inform you now if you try to use it with REST.
656 - na_ontap_volume - when deleting a volume, don't report a warning when unmount is successful (error is None).
657 - ZAPI only modules -- no longer have `use_rest` as an option.
658 - tracing - redact headers and authentication secrets by default.
659
660 ### New Modules
661 - na_ontap_local_hosts - added REST only support for create, update and delete IP to hostname mappings for SVM of the cluster.
662 - na_ontap_bgp_peer_group - Create, modify and delete BGP peer groups.
663 - na_ontap_file_security_permissions - Update SD and ACLs.
664 - na_ontap_file_security_permissions_acl - Add, update, or delete a single ACL.
665 - na_ontap_name_mappings - added REST only support for create, update and delete name mappings configuration.
666
667 ## 21.24.1
668
669 ### Bug Fixes
670 - new meta/execution-environment.yml is failing ansible-builder sanitize step.
671
672 ## 21.24.0
673
674 ### New Options
675 - na_ontap_cluster - `timezone.name` to modify cluster timezone. REST only.
676 - na_ontap_restit - `files` and `accept_header` to support multipart/form-data for write and read.
677 - na_ontap_snmp_traphosts - Added `host` option in REST.
678 - na_ontap_svm - Added `ndmp` option to services in REST.
679
680 ### Minor Changes
681 - na_ontap_ems_destination - improve error messages - augment UT coverage (thanks to bielawb).
682 - na_ontap_interface - `dns_domain_name` is now supported from ONTAP 9.9.0 or later in REST.
683 - na_ontap_interface - `is_dns_update_enabled` is now supported from ONTAP 9.9.1 or later in REST.
684 - na_ontap_interface - attempt to set interface_type to `ip` when `protocols` is set to "none".
685 - na_ontap_vserver_create - `protocol` is now optional. `role` is not set when protocol is absent.
686 - na_ontap_vserver_create - `firewall_policy` is not set when `service_policy` is present, as `service_policy` is preferred.
687 - na_ontap_vserver_create - added `interface_type`. Only a value of `ip` is currently supported.
688 - na_ontap_vserver_create - added support for vserver management interface when using REST.
689 - na_ontap_rest_info - Allowed the support of multiple subsets and warn when using `**` in fields.
690
691 ### New Rest Info
692 - All REST GET's up to and including 9.11.1 that do not require a UUID/KEY to be past in are now supported
693 - na_ontap_rest_info - support added for cluster.
694 - na_ontap_rest_info - support added for cluster/counter/tables.
695 - na_ontap_rest_info - support added for cluster/licensing/capacity-pools.
696 - na_ontap_rest_info - support added for cluster/licensing/license-managers.
697 - na_ontap_rest_info - support added for cluster/metrocluster/svms.
698 - na_ontap_rest_info - support added for cluster/sensors.
699 - na_ontap_rest_info - support added for name-services/cache/group-membership/settings.
700 - na_ontap_rest_info - support added for name-services/cache/host/settings.
701 - na_ontap_rest_info - support added for name-services/cache/netgroup/settings.
702 - na_ontap_rest_info - support added for name-services/cache/setting.
703 - na_ontap_rest_info - support added for name-services/cache/unix-group/settings.
704 - na_ontap_rest_info - support added for name-services/ldap-schemas.
705 - na_ontap_rest_info - support added for network/fc/fabrics.
706 - na_ontap_rest_info - support added for network/fc/interfaces.
707 - na_ontap_rest_info - support added for network/fc/interfaces.
708 - na_ontap_rest_info - support added for network/ip/subnets.
709 - na_ontap_rest_info - support added for protocols/cifs/connections.
710 - na_ontap_rest_info - support added for protocols/cifs/netbios.
711 - na_ontap_rest_info - support added for protocols/cifs/session/files.
712 - na_ontap_rest_info - support added for protocols/cifs/shadow-copies.
713 - na_ontap_rest_info - support added for protocols/cifs/shadowcopy-sets.
714 - na_ontap_rest_info - support added for protocols/nfs/connected-client-maps.
715 - na_ontap_rest_info - support added for security.
716 - na_ontap_rest_info - support added for security/multi-admin-verify.
717 - na_ontap_rest_info - support added for security/multi-admin-verify/approval-groups.
718 - na_ontap_rest_info - support added for security/multi-admin-verify/requests.
719 - na_ontap_rest_info - support added for security/multi-admin-verify/rules.
720 - na_ontap_rest_info - support added for storage/file/moves.
721 - na_ontap_rest_info - support added for storage/pools.
722
723 ### Bug Fixes
724 - na_ontap_cifs - fix KeyError on `unix_symlink` field when using REST.
725 - na_ontap_cifs_acl - use `type` when deleting unix-user or unix-group from ACL in ZAPI.
726 - na_ontap_command - do not run command in check_mode (thanks to darksoul42).
727 - na_ontap_ems_destination - fix idempotency issue when `type` value is rest_api.
728 - na_ontap_interface - improve error message when interface type is required with REST.
729 - na_ontap_qtree - fix KeyError on unix_permissions.
730 - na_ontap_rest_cli - do not run command in check_mode (thanks to darksoul42).
731 - na_ontap_s3_groups - if `policies` is None module should no longer fail
732 - na_ontap_user - fix idempotency issue with 9.11 because of new is_ldap_fastbind field.
733 - na_ontap_volume_efficiency -- Missing fields in REST get should return None and not crash module.
734
735 ### Added REST support to existing modules
736 - na_ontap_quotas - added REST support.
737 - na_ontap_net_subnet - added REST support.
738
739 ### New Module
740 - na_ontap_security_ssh - Updates the SSH server configuration for cluster and SVM scopes - REST only.
741
742 ### New Filters
743 - iso8601_duration_to_seconds - to convert a duration in ISO 8601 format to seconds.
744 - iso8601_duration_from_seconds - to convert seconds to a duration in ISO 8601 format.
745
746 ## 21.23.0
747
748 ### New Options
749 - all REST modules - new option `force_ontap_version` to bypass permission issues with custom vsadmin roles.
750 - na_ontap_export_policy_rule - new option `force_delete_on_first_match` to support duplicate entries on delete.
751 - na_ontap_rest_info - new option `ignore_api_errors` to report error in subset rather than breaking execution.
752 - na_ontap_security_key_manager - new REST options `external` and `vserver` for external key manager.
753 - na_ontap_security_key_manager - new REST option `onboard` for onboard key manager.
754
755 ### New Rest Info
756 - na_ontap_rest_info - support added for protocols/vscan/on-access-policies.
757 - na_ontap_rest_info - support added for protocols/vscan/on-demand-policies.
758 - na_ontap_rest_info - support added for protocols/vscan/scanner-pools.
759
760 ### Bug Fixes
761 - na_ontap_cifs_acl - use `type` if present when fetching existing ACL with ZAPI.
762 - na_ontap_cifs_local_user_set_password - when using ZAPI, do not require cluster admin privileges.
763 - na_ontap_cluster_config Role - incorrect license was show - updated to GNU General Public License v3.0
764 - na_ontap_flexcache - properly use `origin_cluster` in GET but not in POST when using REST.
765 - na_ontap_kerberos_realm - fix cannot modify `comment` option in ZAPI.
766 - na_ontap_lun_copy - fix key error on `source_vserver` option.
767 - na_ontap_s3_buckets - fix options that cannot be modified if not set in creating s3 buckets.
768 - na_ontap_s3_buckets - fix TypeError if `conditions` not present in policy statements.
769 - na_ontap_s3_buckets - updated correct choices in options `audit_event_selector.access` and `audit_event_selector.permission`.
770 - na_ontap_ntp - fixed typeError on `key_id` field with ZAPI.
771
772 ### Minor Changes
773 - na_ontap_export_policy_rule - `rule_index` is now optional for create and delete.
774 - na_ontap_interface - improved validations for unsupported options with FC interfaces.
775 - na_ontap_kerberos_realm - change `kdc_port` option type to int.
776 - na_ontap_ntp - for ONTAP version 9.6 or below fall back to ZAPI when `use_rest` is set to `auto` or fail when REST is desired.
777 - na_ontap_ntp_key - fail for ONTAP version 9.6 or below when `use_rest` is set to `auto` or when REST is desired.
778 - na_ontap_volume - attempt to delete volume even when unmounting or offlining failed.
779
780 ### Added REST support to existing modules
781 - na_ontap_cifs_local_user_set_password -- added REST support.
782 - na_ontap_cluster_ha - added REST support.
783 - na_ontap_lun_copy - added REST support.
784 - na_ontap_lun_map_reporting_nodes - added REST support.
785 - na_ontap_kerberos_realm - added REST support.
786 - na_ontap_security_key_manager - added REST support.
787 - na_ontap_ucadapter - added REST support.
788 - na_ontap_user_role -- added REST support.
789
790 ### New Module
791 - na_ontap_ems_destination - Manage EMS destination - Contribution by Bartosz Bielawski (@bielawb).
792
793 ## 21.22.0
794
795 ### New Options
796 - na_ontap_job_schedule - new option `cluster` added.
797 - na_ontap_ldap_client - Added `ldaps_enabled` option in ZAPI.
798
799 ### Bug Fixes
800 - na_ontap_cluster_peer - report an error if there is an attempt to use the already peered clusters.
801 - na_ontap_interface - fix error deleting fc interface if it is enabled in REST.
802 - na_ontap_license - fix intermittent KeyError when adding licenses with REST.
803 - na_ontap_lun - Added `lun_modify` after `app_modify` to fix idempotency issue.
804 - na_ontap_name_service_switch - fix AttributeError 'NoneType' object has no attribute 'get_children' if `sources` is '-' in current.
805 - na_ontap_name_service_switch - fix idempotency issue on `sources` option.
806 - na_ontap_security_key_manager - fix KeyError on `node`.
807 - na_ontap_ntp - fixed typeError on `key_id` field with ZAPI.
808 - na_ontap_service_processor_network - fix idempotency issue on `dhcp` option in ZAPI.
809 - na_ontap_service_processor_network - fail module when trying to disable `dhcp` and not setting one of `ip_address`, `netmask`, `gateway_ip_address` different than current.
810 - na_ontap_service_processor_network - allow manually configuring network if all of `ip_address`, `netmask`, `gateway_ip_address` set and `dhcp` not present in REST.
811 - na_ontap_service_processor_network - fix setting `dhcp` v4 takes more than `wait_for_completion` retries.
812 - na_ontap_service_processor_network - fix `wait_for_completion` ignored when trying to enable service processor network interface in ZAPI.
813 - na_ontap_software_update - improve error handling if image file is already present.
814 - na_ontap_software_update - improve error handling when node is rebooting with REST.
815 - na_ontap_software_update - when using REST with ONTAP 9.9 or later, timeout value is properly set.
816 - na_ontap_user - enforce that all methods are under a single application.
817 - na_ontap_user - is_locked was not properly read with ZAPI, making the module not idempotent.
818
819 ### Minor Changes
820 - na_ontap_license - return list of updated package names.
821 - na_ontap_nvme_subsystem - report subsystem as absent if vserver cannot be found when attempting a delete.
822 - na_ontap_rest_info - Will now warn you if a `gather_subset` is not supported by your version of ONTAP.
823 - na_ontap_rest_info - Will now include a message in return output about `gather_subset` not supported by your version of ONTAP.
824 - na_ontap_security_key_manager - indicate that `node` is not used and is deprecated.
825 - na_ontap_software_update - deleting a software package is now supported with ZAPI and REST.
826 - na_ontap_svm - added vserver as a convenient alias for name when using module_defaults.
827 - na_ontap_wait_for_condition - added `snapmirror_relationship` to wait on `state` or `transfer_state` (REST only).
828 - na_ontap_ldap - fall back to ZAPI when `use_rest` is set to `auto` or fail when REST is desired.
829 - all modules - do not fail on ZAPI EMS log when vserver does not exist.
830
831 ### Added REST support to existing modules
832 - na_ontap_ldap_client - added REST support.
833 - na_ontap_name_service_switch - added REST support.
834 - na_ontap_wait_for_condition - added REST support.
835
836 ## 21.21.0
837
838 ### New Options
839 - na_ontap_cluster_config role - support `broadcast_domain` and `service_policy` with REST.
840 - na_ontap_interface - support `broadcast_domain` with REST.
841 - na_ontap_lun - support `qos_adaptive_policy_group` with REST.
842 - na_ontap_ntp - added `key_id` for both REST and ZAPI
843 - na_ontap_qtree - added `unix_user` and `unix_group` options in REST.
844 - na_ontap_snapmirror - new option `validate_source_path` to disable this validation.
845 - na_ontap_unix_user - added new option `primary_gid` aliased to `group_id`.
846 - na_ontap_vserver_create role - support `broadcast_domain`, `ipspace`, and `service_policy` with REST.
847
848 ### Bug Fixes
849 - na_ontap_interface - enforce requirement for address/netmask for interfaces other than FC.
850 - na_ontap_interface - fix idempotency issue for cluster scoped interfaces when using REST.
851 - na_ontap_interface - fix potential node and uuid issues with LIF migration.
852 - na_ontap_interface - FC interfaces - scope is not supported.
853 - na_ontap_interface - FC interfaces - home_port is not supported for ONTAP 9.7 or earlier.
854 - na_ontap_interface - FC interfaces - home_node should not be sent as location.home_node.
855 - na_ontap_interface - FC interfaces - service_policy is not supported.
856 - na_ontap_interface - ignore 'none' when using REST rather than reporting unexpected protocol.
857 - na_ontap_lun - catch ZAPI error on get LUN.
858 - na_ontap_lun - ignore resize error if no change was required.
859 - na_ontap_lun - report error if flexvol_name is missing when using ZAPI.
860 - na_ontap_net_subnet - fix `ipspace` option ignored in getting net subnet.
861 - na_ontap_qtree - fix idempotency issue on `unix_permissions` option.
862 - na_ontap_s3_buckets - accept `sid` as a number or a string.
863 - na_ontap_s3_buckets - Module will set `enabled` during create.
864 - na_ontap_s3_buckets - Module will not fail on create if no `policy` is given.
865 - na_ontap_svm - KeyError on CIFS when using REST with ONTAP 9.8 or lower.
866 - na_ontap_volume - fix idempotency issue on `unix_permissions` option.
867 - na_ontap_volume - `volume_security_style` was not modified if other security options were present with ZAPI.
868 - na_ontap_vserver_create role - add rule index as it is now required.
869 - na_ontap_snapmirror - relax check for source when using REST.
870 - na_ontap_snapmirror - fix potential issue when destination is using REST but source is using ZAPI.
871
872 ### New Module
873 - na_ontap_ntp_key - Manage NTP keys.
874 - na_ontap_s3_groups - Manage s3 groups.
875 - na_ontap_s3_policies - Manage S3 policies.
876
877 ### Minor Changes
878 - na_ontap_info - add quota-policy-info.
879 - na_ontap_info - add computed serial_hex and naa_id for lun_info.
880 - na_ontap_login_messages - support cluster scope when using REST.
881 - na_ontap_motd - deprecated in favor of `na_ontap_login_messages`. Fail when use_rest is set to `always` as REST is not supported.
882 - na_ontap_rest_info - add computed serial_hex and naa_id for storage/luns when serial_number is present.
883 - na_ontap_s3_users - `secret_key` and `access_token` are now returned when creating a user.
884 - na_ontap_snapmirror - validate source endpoint for ZAPI and REST, accounting for vserver local name.
885 - na_ontap_snapmirror - improve errror messages to be more specific and consistent.
886 - na_ontap_snapmirror - wait for the relationship to come back to idle after a resync.
887 - na_ontap_user - accept `service_processor` as an alias for `service-processor` with ZAPI, to be consistent with REST.
888
889 ### Known Issues:
890 - na_ontap_snapshot - added documentation to use UTC format for `expiry_time`.
891
892 ### Added REST support to existing modules
893 - na_ontap_service_processor_network - Added REST support.
894 - na_ontap_unix_group - added REST support.
895 - na_ontap_unix_user - added REST support.
896 - na_ontap_volume - now defaults to REST with `use_rest: auto`, like every other module. ZAPI can be forced with `use_rest: never`.
897
898
899 ## 21.20.0
900
901 ### Bug Fixes
902 - na_ontap_autosupport - fix idempotency issue on `state` field with ONTAP 9.11.
903 - na_ontap_autosupport - TypeError on `support` and `ondemand_enabled` field with ONTAP 9.11.
904 - na_ontap_net_subnet - delete fails if ipspace is different than Default.
905 - na_ontap_portset - fixed idempotency issue when `ports` has identical values.
906 - na_ontap_portset - fixed error when trying to remove partial ports from portset if igroups are bound to it.
907 - na_ontap_quotas - fix another quota operation is currently in progress issue.
908 - na_ontap_quotas - fix idempotency issue on `threshold` option.
909 - na_ontap_snapmirror - support for SSL certificate authentication for both sides when using ONTAP.
910 - na_ontap_snapmirror - fix issue where there was no wait on quiesce before aborting.
911 - na_ontap_snapmirror - fix issue where there was no wait on the relationship to end transferring.
912 - na_ontap_snapmirror - fix error in snapmirror restore by changing option `clean_up_failure` as optional when using ZAPI.
913 - na_ontap_software_update - now reports changed=False when the package is already present.
914 - na_ontap_user - fix idempotency issue with SSH with second_authentication_method.
915 - na_ontap_vscan_on_access_policy - fixed options `filters`, `file_ext_to_exclude` and `paths_to_exclude` cannot be reset to empty values in ZAPI.
916 - na_ontap_zapit - fix failure in precluster mode.
917
918 ### New Options
919 - na_ontap_cifs_server - added `security` options in REST.
920 - na_ontap_export_policy_rule - added `from_index` for both REST and ZAPI. Change `rule_index` to required.
921 - na_ontap_snapmirror - new option `peer_options` to define source connection parameters.
922 - na_ontap_snapmirror - new option `transferring_time_out` to define how long to wait for transfer to complete on create or initialize.
923 - na_ontap_vscan_on_access_policy - new REST options `scan_readonly_volumes` and `only_execute_access` added.
924 - na_ontap_vserver_cifs_security - added option `encryption_required_for_dc_connections` and `use_ldaps_for_ad_ldap` in ZAPI.
925
926 ### New Modules
927 - na_ontap_s3_service - Manage S3 services.
928 - na_ontap_s3_users - Manage S3 users.
929
930 ### Minor Changes
931 - na_ontap_aggregate - updated `disk_types` in documentation.
932 - na_ontap_snapmirror - when deleting, attempt to delete even when the relationship cannot be broken.
933 - na_ontap_snapmirror - rewrite update for REST using POST to initiate transfer.
934 - na_ontap_svm - added documentation for `allowed_protocol`, ndmp is default in REST.
935 - na_ontap_user - add support for SAML authentication_method.
936 - na_ontap_vserver_cifs_security - added `use_ldaps_for_ad_ldap` and `use_start_tls_for_ad_ldap` as mutually exclusive in ZAPI.
937 - na_ontap_vserver_cifs_security - fall back to ZAPI when `use_rest` is set to `auto` or fail when REST is desired.
938
939 ### Added REST support to existing modules
940 - na_ontap_nvme_namespace - added REST support.
941 - na_ontap_nvme_subsystem - added REST support.
942 - na_ontap_portset - added REST support.
943 - na_ontap_software_update - added REST support.
944 - na_ontap_vscan_on_access_policy - added REST support.
945 - na_ontap_vscan_on_demand_task - added REST support.
946
947 ## 21.19.1
948
949 ### Bug Fixes
950 - na_ontap_cluster_config - fix the role to be able to create intercluster LIFs with REST (ipspace is required).
951 - na_ontap_interface - ignore `vserver` when using REST if role is one of 'cluster', 'node-mgmt', 'intercluster', 'cluster-mgmt'.
952 - na_ontap_nvme - fixed invalid boolean value error for `status_admin` when creating nvme service in ZAPI.
953 - na_ontap_nvme - fixed `status_admin` option is ignored if set to False when creating nvme service in REST.
954 - na_ontap_service_policy - fixed error in modify by changing resulting json of an existing record in REST.
955 - na_ontap_snapmirror - when using ZAPI, wait for the relationship to be quiesced before breaking.
956 - na_ontap_snapmirror - when using REST with a policy, fix AttributeError - 'str' object has no attribute 'get'.
957
958 ## 21.19.0
959
960 ### Minor Changes
961 - na_ontap_interface - use REST when `use_rest` is set to `auto`.
962 - na_ontap_qos_adaptive_policy_group - warn about deprecation, fall back to ZAPI or fail when REST is desired.
963 - na_ontap_quotas - support TB as a unit, update doc with size format description.
964
965 ### New Options
966 - na_ontap_cifs_server - Added new option `force` for create, delete and `from_name`, `force` for rename when using REST.
967 - na_ontap_qos_policy_group - Added REST only supported option `adaptive_qos_options` for configuring adaptive policy.
968 - na_ontap_qos_policy_group - Added REST only supported option `fixed_qos_options` for configuring max/min throughput policy.
969 - na_ontap_rest_info - new option `owning_resource` for REST info that requires an owning resource. For instance volume for a snapshot
970 - na_ontap_cifs - Added `unix_symlink` option in REST.
971
972 ### New Module
973 - na_ontap_s3_bucket - Manage S3 Buckets.
974
975 ### Bug Fixes
976 - na_ontap_cifs - fixed `symlink_properties` option silently ignored for cifs share creation when using REST.
977 - na_ontap_cifs - fixed error in modifying comment if it is not set while creating CIFS share in REST.
978 - na_ontap_command - fix typo in example.
979 - na_ontap_interface - rename fails with 'inconsistency in rename action' for cluster interface with REST.
980 - na_ontap_login_messages - fix typo in examples for username.
981 - na_ontap_nfs - fix TypeError on NoneType as `tcp_max_xfer_size` is not supported in earlier ONTAP versions.
982 - na_ontap_nfs - fix `Extra input` error with ZAPI for `is-nfsv4-enabled`.
983 - na_ontap_quotas - Fix idempotency issue on `disk_limit` and `soft_disk_limit`.
984 - na_ontap_rest_info: REST API's with hyphens in the name will now be converted to underscores when `use_python_keys` is set to `True` so that YAML parsing works correctly.
985 - na_ontap_service_policy - fix examples in documentation.
986 - na_ontap_volume - use `time_out` value when creating/modifying/deleting volumes with REST rathar than hardcoded value.
987 - na_ontap_volume - QOS policy was not set when using NAS application.
988 - na_ontap_volume - correctly warn when attempting to modify NAS application.
989 - na_ontap_volume - do not set encrypt on modify, as it is already handled with specialized ZAPI calls.
990 - na_ontap_volume_autosize - improve error reporting.
991
992 ### New Rest Info
993 - na_ontap_rest_info - support added for application/consistency-groups
994 - na_ontap_rest_info - support added for cluster/fireware/history
995 - na_ontap_rest_info - support added for cluster/mediators
996 - na_ontap_rest_info - support added for cluster/metrocluster/dr-groups
997 - na_ontap_rest_info - support added for cluster/metrocluster/interconnects
998 - na_ontap_rest_info - support added for cluster/metrocluster/operations
999 - na_ontap_rest_info - support added for cluster/ntp/keys
1000 - na_ontap_rest_info - support added for cluster/web
1001 - na_ontap_rest_info - support added for name-services/local-hosts
1002 - na_ontap_rest_info - support added for name-services/unix-groups
1003 - na_ontap_rest_info - support added for name-services/unix-users
1004 - na_ontap_rest_info - support added for network/ethernet/switch/ports
1005 - na_ontap_rest_info - support added for network/fc/ports
1006 - na_ontap_rest_info - support added for network/http-proxy
1007 - na_ontap_rest_info - support added for network/ip/bgp/peer-groups
1008 - na_ontap_rest_info - support added for protocols/audit
1009 - na_ontap_rest_info - support added for protocols/cifs/domains
1010 - na_ontap_rest_info - support added for protocols/cifs/local-groups
1011 - na_ontap_rest_info - support added for protocols/cifs/local-users
1012 - na_ontap_rest_info - support added for protocols/cifs/sessions
1013 - na_ontap_rest_info - support added for protocols/cifs/users-and-groups/privilege
1014 - na_ontap_rest_info - support added for protocols/cifs/unix-symlink-mapping
1015 - na_ontap_rest_info - support added for protocols/file-access-tracing/events
1016 - na_ontap_rest_info - support added for protocols/file-access-tracing/filters
1017 - na_ontap_rest_info - support added for protocols/fpolicy
1018 - na_ontap_rest_info - support added for protocols/locks
1019 - na_ontap_rest_info - support added for protocols/ndmp
1020 - na_ontap_rest_info - support added for protocols/ndmp/nodes
1021 - na_ontap_rest_info - support added for protocols/ndmp/sessions
1022 - na_ontap_rest_info - support added for protocols/ndmp/svms
1023 - na_ontap_rest_info - support added for protocols/nfs/connected-clients
1024 - na_ontap_rest_info - support added for protocols/nfs/export-policies/rules (Requires owning_resource to be set)
1025 - na_ontap_rest_info - support added for protocols/nfs/kerberos/interfaces
1026 - na_ontap_rest_info - support added for protocols/nvme/subsystem-controllers
1027 - na_ontap_rest_info - support added for protocols/nvme/subsystem-maps
1028 - na_ontap_rest_info - support added for protocols/s3/buckets
1029 - na_ontap_rest_info - support added for protocols/s3/services
1030 - na_ontap_rest_info - support added for protocols/san/iscsi/sessions
1031 - na_ontap_rest_info - support added for protocols/san/portsets
1032 - na_ontap_rest_info - support added for protocols/san/vvol-bindings
1033 - na_ontap_rest_info - support added for security/anti-ransomware/suspects
1034 - na_ontap_rest_info - support added for security/audit
1035 - na_ontap_rest_info - support added for security/audit/messages
1036 - na_ontap_rest_info - support added for security/authentication/cluster/ad-proxy
1037 - na_ontap_rest_info - support added for security/authentication/cluster/ldap
1038 - na_ontap_rest_info - support added for security/authentication/cluster/nis
1039 - na_ontap_rest_info - support added for security/authentication/cluster/saml-sp
1040 - na_ontap_rest_info - support added for security/authentication/publickeys
1041 - na_ontap_rest_info - support added for security/azure-key-vaults
1042 - na_ontap_rest_info - support added for security/certificates
1043 - na_ontap_rest_info - support added for security/gcp-kms
1044 - na_ontap_rest_info - support added for security/ipsec
1045 - na_ontap_rest_info - support added for security/ipsec/ca-certificates
1046 - na_ontap_rest_info - support added for security/ipsec/policies
1047 - na_ontap_rest_info - support added for security/ipsec/security-associations
1048 - na_ontap_rest_info - support added for security/key-manager-configs
1049 - na_ontap_rest_info - support added for security/key-managers
1050 - na_ontap_rest_info - support added for security/key-stores
1051 - na_ontap_rest_info - support added for security/login/messages
1052 - na_ontap_rest_info - support added for security/ssh
1053 - na_ontap_rest_info - support added for security/ssh/svms
1054 - na_ontap_rest_info - support added for storage/cluster
1055 - na_ontap_rest_info - support added for storage/file/clone/split-loads
1056 - na_ontap_rest_info - support added for storage/file/clone/split-status
1057 - na_ontap_rest_info - support added for storage/file/clone/tokens
1058 - na_ontap_rest_info - support added for storage/monitored-files
1059 - na_ontap_rest_info - support added for storage/qos/workloads
1060 - na_ontap_rest_info - support added for storage/snaplock/audit-logs
1061 - na_ontap_rest_info - support added for storage/snaplock/compliance-clocks
1062 - na_ontap_rest_info - support added for storage/snaplock/event-retention/operations
1063 - na_ontap_rest_info - support added for storage/snaplock/event-retention/policies
1064 - na_ontap_rest_info - support added for storage/snaplock/file-fingerprints
1065 - na_ontap_rest_info - support added for storage/snaplock/litigations
1066 - na_ontap_rest_info - support added for storage/switches
1067 - na_ontap_rest_info - support added for storage/tape-devices
1068 - na_ontap_rest_info - support added for storage/volumes/snapshots (Requires owning_resource to be set)
1069 - na_ontap_rest_info - support added for support/auto-update
1070 - na_ontap_rest_info - support added for support/auto-update/configurations
1071 - na_ontap_rest_info - support added for support/auto-update/updates
1072 - na_ontap_rest_info - support added for support/configuration-backup
1073 - na_ontap_rest_info - support added for support/configuration-backup/backups
1074 - na_ontap_rest_info - support added for support/coredump/coredumps
1075 - na_ontap_rest_info - support added for support/ems/messages
1076 - na_ontap_rest_info - support added for support/snmp
1077 - na_ontap_rest_info - support added for support/snmp/users
1078 - na_ontap_rest_info - support added for svm/migrations
1079
1080 ### Added REST support to existing modules
1081 - na_ontap_igroup_initiator - Added REST support.
1082 - na_ontap_iscsi - Added REST support.
1083 - na_ontap_nvme - Added REST support.
1084 - na_ontap_qos_policy_group - Added REST support.
1085
1086
1087 ## 21.18.1
1088
1089 ### Bug Fixes
1090 - na_ontap_iscsi - fixed error starting iscsi service on vserver where Service, adapter, or operation already started.
1091 - na_ontap_lun - Fixed KeyError on options `force_resize`, `force_remove` and `force_remove_fenced` in ZAPI.
1092 - na_ontap_lun - Fixed `force_remove` option silently ignored in REST.
1093 - na_ontap_snapshot_policy - Don't validate parameter when state is `absent` and fix KeyError on `comment`.
1094
1095 ## 21.18.0
1096
1097 ### New Options
1098 - na_ontap_export_policy_rule - new option `ntfs_unix_security` for NTFS export UNIX security options added.
1099 - na_ontap_volume - add support for SnapLock - only for REST.
1100 - na_ontap_volume - new option `max_files` to increase the inode count value.
1101
1102 ### Minor Changes
1103 - na_ontap_cluster_config role - use na_ontap_login_messages as na_ontap_motd is deprecated.
1104 - na_ontap_debug - report ansible version and ONTAP collection version.
1105 - na_ontap_snapmirror -- Added more descriptive error messages for REST
1106 - na_ontap_svm - add support for web services (ssl modify) - REST only with 9.8 or later.
1107 - na_ontap_volume - allow to modify volume after rename.
1108 - na_ontap_vserver_create role - support max_volumes option.
1109
1110 ### Bug Fixes
1111 - na_ontap_aggregate - Fixed error in delete aggregate if the `disk_count` is less than current disk count.
1112 - na_ontap_autosupport - Fixed `partner_address` not working in REST.
1113 - na_ontap_command - document that a READONLY user is not supported, even for show commands.
1114 - na_ontap_disk_options - ONTAP 9.10.1 returns on/off rather than True/False.
1115 - na_ontap_info - [#54] Fixes issue with na_ontap_info failing in 9.1 because of `job-schedule-cluster`.
1116 - na_ontap_iscsi - Fixed issue with `start_state` always being set to stopped when creating an ISCSI.
1117 - na_ontap_qtree - Fixed issue with `oplocks` not being changed during a modify in ZAPI.
1118 - na_ontap_qtree - Fixed issue with `oplocks` not warning user about not being supported in REST.
1119 - na_ontap_snapshot - fix key error on volume when using REST.
1120 - na_ontap_snapshot - add error message if volume is not found with REST.
1121 - na_ontap_svm - fixed KeyError issue on protocols when vserver is stopped.
1122 - na_ontap_volume - fix idempotency issue with compression settings when using REST.
1123 - na_ontap_volume - do not attempt to mount volume if current state is offline.
1124 - na_ontap_vserver_peer - Fixed AttributeError if `dest_hostname` or `peer_options` not present.
1125 - na_ontap_vserver_peer - Fixed `local_name_for_peer` and `local_name_for_source` options silently ignored in REST.
1126 - na_ontap_vserver_peer - Added cluster peer accept code in REST.
1127 - na_ontap_vserver_peer - Get peer cluster name if remote peer exist else use local cluster name.
1128 - na_ontap_vserver_peer - ignore job entry doesn't exist error with REST to bypass ONTAP issue with FSx.
1129 - na_ontap_vserver_peer - report error if SVM peer does not see a peering relationship after create.
1130 - Fixed ONTAP minor version ignored in checking minimum ONTAP version.
1131
1132 ### Added REST support to existing modules
1133 - na_ontap_efficiency_policy - Added REST support.
1134 - na_ontap_lun - Added Rest Support.
1135 - na_ontap_snapshot_policy - Added Rest Support.
1136
1137 ## 21.17.3
1138
1139 ### Bug Fixes
1140 - na_ontap_lun_map - TypeError - '>' not supported between instances of 'int' and 'str '.
1141 - na_ontap_snapmirror - Fixed bug by adding use_rest condition for the REST support to work when `use_rest: always`.
1142
1143 ## 21.17.2
1144
1145 ### Bug Fixes
1146 - na_ontap_rest_info - Fixed an issue with adding field to specific info that didn't have a direct REST equivalent.
1147 - na_ontap_lun_map - Fixed bug when deleting lun map using REST.
1148
1149 ## 21.17.1
1150
1151 ### Bug Fixes
1152 - na_ontap_lun_map - fixed bugs resulting in REST support to not work.
1153
1154 ## 21.17.0
1155
1156 ### New Options
1157 - na_ontap_cifs_acl - new option `type` for user-group-type.
1158
1159 ### Minor changes
1160 - all modules that only support ZAPI - warn when `use_rest: always` is ignored.
1161
1162 ### Bug Fixes
1163 - na_ontap_aggregate - Fixed UUID issue when attempting to attach object store as part of creating the aggregate with REST.
1164 - na_ontap_cifs_server - error out if ZAPI only options `force` or `workgroup` are used with REST.
1165 - na_ontap_cluster_peer - Fixed KeyError if both `source_intercluster_lifs` and `dest_intercluster_lifs` are not present in creating cluster.
1166 - na_ontap_rest_info - Fixed example with wrong indentation for `use_python_keys`.
1167
1168 ### Added REST support to existing modules
1169 - na_ontap_cifs - Added REST support to the CIFS share module.
1170 - na_ontap_cifs_acl - Added REST support to the cifs share access control module.
1171 - na_ontap_cluster_peer - Added REST support.
1172 - na_ontap_lun_map - Added REST support.
1173 - na_ontap_nfs - Added Rest Support.
1174 - na_ontap_volume_clone - Added REST support.
1175
1176 ## 21.16.0
1177
1178 ### New Options
1179 - na_ontap_aggregate - Added `disk_class` option for REST and ZAPI.
1180 - na_ontap_aggregate - Extended accepted `disk_type` values for ZAPI.
1181 - na_ontap_volume - `logical_space_enforcement` to specifies whether to perform logical space accounting on the volume.
1182 - na_ontap_volume - `logical_space_reporting` to specifies whether to report space logically on the volume.
1183 - na_ontap_volume - `tiering_minimum_cooling_days` to specify how many days must pass before inactive data in a volume using the Auto or Snapshot-Only policy is considered cold and eligible for tiering.
1184
1185 ### Bug Fixes
1186 - na_ontap_active_directory - Fixed idempotency and traceback issues.
1187 - na_ontap_aggregate - Fixed KeyError on unmount_volumes when offlining a volume if option is not set.
1188 - na_ontap_aggregate - Report an error when attempting to change snaplock_type.
1189 - na_ontap_igroup - `force_remove_initiator` option was ignored when removing initiators from existing igroup.
1190 - na_ontap_info - Add active_directory_account_info.
1191 - na_ontap_security_certificates - `intermediate_certificates` option was ignored.
1192 - na_ontap_user - Fixed lock state is not set if password is not changed.
1193 - na_ontap_user - Fixed TypeError 'tuple' object does not support item assignment.
1194 - na_ontap_user - Fixed issue when attempting to change pasword for absent user when set_password is set.
1195 - na_ontap_volume - Report error when attempting to change the nas_application tiering control from disalllowed to required, or reciprocally.
1196 - na_ontap_volume - Fixed error with unmounting junction_path in rest.
1197 - na_ontap_volume - Fixed error when creating a flexGroup when `aggregate_name` and `aggr_list_multiplier` are not set in rest.
1198 - four modules (mediator, metrocluster, security_certificates, wwpn_alias) would report a None error when REST is not available.
1199 - module_utils - fixed KeyError on Allow when using OPTIONS method and the API failed.
1200
1201 ### Added REST support to existing modules
1202 - na_ontap_aggregate - Added REST support.
1203 - na_ontap_cifs_server - Added REST support to the cifs server module.
1204 - na_ontap_ports - Added REST support to the ports module.
1205 - na_ontap_volume_clone -- Added REST support.
1206
1207 ## 21.15.1
1208
1209 ### Bug Fixes
1210 - na_ontap_export_policy_rule - Fixed bug that prevent ZAPI and REST calls from working correctly.
1211
1212 ## 21.15.0
1213
1214 ### New Options
1215 - na_ontap_broadcast_domain - new REST only option `from_ipspace` added.
1216 - na_ontap_svm - new REST options of svm admin_state `stopped` and `running` added.
1217
1218 ### Bug Fixes
1219 - na_ontap_info - Fixed KeyError on node for aggr_efficiency_info option against a metrocluster system.
1220 - na_ontap_volume - Fixed issue that would fail the module in REST when changing `is_online` if two vserver volume had the same name.
1221 - na_ontap_volume_efficiency - Removed restriction on policy name.
1222 - na_ontap_broadcast_domain - fix idempotency issue when `ports` has identical values.
1223
1224 ### Minor Changes
1225 - na_ontap_broadcast_domain_ports - warn about deprecation, fall back to ZAPI or fail when REST is desired.
1226 - na_ontap_rest_info - update documention for `fields` to clarify the list of fields that are return by default.
1227 - na_ontap_volume - If using REST and ONTAP 9.6 and `efficiency_policy` module will fail as `efficiency_policy` is not supported in ONTAP 9.6.
1228
1229 ### Added REST support to existing modules
1230 - na_ontap_broadcast_domain - Added REST support to the broadcast domain module.
1231 - na_ontap_export_policy_rule -- Added Rest support for Export Policy Rules.
1232 - na_ontap_firmware_upgrade - REST support to download firmware and reboot SP.
1233 - na_ontap_license - Added REST support to the license module.
1234 - na_ontap_snapmirror - Added REST support to the na_ontap_snapmirror module.
1235
1236 ## 21.14.1
1237
1238 ### Bug Fixes
1239 - na_ontap_net_ifgrp - fix error in modify ports with zapi.
1240
1241 ## 21.14.0
1242
1243 ### New Options
1244 - na_ontap_aggregate - new option `encryption` to enable encryption with ZAPI.
1245 - na_ontap_net_ifgrp - new REST only options `from_lag_ports`, `broadcast_domain` and `ipspace` added.
1246 - na_ontap_restit - new option `wait_for_completion` to support asynchronous operations and wait for job completion.
1247 - na_ontap_volume_efficiency - new option `storage_efficiency_mode` for AFF only with 9.10.1 or later.
1248
1249 ### Bug Fixes
1250 - na_ontap_cifs_local_user_modify - unexpected argument `name` error with REST.
1251 - na_ontap_cifs_local_user_modify - KeyError on `description` or `full_name` with REST.
1252 - na_ontap_export_policy - fix error if more than 1 verser matched search name, the wrong uuid could be given.
1253 - na_ontap_interface - fix error where module will fail for ONTAP 9.6 if use_rest: was set to auto.
1254 - na_ontap_net_routes - metric was not always modified with ZAPI.
1255 - na_ontap_net_routes - support cluster-scoped routes with REST.
1256 - na_ontap_vserver_delete role - report error if ONTAP version is 9.6 or older.
1257
1258 ### Minor Changes
1259 - na_ontap_vserver_delete role - added set_fact to accept `netapp_{hostname|username|password}` or `hostname`, `username` and `password` variables.
1260 - na_ontap_vserver_delete role - do not report an error if the vserver does not exist.
1261
1262 ### Added REST support to existing modules
1263 - na_ontap_fcp -- Added REST support for FCP.
1264 - na_ontap_net_ifgrp - Added REST support to the net ifgrp module.
1265 - na_ontap_net_port - Added REST support to the net port module.
1266 - na_ontap_volume - Added REST support to the volume module.
1267 - na_ontap_vserver_peer - Added REST support to the vserver_peer module.
1268
1269 ## 21.13.1
1270
1271 ### Bug Fixes
1272 - cluster scoped modules are failing on FSx with 'Vserver API missing vserver parameter' error.
1273
1274 ## 21.13.0
1275
1276 ### Minor Changes
1277 - na_ontap_object_store: support modifying an object store config with REST.
1278 - PR15 - allow usage of Ansible module group defaults - for Ansible 2.12+.
1279
1280 ### New Options
1281 - na_ontap_cluster - add `force` option when deleting a node.
1282 - na_ontap_object_store: new REST options `owner` and `change_password`.
1283 - na_ontap_net_vlan - new options `broadcast_domain`, `ipspace` and `enabled` when using REST.
1284
1285 ### Bug Fixes
1286 - na_ontap_cluster - `single_node_cluster` was silently ignored with REST.
1287 - na_ontap_cluster - switch to ZAPI when DELETE is required with ONTAP 9.6.
1288 - na_ontap_snapshot - `expiry_time` required REST api, will return error if set when using ZAPI.
1289 - na_ontap_snapshot - `snapmirror_label` is supported with REST on ONTAP 9.7 or higher, report error if used on ONTAP 9.6.
1290 - na_ontap_snapmirror - `source_path` and `source_hostname` parameters are not mandatory to delete snapmirror relationship when source cluster is unknown, if specified it will delete snapmirror at destination and release the same at source side. if not, it only deletes the snapmirror at destination and will not look for source to perform snapmirror release.
1291 - na_ontap_snapmirror - modify policy, schedule and other parameter failure are fixed.
1292 - na_ontap_svm - module will on init if a rest only and zapi only option are used at the same time.
1293 - na_ontap_storage_failover - KeyError on 'ha' if the system is not configured as HA.
1294
1295 ### Added REST support to existing modules
1296 - na_ontap_interface - Added REST support to the interface module (for IP and FC interfaces).
1297 - na_ontap_net_vlan - Added REST support to the net vlan module.
1298
1299 ## 21.12.0
1300
1301 ### Minor Changes
1302 - na_ontap_firewall_policy - added `none` as a choice for `service` which is supported from 9.8 ONTAP onwards.
1303
1304 ### New Options
1305 - na_ontap_svm - new option `max_volumes`.
1306
1307 ### Bug Fixes
1308 - na_ontap_job_schedule - fix idempotency issue with ZAPI when job_minutes is set to -1.
1309 - na_ontap_job_schedule - cannot modify options not present in create when using REST.
1310 - na_ontap_job_schedule - modify error if month is present but not changed with 0 offset when using REST.
1311 - na_ontap_job_schedule - modify error if month is changed from some values to all (-1) when using REST.
1312 - na_ontap_svm - support `allowed protocols` with REST for ONTAP 9.6 and later.
1313 - na_ontap_vserver_delete role - fix typos for cifs.
1314
1315 ### Added REST support to existing modules
1316 - na_ontap_cluster - Added REST support to the cluster module.
1317
1318 ## 21.11.0
1319
1320 ### New Options
1321 - na_ontap_interface - new option `from_name` to rename an interface.
1322 - na_ontap_software_update - new option `validate_after_download` to run ONTAP software update validation checks.
1323 - na_ontap_svm - new option `services` to allow and/or enable protocol services when using REST.
1324 - na_ontap_svm - new option `ignore_rest_unsupported_options` to ignore older ZAPI options not available in REST.
1325
1326 ### Minor Changes
1327 - na_ontap_software_update - remove `absent` as a choice for `state` as it has no use.
1328 - na_ontap_svm - ignore `aggr_list: '*'` when using REST.
1329
1330 ### Bug Fixes
1331 - na_ontap_job_schedule - fix idempotency issue with REST when job_minutes is set to -1.
1332 - na_ontap_ldap_client - remove limitation on schema so that custom schemas can be used.
1333
1334 ### Added REST support to existing modules
1335 - na_ontap_ntp - Added REST support to the ntp module.
1336
1337 ## 21.10.0
1338
1339 ### Minor Changes
1340 - na_ontap_cifs_server - `force` option is supported when state is absent to ignore communication errors.
1341
1342 ### Bug Fixes
1343 - na_ontap_vserver_delete role - delete iSCSI igroups and CIFS server before deleting vserver.
1344 - all modules - traceback on ONTAP 9.3 (and earlier) when trying to detect REST support.
1345
1346
1347 ## 21.9.0
1348
1349 ### Minor Changes
1350 - na_ontap_rest_info - The Default for `gather_subset` has been changed to demo which returns `cluster/software`, `svm/svms`, `cluster/nodes`. To return all Info must specifically list `all` in your playbook. Do note `all` is a very resource-intensive action and it is highly recommended to call just the info/APIs you need.
1351 - na_ontap_rest_info - added file_directory_security to return the effective permissions of the directory. When using file_directory_security it must be called with gather_subsets and path and vserver must be specified in parameters.
1352
1353 ### New Options
1354 - na_ontap_job_schedule - new option `month_offset` to explictly select 0 or 1 for January.
1355 - na_ontap_object_store - new options `port`, `certificate_validation_enabled`, `ssl_enabled` for target server.
1356 - na_ontap_rest_info - new option `use_python_keys` to replace `svm/svms` with `svm_svms` to simplify post processing.
1357
1358 ### Added REST support to existing modules
1359 - na_ontap_snmp - Added REST support to the SNMP module
1360 - na_ontap_rest_info - All Info that exist in `na_ontap_info` that has REST equivalents have been implemented. Note that the returned structure for REST and the variable names in the structure is different from the ZAPI based `na_ontap_info`. Some default variables in ZAPI are no longer returned by default in REST and will need to be specified using the `field` option
1361 - na_ontap_rest_info - The following info's have been added `system_node_info`, `net_interface_info`, `net_port_info`, `security_login_account_info`, `vserver_peer_info`, `cluster_image_info`, `cluster_log_forwarding_info`, `metrocluster_info`, `metrocluster_node_info`, `net_dns_info`, `net_interface_service_policy_info`, `vserver_nfs_info`, `clock_info`, `igroup_info`, `vscan_status_info`, `vscan_connection_status_all_info`, `storage_bridge_info`, `nvme_info`, `nvme_interface_info`, `nvme_subsystem_info`, `cluster_switch_info`, `export_policy_info`, `kerberos_realm_info`,`sis_info`, `sis_policy_info`, `snapmirror_info`, `snapmirror_destination_info`, `snapmirror_policy_info`, `sys_cluster_alerts`, `cifs_vserver_security_info`
1362
1363 ### Bug Fixes
1364 - na_ontap_job_schedule - fix documentation for REST ranges for months.
1365 - na_ontap_quotas - attempt a retry on `13001:success` ZAPI error. Add debug data.
1366 - na_ontap_object_store - when using REST, wait for job status to correctly report errors.
1367 - na_ontap_rest_cli - removed incorrect statement indicating that console access is required.
1368
1369 ## 21.8.1
1370
1371 ### Bug Fixes
1372 - all REST modules: 9.4 and 9.5 were incorrectly detected as supporting REST.
1373 - na_ontap_snapmirror: improve error message when option is not supported with ZAPI.
1374
1375 ## 21.8.0
1376
1377 ### New Modules
1378 - na_ontap_cifs_local_user_set_password - set local user password - ZAPI only.
1379 - na_ontap_fdsd - add or remove File Directory Security Descriptor - REST only.
1380 - na_ontap_fdsp - create or delete a File Directory Security Policy - REST only.
1381 - na_ontap_fdspt - add, remove or modify a File Directory Security Policy Task - REST only.
1382 - na_ontap_fdss - apply security policy settings to files and directories in a vserver.
1383 - na_ontap_partitions - assign/unassign disk partitions - REST only.
1384
1385 ### New role
1386 - na_ontap_vserver_delete - delete vserver and all associated data and resources - REST only.
1387
1388 ### New Options
1389 - na_ontap_cluster_peer - new option `peer_options` to use different credentials on peer.
1390 - na_ontap_net_port - new option `up_admin` to set administrative state.
1391 - na_ontap_snapshot - new option `expiry_time`.
1392 - na_ontap_vserver_peer - new option `peer_options` to use different credentials on peer.
1393
1394 ### Added REST support to existing modules
1395 - na_ontap_snapshot - added REST support for snapshot creation, modification & deletion.
1396
1397 ### Bug Fixes
1398 - na_ontap_cluster_peer - KeyError on dest_cluster_name if destination is unreachable.
1399 - na_ontap_cluster_peer - KeyError on username when using certicate.
1400 - na_ontap_export_policy_rule - change `anonymous_user_id` type to str to accept user name and user id. (A warning is now triggered when a number is not quoted.)
1401 - na_ontap_vserver_peer - KeyError on username when using certicate.
1402 - na_ontap_volume_clone - `parent_vserver` can not be given with `junction_path`, `uid`, or `gid`
1403 - all modules - fix traceback TypeError 'NoneType' object is not subscriptable when hostname points to a web server.
1404
1405 ### Minor Changes
1406 - na_ontap_debug - additional checks when REST is available to help debug vserver connectivity issues.
1407 - na_ontap_net_port - change option types to bool and int respectively for `autonegotiate_admin` and `mtu`.
1408 - na_ontap_rest_info - add examples for `parameters` option.
1409 - na_ontap_volume - show warning when resize is ignored because threshold is not reached.
1410 [WARNING]: resize request ignored: 2.5% is below the threshold: 10%
1411 - na_ontap_vserver_create role - add `nfsv3`, `nfsv4`, `nfsv41` options.
1412 - na_ontap_flexcache - corrected module name in documentation Examples
1413
1414 ## 21.7.0
1415
1416 ### New Modules
1417 - na_ontap_publickey - add/remove/modify public keys for SSH authentication - REST only.
1418 - na_ontap_service_policy - add/remove/modify service policies for IP interfaces - REST only.
1419
1420 ### New Options
1421 - na_ontap_cifs - new option `comment` to associate a description to a CIFS share.
1422 - na_ontap_disks - new option `min_spares`.
1423 - na_ontap_lun - new suboption `exclude_aggregates` for SAN application.
1424 - na_ontap_volume - new suboption `exclude_aggregates` for NAS application.
1425
1426 ### Minor Changes
1427 - na_ontap_disks - added REST support for the module.
1428 - na_ontap_disks - added functionality to reassign spare disks from a partner node to the desired node.
1429 - na_ontap_igroups - nested igroups are not supported on ONTAP 9.9.0 but are on 9.9.1.
1430 - License displayed correctly in Github
1431
1432 ### Bug Fixes
1433 - na_ontap_iscsi_security - cannot change authentication_type
1434 - na_ontap_iscsi_security - IndexError list index out of range if vserver does not exist
1435
1436 ## 21.6.1
1437
1438 ### Bug Fixes
1439 - na_ontap_autosupport - KeyError: No element by given name validate-digital-certificate.
1440 - na_ontap_flexcache - one occurrence of msg missing in call to fail_json.
1441 - na_ontap_igroup - one occurrence of msg missing in call to fail_json.
1442 - na_ontap_lun - three occurrencse of msg missing in call to fail_json.
1443 - na_ontap_lun_map_reporting_nodes - one occurrence of msg missing in call to fail_json.
1444 - na_ontap_snapmirror - one occurrence of msg missing in call to fail_json.
1445
1446 ## 21.6.0
1447
1448 ### New Options
1449 - na_ontap_users - new option `application_dicts` to associate multiple authentication methods to an application.
1450 - na_ontap_users - new option `application_strs` to disambiguate `applications`.
1451 - na_ontap_users - new option `replace_existing_apps_and_methods`.
1452 - na_ontap_users - new suboption `second_authentication_method` with `application_dicts` option.
1453 - na_ontap_vserver_peer - new options `local_name_for_source` and `local_name_for_peer` added.
1454
1455 ### Minor changes
1456 - na_ontap_rest_info - Added "autosupport_check_info"/"support/autosupport/check" to the attributes that will be collected when gathering info using the module.
1457
1458 ### Bug Fixes
1459 - na_ontap_autosupport - TypeError - '>' not supported between instances of 'str' and 'list'.
1460 - na_ontap_quotas - fail to reinitialize on create if quota is already on.
1461
1462 ## 21.5.0
1463
1464 ### New Options
1465 - na_ontap_autosupport - new option 'nht_data_enabled' to specify whether the disk health data is collected as part of the AutoSupport data.
1466 - na_ontap_autosupport - new option 'perf_data_enabled' to specify whether the performance data is collected as part of the AutoSupport data.
1467 - na_ontap_autosupport - new option 'retry_count' to specify the maximum number of delivery attempts for an AutoSupport message.
1468 - na_ontap_autosupport - new option 'reminder_enabled' to specify whether AutoSupport reminders are enabled or disabled.
1469 - na_ontap_autosupport - new option 'max_http_size' to specify delivery size limit for the HTTP transport protocol (in bytes).
1470 - na_ontap_autosupport - new option 'max_smtp_size' to specify delivery size limit for the SMTP transport protocol (in bytes).
1471 - na_ontap_autosupport - new option 'private_data_removed' to specify the removal of customer-supplied data.
1472 - na_ontap_autosupport - new option 'local_collection_enabled' to specify whether collection of AutoSupport data when the AutoSupport daemon is disabled.
1473 - na_ontap_autosupport - new option 'ondemand_enabled' to specify whether the AutoSupport OnDemand Download feature is enabled.
1474 - na_ontap_autosupport - new option 'validate_digital_certificate' which when set to true each node will validate the digital certificates that it receives.
1475
1476 ### Added REST support to existing modules
1477 - na_ontap_autosupport - added REST support for ONTAP autosupport modification.
1478
1479 ### Bug Fixes
1480 - na_ontap_qtree - wait for completion when creating or modifying a qtree with REST.
1481 - na_ontap_volume - ignore read error because of insufficient privileges for efficiency options so that the module can be run as vsadmin.
1482
1483 ### Minor changes
1484 - na_ontap_info - Added "autosupport_check_info" to the attributes that will be collected when gathering info using the module.
1485
1486 ## 21.4.0
1487
1488 ### New Modules
1489 - na_ontap_cifs_local_user_modify: Modify a local CIFS user.
1490 - na_ontap_disk_options: Modify storage disk options.
1491 - na_ontap_fpolicy_event: Create, delete or modify an FPolicy policy event.
1492 - na_ontap_fpolicy_ext_engine: Create, modify or delete an fPolicy External Engine.
1493 - na_ontap_fpolicy_scope: Create, delete or modify an FPolicy policy scope.
1494 - na_ontap_fpolicy_status: Enable or disable an existing fPolicy policy.
1495 - na_ontap_snaplock_clock: Initialize snaplock compliance clock.
1496
1497 ### New Options
1498 - na_ontap_igroups - new option `initiator_objects` to support initiator comments (requires ONTAP 9.9).
1499 - na_ontap_igroups - new option `initiator_names` as a replacement for `initiators` (still supported as an alias).
1500
1501 ### Minor changes
1502 - na_ontap_lun - allow new LUNs to use different igroup or os_type when using SAN application.
1503 - na_ontap_lun - ignore small increase (lower than provisioned) and small decrease (< 10%) in `total_size`.
1504 - na_ontap_volume_efficiency - updated to now allow for storage efficiency start and storage efficiency stop.
1505
1506 ### Bug fixes
1507 - na_ontap_autosupport - warn when password is present in `proxy_url` as it makes the operation not idempotent.
1508 - na_ontap_cluster - ignore ZAPI EMS log error when in pre-cluster mode.
1509 - na_ontap_lun - SAN application is not supported on 9.6 and only partially supported on 9.7 (no modify).
1510 - na_ontap_svm - iscsi current status is not read correctly (mispelled issi).
1511 - na_ontap_volume - warn when attempting to modify application only options.
1512
1513 ## 21.3.1
1514
1515 ### Bug fixes
1516 - na_ontap_snapmirror: check for consistency_group_volumes always fails on 9.7, and cluster or ipspace when using endpoints with ZAPI.
1517
1518 ## 21.3.0
1519
1520 ### New Modules
1521 - na_ontap_domain_tunnel: Create, delete or modify the domain tunnel.
1522 - na_ontap_storage_failover: Enables and disables storage failover.
1523 - na_ontap_security_config: Modify the security configuration for SSL.
1524 - na_ontap_storage_auto_giveback: Enables and disables storage auto giveback.
1525 - na_ontap_fpolicy_policy: Create, delete or modify an fpolicy policy
1526
1527 ### New Options
1528 - na_ontap_flexcache - support for `prepopulate` option when using REST (requires ONTAP 9.8).
1529 - na_ontap_igroups - new option `igroups` to support nested igroups (requires ONTAP 9.9).
1530 - na_ontap_ldap_client - `tcp_port` replaces `port`.
1531 - na_ontap_volume - new suboption `dr_cache` when creating flexcache using NAS application template (requires ONTAP 9.9).
1532
1533 ### Minor changes
1534 - na_ontap_debug - improve error reporting for import errors on netapp_lib.
1535 - na_ontap_flexcache - mount/unmount the FlexCache volume when using REST.
1536 - na_ontap_info - improve error reporting for import errors on netapp_lib, json, xlmtodict.
1537
1538 ### Added REST support to existing modules
1539 - na_ontap_flexcache - added REST support for ONTAP FlexCache creation and deletion.
1540 - na_ontap_node - added REST support for Node modify and rename.
1541 - na_ontap_snapmirror - SVM scoped policies were not found when using a destination path with REST application.
1542
1543 ### Bug fixes
1544 - na_ontap_ldap_client - `port` was incorrectly used instead of `tcp_port`.
1545 - na_ontap_motd - added warning for deprecated and to use na_ontap_login_messages module.
1546 - na_ontap_node - KeyError fix for location and asset-tag.
1547 - na_ontap_volume - changes in `encrypt` settings were ignored.
1548 - na_ontap_volume - unmount volume before deleting it when using REST.
1549 - na_ontap_volume_efficiency - `policy` updated to allow for supported '-' as a valid entry.
1550 - na_ontap_volume_efficiency - to allow for FAS ONTAP systems to enable volume efficiency.
1551 - na_ontap_volume_efficiency - to allow for FAS ONTAP systems to enable volume efficiency and apply parameters in one execution.
1552
1553 ## 21.2.0
1554
1555 ### New Modules
1556 - na_ontap_cifs_local_group_member: Add or remove CIFS local group member
1557 - na_ontap_volume_efficiency: Enables, disables or modifies volume efficiency
1558 - na_ontap_log_forward: Create, delete or modify the log forward configuration
1559 - na_ontap_lun_map_reporting_nodes: Add and remove lun map reporting nodes
1560
1561 ### New Options
1562 - na_ontap_lun - new option `comment`.
1563 - na_ontap_lun - new option `qos_adaptive_policy_group`.
1564 - na_ontap_lun - new option `scope` to explicitly force operations on the SAN application or a single LUN.
1565 - na_ontap_node - added modify function for location and asset tag for node.
1566 - na_ontap_snapmirror - new options `source_endpoint` and `destination_endpoint` to group endpoint suboptions.
1567 - na_ontap_snapmirror - new suboptions `consistency_group_volumes` and `ipspace` to endpoint options.
1568
1569 ### Minor changes
1570 - na_ontap_lun - convert existing LUNs and supporting volume to a smart container within a SAN application.
1571 - na_ontap_snapmirror - improve error reporting or warn when REST option is not supported.
1572 - na_ontap_snapmirror - deprecate older options for source and destination paths, volumes, vservers, and clusters.
1573 - na_ontap_snapmirror - report warning when relationship is present but not healthy.
1574
1575 ### Bug fixes
1576 - na_ontap_igroup - report error when attempting to modify an option that cannot be changed.
1577 - na_ontap_lun - `qos_policy_group` could not be modified if a value was not provided at creation.
1578 - na_ontap_lun - `tiering` options were ignored in san_application_template.
1579 - na_ontap_volume - returns an error now if deleting a volume with REST api fails.
1580 - na_ontap_volume - report error from resize operation when using REST.
1581
1582 ### Added REST support to existing modules
1583 - na_ontap_igroup - added REST support for ONTAP igroup creation, modification, and deletion.
1584
1585 ## 21.1.1
1586
1587 ### Bug fixes
1588 - All REST modules: ONTAP 9.4 and 9.5 are incorrectly detected as supporting REST with `use_rest: auto`.
1589
1590 ## 21.1.0
1591
1592 ### New Modules
1593 - na_ontap_debug: Diagnose netapp-lib import errors and provide useful information.
1594
1595 ### New Options
1596 - na_ontap_cluster - `time_out` to wait for cluster creation, adding and removing a node.
1597 - na_ontap_debug - connection diagnostics added for invalid ipaddress and DNS hostname errors.
1598 - na_ontap_lun - `total_size` and `total_size_unit` when using SAN application template.
1599 - na_ontap_snapmirror - `create_destination` to automatically create destination endpoint (ONTAP 9.7).
1600 - na_ontap_snapmirror - `destination_cluster` to automatically create destination SVM for SVM DR (ONTAP 9.7).
1601 - na_ontap_snapmirror - `source_cluster` to automatically set SVM peering (ONTAP 9.7).
1602
1603 ### Minor changes
1604 - na_ontap_firmware_upgrade - Added a new 'storage' type as default firmware_type.
1605 - na_ontap_info - deprecate `state` option.
1606 - na_ontap_lun - support increasing lun_count and total_size when using SAN application template.
1607 - na_ontap_quota - allow to turn quota on/off without providing quota_target or type.
1608 - na_ontap_rest_info - deprecate `state` option.
1609 - na_ontap_snapmirror - use REST API for create action if target supports it. (ZAPIs are still used for all other actions).
1610 - na_ontap_volume - use REST API for delete operation if targets supports it.
1611 - general - improve error reporting when older version of netapp-lib is used.
1612
1613 ### Bug fixes
1614 - na_ontap_lun - REST expects 'all' for tiering policy and not 'backup'.
1615 - na_ontap_quotas - Handle blank string idempotency issue for `quota_target` in quotas module.
1616 - na_ontap_rest_info - `changed` was set to "False" rather than boolean False.
1617 - na_ontap_snapmirror - report error when attempting to change relationship_type.
1618 - na_ontap_snapmirror - fix job update failures for load_sharing mirrors.
1619 - na_ontap_snapmirror - wait up to 5 minutes for abort to complete before issuing a delete.
1620 - na_ontap_snmp - SNMP module wrong access_control issue and error handling fix.
1621 - na_ontap_volume - REST expects 'all' for tiering policy and not 'backup'.
1622 - na_ontap_volume - detect and report error when attempting to change FlexVol into FlexGroup.
1623 - na_ontap_volume - report error if `aggregate_name` option is used with a FlexGroup.
1624
1625 ## 20.12.0
1626
1627 ### New Options
1628 - na_ontap_igroup - new option `os_type` to replace `ostype` (but ostype is still accepted).
1629 - na_ontap_info - new fact: cifs_options_info.
1630 - na_ontap_info - new fact: cluster_log_forwarding_info.
1631 - na_ontap_info - new fact: event_notification_destination_info.
1632 - na_ontap_info - new fact: event_notification_info.
1633 - na_ontap_info - new fact: security_login_role_config_info.
1634 - na_ontap_info - new fact: security_login_role_info.
1635 - na_ontap_lun - new option `from_name` to rename a LUN.
1636 - na_ontap_lun - new option `os_type` to replace `ostype` (but ostype is still accepted), and removed default to `image`.
1637 - na_ontap_lun - new option `qos_policy_group` to assign a qos_policy_group to a LUN.
1638 - na_ontap_lun - new option `san_application_template` to create LUNs without explicitly creating a volume and using REST APIs.
1639 - na_ontap_qos_policy_group - new option `is_shared` for sharing QOS SLOs or not.
1640 - na_ontap_quota_policy - new option `auto_assign` to assign quota policy to vserver.
1641 - na_ontap_quotas - new option `activate_quota_on_change` to resize or reinitialize quotas.
1642 - na_ontap_quotas - new option `perform_user_mapping` to perform user mapping for the user specified in quota-target.
1643 - na_ontap_rest_info - Support for gather subsets: `cifs_home_directory_info, cluster_software_download, event_notification_info, event_notification_destination_info, security_login_info, security_login_rest_role_info`
1644 - na_ontap_svm - warning for `aggr_list` wildcard value(`*`) in create\modify idempotency.
1645 - na_ontap_volume - `compression` to enable compression on a FAS volume.
1646 - na_ontap_volume - `inline-compression` to enable inline compression on a volume.
1647 - na_ontap_volume - `nas_application_template` to create a volume using nas application REST API.
1648 - na_ontap_volume - `size_change_threshold` to ignore small changes in volume size.
1649 - na_ontap_volume - `sizing_method` to resize a FlexGroup using REST.
1650
1651 ### Bug fixes
1652 - na_ontap_broadcast_domain_ports - properly report check_mode `changed`.
1653 - na_ontap_cifs - fix for AttributeError - 'NoneType' object has no attribute 'get' on line 300
1654 - na_ontap_user - application parameter expects only `service_processor` but module supports `service-processor`.
1655 - na_ontap_volume - change in volume type was ignored and now reporting an error.
1656 - na_ontap_volume - checking for success before failure lead to 'NoneType' object has no attribute 'get_child_by_name' when modifying a Flexcache volume.
1657
1658 ## 20.11.0
1659
1660 ### New Modules
1661 - na_ontap_metrocluster_dr_group: Configure a Metrocluster DR group (Supports ONTAP 9.8+)
1662
1663 ### Minor changes
1664 - na_ontap_cifs - output `modified` if a modify action is taken.
1665 - na_ontap_cluster_peer: optional parameter 'ipspace' added for cluster peer.
1666 - na_ontap_info - do not require write access privileges. This also enables other modules to work in check_mode without write access permissions.
1667 - na_ontap_lun - support modify for space_allocation and space_reserve.
1668 - na_ontap_mcc_mediator - improve error reporting when REST is not available.
1669 - na_ontap_metrocluster - improve error reporting when REST is not available.
1670 - na_ontap_wwpn_alias - improve error reporting when REST is not available.
1671 - na_ontap_software_update - add `force_update` option to ignore current version.
1672 - na_ontap_svm - output `modified` if a modify action is taken.
1673 - all ZAPI modules - optimize Basic Authentication by adding Authorization header proactively.
1674 - This can be disabled by setting the `classic_basic_authorization` feature_flag to True.
1675
1676 ### Bug fixes
1677 - All REST modules, will not fail if a job fails
1678 - na_ontap_cifs - fix idempotency issue when `show-previous-versions` is used.
1679 - na_ontap_firmware_upgrade - fix ValueError issue when processing URL error.
1680 - na_ontap_info - Use `node-id` as key rather than `current-version`.
1681 - na_ontap_ipspace - invalid call in error reporting (double error).
1682 - na_ontap_lun - `use_exact_size` to create a lun with the exact given size so that the lun is not rounded up.
1683 - na_ontap_metrocluster: Fix issue where module would fail on waiting for rest api job
1684 - na_ontap_software_update - module is not idempotent.
1685
1686 ## 20.10.0
1687
1688 ### New Options
1689 - na_ontap_rest_info: Support for gather subsets - `application_info, application_template_info, autosupport_config_info , autosupport_messages_history, ontap_system_version, storage_flexcaches_info, storage_flexcaches_origin_info, storage_ports_info, storage_qos_policies, storage_qtrees_config, storage_quota_reports, storage_quota_policy_rules, storage_shelves_config, storage_snapshot_policies, support_ems_config, support_ems_events, support_ems_filters`
1690
1691 ### Bug fixes
1692 - na_ontap_aggregate: support concurrent actions for rename/modify/add_object_store and create/add_object_store.
1693 - na_ontap_cluster: `single_node_cluster` option was ignored.
1694 - na_ontap_info: better reporting on KeyError traceback, option to ignore error.
1695 - na_ontap_info: KeyError on `tree` for quota_report_info.
1696 - na_ontap_snapmirror_policy: report error when attempting to change `policy_type` rather than taking no action.
1697 - na_ontap_volume: `encrypt: false` is ignored when creating a volume.
1698
1699 ## 20.9.0
1700
1701 ### New Modules
1702 - na_ontap_active_directory: configure active directory.
1703 - na_ontap_mcc_mediator: Configure a MCC Mediator (Supports ONTAP 9.8+).
1704 - na_ontap_metrocluster: Configure a metrocluster (Supports ONTAP 9.8+).
1705
1706 ### New Options
1707 - na_ontap_cluster: `node_name` to set the node name when adding a node, or as an alternative to `cluster_ip_address` to remove a node.
1708 - na_ontap_cluster: `state` can be set to `absent` to remove a node identified with `cluster_ip_address` or `node_name`.
1709 - na_ontap_qtree: `wait_for_completion` and `time_out` to wait for qtree deletion when using REST.
1710 - na_ontap_quotas: `soft_disk_limit` and `soft_file_limit` for the quota target.
1711 - na_ontap_rest_info: Support for gather subsets - `initiator_groups_info, san_fcp_services, san_iscsi_credentials, san_iscsi_services, san_lun_maps, storage_luns_info, storage_NVMe_namespaces.`
1712
1713 ### Bug fixes
1714 - na_ontap_cluster: `check_mode` is now working properly.
1715 - na_ontap_interface: `home_node` is not required in pre-cluster mode.
1716 - na_ontap_interface: `role` is not required if `service_policy` is present and ONTAP version is 9.8.
1717 - na_ontap_interface: traceback in get_interface if node is not reachable.
1718 - na_ontap_job_schedule: allow 'job_minutes' to set number to -1 for job creation with REST too.
1719 - na_ontap_qtree: fixed `None is not subscriptable` exception on rename operation.
1720 - na_ontap_volume: fixed `KeyError` exception on `size` when reporting creation error.
1721 - na_ontap_*: change version_added: '2.6' to version_added: 2.6.0 where applicable to satisfy sanity checker.
1722 - netapp.py: uncaught exception (traceback) on zapi.NaApiError.
1723
1724 ## 20.8.0
1725
1726 ### New Modules
1727 - na_ontap_file_directory_policy: create, modify, delete vserver security file directory policy/task.
1728 - na_ontap_ssh_command: send CLI command over SSH using paramiko for corner cases where ZAPI or REST are not yet ready.
1729 - na_ontap_wait_for_condition: wait for event to be present or absent (currently sp_upgrade/in_progress and sp_version).
1730
1731 ### New Options
1732 - na_ontap_aggregate: support `disk_size_with_unit` option.
1733 - na_ontap_ldap_client: support `ad_domain` and `preferred_ad_server` options.
1734 - na_ontap_rest_info: Support for gather subsets - `cloud_targets_info, cluster_chassis_info, cluster_jobs_info, cluster_metrics_info, cluster_schedules, broadcast_domains_info, cluster_software_history, cluster_software_packages, network_ports_info, ip_interfaces_info, ip_routes_info, ip_service_policies, network_ipspaces_info, san_fc_logins_info, san_fc_wppn-aliases, svm_dns_config_info, svm_ldap_config_info, svm_name_mapping_config_info, svm_nis_config_info, svm_peers_info, svm_peer-permissions_info`.
1735 - na_ontap_rest_info: Support for gather subsets for 9.8+ - `cluster_metrocluster_diagnostics.
1736 - na_ontap_qtree: `force_delete` option with a DEFAULT of `true` so that ZAPI behavior is aligned with REST.
1737 - na_ontap_security_certificates:`ignore_name_if_not_supported` option to not fail if `name` is present since `name` is not supported in ONTAP 9.6 and 9.7.
1738 - na_ontap_software_update: added `timeout` option to give enough time for the update to complete.
1739
1740 ### Bug fixes
1741 - na_ontap_aggregate: `disk-info` error when using `disks` option.
1742 - na_ontap_autosupport_invoke: `message` has changed to `autosupport_message` as Redhat has reserved this word. `message` has been alias'd to `autosupport_message`.
1743 - na_ontap_cifs_vserver: fix documentation and add more examples.
1744 - na_ontap_cluster: module was not idempotent when changing location or contact information.
1745 - na_ontap_igroup: idempotency issue when using uppercase hex digits (A, B, C, D, E, F) in WWN (ONTAP uses lowercase).
1746 - na_ontap_igroup_initiator: idempotency issue when using uppercase hex digits (A, B, C, D, E, F) in WWN (ONTAP uses lowercase).
1747 - na_ontap_security_certificates: allows (`common_name`, `type`) as an alternate key since `name` is not supported in ONTAP 9.6 and 9.7.
1748 - na_ontap_info: Fixed error causing module to fail on `metrocluster_check_info`, `env_sensors_info` and `volume_move_target_aggr_info`.
1749 - na_ontap_snapmirror: fixed KeyError when accessing `relationship_type` parameter.
1750 - na_ontap_snapmirror_policy: fixed a race condition when creating a new policy.
1751 - na_ontap_snapmirror_policy: fixed idempotency issue withis_network_compression_enabled for REST.
1752 - na_ontap_software_update: ignore connection errors during update as nodes cannot be reachable.
1753 - na_ontap_user: enable lock state and password to be set in the same task for existing user.
1754 - na_ontap_volume: issue when snapdir_access and atime_update not passed together.
1755 - na_ontap_vscan_on_access_policy: `bool` type was not properly set for `scan_files_with_no_ext`.
1756 - na_ontap_vscan_on_access_policy: `policy_status` enable/disable option was not supported.
1757 - na_ontap_vscan_on_demand_task: `file_ext_to_include` was not handled properly.
1758 - na_ontap_vscan_scanner_pool_policy: scanner_pool apply policy support on modification.
1759 - na_ontap_vserver_create(role): lif creation now defaults to system-defined unless iscsi lif type.
1760 - use_rest supports case insensitive.
1761
1762 ### Module documentation changes
1763 - use a three group format for `version_added`. So 2.7 becomes 2.7.0. Same thing for 2.8 and 2.9.
1764 - add `type:` and `elements:` information where missing.
1765 - update `required:` information.
1766
1767 ## 20.7.0
1768
1769 ### New Modules
1770 - na_ontap_security_certificates: Install, create, sign, delete security certificates.
1771
1772 ### New Options:
1773 - na_ontap_info: support `continue_on_error` option to continue when a ZAPI is not supported on a vserver, or for cluster RPC errors.
1774 - na_ontap_info: support `query` option to specify which objects to return.
1775 - na_ontap_info: support `vserver` tunneling to limit output to one vserver.
1776 - na_ontap_snapmirror_policy: support for SnapMirror policy rules.
1777 - na_ontap_vscan_scanner_pool: support modification.
1778 - na_ontap_rest_info: Support for gather subsets - `cluster_node_info, cluster_peer_info, disk_info, cifs_services_info, cifs_share_info`.
1779 - module_utils/netapp: add retry on wait_on_job when job failed. Abort 3 consecutive errors.
1780
1781 ### Bug fixes:
1782 - na_ontap_command: replace invalid backspace characters (0x08) with '.'.
1783 - na_ontap_firmware_download: exception on PCDATA if ONTAP returns a BEL (0x07) character.
1784 - na_ontap_info: lists were incorrectly processed in convert_keys, returning {}.
1785 - na_ontap_info: qtree_info is missing most entries. Changed key from `vserver:id` to `vserver:volume:id` .
1786 - na_ontap_iscsi_security: adding no_log for password parameters.
1787 - na_ontap_portset: adding explicit error message as modify portset is not supported.
1788 - na_ontap_snapmirror: fixed snapmirror delete for loadsharing to not go to quiesce state for the rest of the set.
1789 - na_ontap_ucadapter: fixed KeyError if type is not provided and mode is 'cna'.
1790 - na_ontap_user: checked `applications` does not contain snmp when using REST API call.
1791 - na_ontap_user: fixed KeyError if locked key not set with REST API call.
1792 - na_ontap_user: fixed KeyError if vserver: is empty with REST API call (useful to indicate cluster scope).
1793 - na_ontap_volume: fixed KeyError when getting info on a MVD volume
1794
1795 ### Example playbook
1796 - na_ontap_pb_get_online_volumes.yml: list of volumes that are online (or offline).
1797 - na_ontap_pb_install_SSL_certificate_REST.yml: installing SSL certificate using REST APIs.
1798
1799 ## 20.6.1
1800
1801 ### New Options:
1802 - na_ontap_firmware_upgrade: `reboot_sp`: reboot service processor before downloading package.
1803 - na_ontap_firmware_upgrade: `rename_package`: rename file when downloading service processor package.
1804 - na_ontap_firmware_upgrade: `replace_package`: replace local file when downloading service processor package.
1805
1806 ### Bug Fixes
1807 - na_ontap_firmware_upgrade: images are not downloaded, but the module reports success.
1808 - na_ontap_user: fixed KeyError if password is not provided.
1809 - na_ontap_password: do not error out if password is identical to previous password (idempotency).
1810
1811 ## 20.6.0
1812
1813 ### Support for SSL certificate authentication in addition to password
1814 The ONTAP Ansible modules currently require a username/password combination to authenticate with ONTAPI or REST APIs.
1815 It is now possible to use SSL certificate authentication with ONTAPI or REST.
1816 You will first need to install a SSL certificate in ONTAP, see for instance the first part of:
1817 https://netapp.io/2016/11/08/certificate-based-authentication-netapp-manageability-sdk-ontap/
1818 The applications that need to be authorized for `cert` are `ontapi` and `http`.
1819
1820 The new `cert_filepath`, `key_filepath` options enable SSL certificate authentication.
1821 This is mutually exclusive with using `username` and `password`.
1822
1823 ONTAP does not support `cert` authentication for console, so this is not supported for `na_ontap_command`.
1824
1825 SSL certificate authentication requires python2.7 or 3.x.
1826
1827 ### New Options
1828 - na_ontap_disks: `disk_type` option allows to assign specified type of disk.
1829 - na_ontap_firmware_upgrade: ignore timeout when downloading image unless `fail_on_502_error` is set to true.
1830 - na_ontap_info: `desired_attributes` advanced feature to select which fields to return.
1831 - na_ontap_info: `use_native_zapi_tags` to disable the conversion of '_' to '-' for attribute keys.
1832 - na_ontap_rest_info: `fields` options to request specific fields from subset.
1833 - na_ontap_software_update: `stabilize_minutes` option specifies number of minutes needed to stabilize node before update.
1834 - na_ontap_snapmirror: now performs restore with optional field `source_snapshot` for specific snapshot or uses latest.
1835 - na_ontap_ucadapter: `pair_adapters` option allows specifying the list of adapters which also need to be offline.
1836 - na_ontap_user: `authentication_password` option specifies password for the authentication protocol of SNMPv3 user.
1837 - na_ontap_user: `authentication_protocol` option specifies authentication protocol fo SNMPv3 user.
1838 - na_ontap_user: `engine_id` option specifies authoritative entity's EngineID for the SNMPv3 user.
1839 - na_ontap_user: `privacy_password` option specifies password for the privacy protocol of SNMPv3 user.
1840 - na_ontap_user: `privacy_protocol` option specifies privacy protocol of SNMPv3 user.
1841 - na_ontap_user: `remote_switch_ipaddress` option specifies the IP Address of the remote switch of SNMPv3 user.
1842 - na_ontap_volume: `check_interval` option checks if a volume move has been completed and then waits this number of seconds before checking again.
1843 - na_ontap_volume: `auto_remap_luns` option controls automatic mapping of LUNs during volume rehost.
1844 - na_ontap_volume: `force_restore` option forces volume to restore even if the volume has one or more newer Snapshotcopies.
1845 - na_ontap_volume: `force_unmap_luns` option controls automatic unmapping of LUNs during volume rehost.
1846 - na_ontap_volume: `from_vserver` option allows volume rehost from one vserver to another.
1847 - na_ontap_volume: `preserve_lun_ids` option controls LUNs in the volume being restored will remain mapped and their identities preserved.
1848 - na_ontap_volume: `snapshot_restore` option specifies name of snapshot to restore from.
1849 - all modules: `cert_filepath`, `key_filepath` to enable SSL certificate authentication (python 2.7 or 3.x).
1850
1851 ### Bug Fixes
1852 - na_ontap_firmware_upgrade: ignore timeout when downloading firmware images by default.
1853 - na_ontap_info: conversion from '-' to '_' was not done for lists of dictionaries.
1854 - na_ontap_ntfs_dacl: example fix in documentation string.
1855 - na_ontap_snapmirror: could not delete all rules (bug in netapp_module).
1856 - na_ontap_volume: modify was invoked multiple times when once is enough.
1857 - na_ontap_volume: fix KeyError on 'style' when volume is of type: data-protection.
1858 - na_ontap_volume: `wait_on_completion` is supported with volume moves.
1859 - module_utils/netapp_module: cater for empty lists in get_modified_attributes().
1860 - module_utils/netapp_module: cater for lists with duplicate elements in compare_lists().
1861
1862 ### Example playbook
1863 - na_ontap_pb_install_SSL_certificate.yml: installing a self-signed SSL certificate, and enabling SSL certificate authentication.
1864
1865 ### Added REST support to existing modules
1866 - na_ontap_user: added REST support for ONTAP user creation, modification & deletion.
1867
1868
1869 ## 20.5.0
1870
1871 ### New Options:
1872 - na_ontap_aggregate: `raid_type` options supports 'raid_0' for ONTAP Select.
1873 - na_ontap_cluster_peer: `encryption_protocol_proposed` option allows specifying encryption protocol to be used for inter-cluster communication.
1874 - na_ontap_info: new fact: aggr_efficiency_info.
1875 - na_ontap_info: new fact: cluster_switch_info.
1876 - na_ontap_info: new fact: disk_info.
1877 - na_ontap_info: new fact: env_sensors_info.
1878 - na_ontap_info: new fact: net_dev_discovery_info.
1879 - na_ontap_info: new fact: service_processor_info.
1880 - na_ontap_info: new fact: shelf_info.
1881 - na_ontap_info: new fact: sis_info.
1882 - na_ontap_info: new fact: subsys_health_info.
1883 - na_ontap_info: new fact: sysconfig_info.
1884 - na_ontap_info: new fact: sys_cluster_alerts.
1885 - na_ontap_info: new fact: volume_move_target_aggr_info.
1886 - na_ontap_info: new fact: volume_space_info.
1887 - na_ontap_nvme_namespace: `block_size` option allows specifying size in bytes of a logical block.
1888 - na_ontap_snapmirror: snapmirror now allows resume feature.
1889 - na_ontap_volume: `cutover_action` option allows specifying the action to be taken for cutover.
1890
1891 ### Bug Fixes
1892 - REST API call now honors the `http_port` parameter.
1893 - REST API detection now works with vserver (use_rest: Auto).
1894 - na_ontap_autosupport_invoke: when using ZAPI and name is not given, send autosupport message to all nodes in the cluster.
1895 - na_ontap_cg_snapshot: properly states it does not support check_mode.
1896 - na_ontap_cluster: ONTAP 9.3 or earlier does not support ZAPI element single-node-cluster.
1897 - na_ontap_cluster_ha: support check_mode.
1898 - na_ontap_cluster_peer: support check_mode.
1899 - na_ontap_cluster_peer: EMS log wrongly uses destination credentials with source hostname.
1900 - na_ontap_disks: support check_mode.
1901 - na_ontap_dns: support check_mode.
1902 - na_ontap_efficiency_policy: change `duration` type from int to str to support '-' input.
1903 - na_ontap_fcp: support check_mode.
1904 - na_ontap_flexcache: support check_mode.
1905 - na_ontap_info: `metrocluster_check_info` does not trigger a traceback but adds an "error" info element if the target system is not set up for metrocluster.
1906 - na_ontap_license: support check_mode.
1907 - na_ontap_login_messages: fix documentation link.
1908 - na_ontap_node: support check mode.
1909 - na_ontap_ntfs_sd: documentation string update for examples and made sure owner or group not mandatory.
1910 - na_ontap_ports: now support check mode.
1911 - na_ontap_restit: error can be a string in addition to a dict. This fix removes a traceback with AttributeError.
1912 - na_ontap_routes: support Check Mode correctly.
1913 - na_ontap_snapmirror: support check_mode.
1914 - na_ontap_software_update: Incorrectly stated that it support check mode, it does not.
1915 - na_ontap_svm_options: support check_mode.
1916 - na_ontap_volume: improve error reporting if required parameter is present but not set.
1917 - na_ontap_volume: suppress traceback in wait_for_completion as volume may not be completely ready.
1918 - na_ontap_volume: fix KeyError on 'style' when volume is offline.
1919 - na_ontap_volume_autosize: Support check_mode when `reset` option is given.
1920 - na_ontap_volume_snaplock: fix documentation link.
1921 - na_ontap_vserver_peer: support check_mode.
1922 - na_ontap_vserver_peer: EMS log wrongly uses destination credentials with source hostname.
1923
1924 ### New Modules
1925 - na_ontap_rest_info: Gather ONTAP subset information using REST APIs (9.6 and Above).
1926
1927 ### Role Change
1928 - na_ontap_cluster_config: Port Flowcontrol and autonegotiate can be set in role
1929
1930 ## 20.4.1
1931
1932 ### New Options
1933 - na_ontap_firmware_upgrade: `force_disruptive_update` and `package_url` options allows to make choices for download and upgrading packages.
1934
1935 ### Added REST support to existing modules
1936 - na_ontap_autosupport_invoke: added REST support for sending autosupport message.
1937
1938 ### Bug Fixes
1939 - na_ontap_volume: `volume_security_style` option now allows modify.
1940 - na_ontap_info: `metrocluster_check_info` has been removed as it was breaking the info module for everyone who didn't have a metrocluster set up. We are working on adding this back in a future update
1941
1942 ### Role Changes
1943 - na_ontap_vserver_create has a new default variable `netapp_version` set to 140. If you are running 9.2 or below please add the variable to your playbook and set to 120
1944
1945 ## 20.4.0
1946
1947 ### New Options
1948 - na_ontap_aggregate: `disk_count` option allows adding additional disk to aggregate.
1949 - na_ontap_info: `max_records` option specifies maximum number of records returned in a single ZAPI call.
1950 - na_ontap_info: `summary` option specifies a boolean flag to control return all or none of the info attributes.
1951 - na_ontap_info: new fact: iscsi_service_info.
1952 - na_ontap_info: new fact: license_info.
1953 - na_ontap_info: new fact: metrocluster_info.
1954 - na_ontap_info: new fact: metrocluster_check_info.
1955 - na_ontap_info: new fact: metrocluster_node_info.
1956 - na_ontap_info: new fact: net_interface_service_policy_info.
1957 - na_ontap_info: new fact: ontap_system_version.
1958 - na_ontap_info: new fact: ontapi_version (and deprecate ontap_version, both fields are reported for now).
1959 - na_ontap_info: new fact: qtree_info.
1960 - na_ontap_info: new fact: quota_report_info.
1961 - na_ontap_info: new fact: snapmirror_destination_info.
1962 - na_ontap_interface: `service_policy` option to identify a single service or a list of services that will use a LIF.
1963 - na_ontap_kerberos_realm: `ad_server_ip` option specifies IP Address of the Active Directory Domain Controller (DC).
1964 - na_ontap_kerberos_realm: `ad_server_name` option specifies Host name of the Active Directory Domain Controller (DC).
1965 - na_ontap_snapmirror_policy: REST is included and all defaults are removed from options.
1966 - na_ontap_snapmirror: `relationship-info-only` option allows to manage relationship information.
1967 - na_ontap_software_update: `download_only` options allows to download cluster image without software update.
1968 - na_ontap_volume: `snapshot_auto_delete` option allows to manage auto delete settings of a specified volume.
1969
1970 ### Bug Fixes
1971 - na_ontap_cifs_server: delete AD account if username and password are provided when state=absent
1972 - na_ontap_info: return all records of each gathered subset.
1973 - na_ontap_info: cifs_server_info: fix KeyError exception on `domain` if only `domain-workgroup` is present.
1974 - na_ontap_iscsi_security: Fixed modify functionality for CHAP and typo correction
1975 - na_ontap_kerberos_realm: fix `kdc_vendor` case sensitivity issue.
1976 - na_ontap_snapmirror: calling quiesce before snapmirror break.
1977
1978 ### New Modules
1979 - na_ontap_autosupport_invoke: send autosupport message.
1980 - na_ontap_ntfs_dacl: create/modify/delete ntfs dacl (discretionary access control list).
1981 - na_ontap_ntfs_sd: create/modify/delete ntfs security descriptor.
1982 - na_ontap_restit: send any REST API request to ONTAP (9.6 and above).
1983 - na_ontap_snmp_traphosts: Create and delete snmp traphosts (9.7 and Above)
1984 - na_ontap_wwpn_alias: create/modify/delete vserver fcp wwpn-alias.
1985 - na_ontap_zapit: send any ZAPI request to ONTAP.
1986
1987 ## 20.3.0
1988
1989 ### New Options
1990 - na_ontap_info: New info's added `cluster_identity_info`
1991 - na_ontap_info: New info's added `storage_bridge_info`
1992 - na_ontap_snapmirror: performs resync when the `relationship_state` is active and the current state is broken-off.
1993
1994 ### Bug Fixes
1995 - na_ontap_vscan_scanner_pool: has been updated to match the standard format used for all other ontap modules
1996 - na_ontap_volume_snaplock: Fixed KeyError exception on 'is-volume-append-mode-enabled'
1997
1998 ### New Modules
1999 - na_ontap_snapmirror_policy: create/modify/delete snapmirror policy.
2000
2001 ## 20.2.0
2002
2003 ### New Modules
2004 - na_ontap_volume_snaplock: modify volume snaplock retention.
2005
2006 ### New Options
2007 - na_ontap_info: New info's added `snapshot_info`
2008 - na_ontap_info: `max_records` option to set maximum number of records to return per subset.
2009 - na_ontap_snapmirror: `relationship_state` option for breaking the snapmirror relationship.
2010 - na_ontap_snapmirror: `update_snapmirror` option for updating the snapmirror relationship.
2011 - na_ontap_volume_clone: `split` option to split clone volume from parent volume.
2012
2013 ### Bug Fixes
2014 - na_ontap_cifs_server: Fixed KeyError exception on 'cifs_server_name'
2015 - na_ontap_command: fixed traceback when using return_dict if u'1' is present in result value.
2016 - na_ontap_login_messages: Fixed example documentation and spelling mistake issue
2017 - na_ontap_nvme_subsystem: fixed bug when creating subsystem, vserver was not filtered.
2018 - na_ontap_svm: if snapshot policy is changed, modify fails with "Extra input: snapshot_policy"
2019 - na_ontap_svm: if language: C.UTF-8 is specified, the module is not idempotent
2020 - na_ontap_volume_clone: fixed 'Extra input: parent-vserver' error when running as cluster admin.
2021 - na_ontap_qtree: Fixed issue with Get function for REST
2022
2023 ### Role Changes
2024 - na_ontap_nas_create role: fix typo in README file, add CIFS example.
2025
2026 ## 20.1.0
2027
2028 ### New Modules
2029 - na_ontap_login_messages: create/modify/delete security login messages including banner and mtod.
2030
2031 ### New Options
2032 - na_ontap_aggregate: add `snaplock_type`.
2033 - na_ontap_info: New info's added `cifs_server_info`, `cifs_share_info`, `cifs_vserver_security_info`, `cluster_peer_info`, `clock_info`, `export_policy_info`, `export_rule_info`, `fcp_adapter_info`, `fcp_alias_info`, `fcp_service_info`, `job_schedule_cron_info`, `kerberos_realm_info`, `ldap_client`, `ldap_config`, `net_failover_group_info`, `net_firewall_info`, `net_ipspaces_info`, `net_port_broadcast_domain_info`, `net_routes_info`, `net_vlan_info`, `nfs_info`, `ntfs_dacl_info`, `ntfs_sd_info`, `ntp_server_info`, `role_info`, `service_processor_network_info`, `sis_policy_info`, `snapmirror_policy_info`, `snapshot_policy_info`, `vscan_info`, `vserver_peer_info`
2034 - na_ontap_igroup_initiator: `force_remove` to forcibly remove initiators from an igroup that is currently mapped to a LUN.
2035 - na_ontap_interface: `failover_group` to specify the failover group for the LIF. `is_ipv4_link_local` to specify the LIF's are to acquire a ipv4 link local address.
2036 - na_ontap_rest_cli: add OPTIONS as a supported verb and return list of allowed verbs.
2037 - na_ontap_volume: add `group_id` and `user_id`.
2038
2039 ### Bug Fixes
2040 - na_ontap_aggregate: Fixed traceback when running as vsadmin and cleanly error out.
2041 - na_ontap_command: stdout_lines_filter contains data only if include/exlude_lines parameter is used. (zeten30)
2042 - na_ontap_command: stripped_line len is checked only once, filters are inside if block. (zeten30)
2043 - na_ontap_interface: allow module to run on node before joining the cluster.
2044 - na_ontap_net_ifgrp: Fixed error for na_ontap_net_ifgrp if no port is given.
2045 - na_ontap_snapmirror: Fixed traceback when running as vsadmin. Do not attempt to break a relationship that is 'Uninitialized'.
2046 - na_ontap_snapshot_policy: Fixed KeyError: 'prefix' bug when prefix parameter isn't supplied.
2047 - na_ontap_volume: Fixed error reporting if efficiency policy cannot be read. Do not attempt to read efficiency policy if not needed.
2048 - na_ontap_volume: Fixed error when modifying volume efficiency policy.
2049 - na_ontap_volume_clone: Fixed KeyError exception on 'volume'
2050
2051 ### Added REST support to existing modules
2052 - na_ontap_dns: added REST support for dns creation and modification on cluster vserver.
2053
2054 ### Role Changes
2055
2056 ## 19.11.0
2057
2058 ### New Modules
2059 - na_ontap_quota_policy: create/rename/delete quota policy.
2060
2061 ### New Options
2062 - na_ontap_cluster: added single node cluster option, also now supports for modify cluster contact and location option.
2063 - na_ontap_info: Now allow you use to VSadmin to get info (Must user `vserver` option).
2064 - na_ontap_info: Added `vscan_status_info`, `vscan_scanner_pool_info`, `vscan_connection_status_all_info`, `vscan_connection_extended_stats_info`
2065 - na_ontap_efficiency_policy: `changelog_threshold_percent` to set the percentage at which the changelog will be processed for a threshold type of policy, tested once each hour.
2066
2067 ### Bug Fixes
2068 - na_ontap_cluster: autosupport log pushed after cluster create is performed, removed license add or remove option.
2069 - na_ontap_dns: report error if modify or delete operations are attempted on cserver when using REST. Make create operation idempotent for cserver when using REST. Support for modify/delete on cserver when using REST will be added later.
2070 - na_ontap_firewall_policy: portmap added as a valid service
2071 - na_ontap_net_routes: REST does not support the 'metric' attribute
2072 - na_ontap_snapmirror: added initialize boolean option which specifies whether to initialize SnapMirror relation.
2073 - na_ontap_volume: fixed error when deleting flexGroup volume with ONTAP 9.7.
2074 - na_ontap_volume: tiering option requires 9.4 or later (error on volume-comp-aggr-attributes)
2075 - na_ontap_vscan_scanner_pool: fix module only gets one scanner pool.
2076
2077 ### Added REST support to existing modules
2078
2079 ### Role Changes
2080
2081 ## 19.10.0
2082 Changes in 19.10.0 and September collection releases compared to Ansible 2.9
2083
2084 ### New Modules
2085 - na_ontap_name_service_switch: create/modify/delete name service switch configuration.
2086 - na_ontap_iscsi_security: create/modify/delete iscsi security.
2087
2088 ### New Options
2089 - na_ontap_command: `vserver`: to allow command to run as either cluster admin or vserver admin. To run as vserver admin you must use the vserver option.
2090 - na_ontap_motd: rename `message` to `motd_message` to avoid conflict with Ansible internal variable name.
2091 - na_ontap_nvme_namespace: `size_unit` to specify size in different units.
2092 - na_ontap_snapshot_policy: `prefix`: option to use for creating snapshot policy.
2093
2094 ### Bug Fixes
2095 - na_ontap_ndmp: minor documentation changes for restore_vm_cache_size and data_port_range.
2096 - na_ontap_qtree: REST API takes "unix_permissions" as parameter instead of "mode".
2097 - na_ontap_qtree: unix permission is not available when security style is ntfs
2098 - na_ontap_user: minor documentation update for application parameter.
2099 - na_ontap_volume: `efficiency_policy` was ignored
2100 - na_ontap_volume: enforce that space_slo and space_guarantee are mutually exclusive
2101 - na_ontap_svm: "allowed_protocols" added to param in proper way in case of using REST API
2102 - na_ontap_firewall_policy: documentation changed for supported service parameter.
2103 - na_ontap_net_subnet: fix ip_ranges option fails on existing subnet.
2104 - na_ontap_snapshot_policy: fix vsadmin approach for managing snapshot policy.
2105 - na_ontap_nvme_subsystem: fix fetching unique nvme subsytem based on vserver filter.
2106 - na ontap_net_routes: change metric type from string to int.
2107 - na_ontap_cifs_server: minor documentation changes correction of create example with "name" parameter and adding type to parameters.
2108 - na_ontap_vserver_cifs_security: fix int and boolean options when modifying vserver cifs security.
2109 - na_ontap_net_subnet: fix rename idempotency issue and updated rename check.
2110
2111 ### Added REST support to existing modules
2112 By default, the module will use REST if the target system supports it, and the options are supported. Otherwise, it will switch back to ZAPI. This behavior can be controlled with the `use_rest` option:
2113 1. Always: to force REST. The module fails and reports an error if REST cannot be used.
2114 1. Never: to force ZAPI. This could be useful if you find some incompatibility with REST, or want to confirm the behavior is identical between REST and ZAPI.
2115 1. Auto: the default, as described above.
2116
2117 - na_ontap_ipspace
2118 - na_ontap_export_policy
2119 - na_ontap_ndmp
2120 -- Note: only `enable` and `authtype` are supported with REST
2121 - na_ontap_net_routes
2122 - na_ontap_qtree
2123 -- Note: `oplocks` is not supported with REST, defaults to enable.
2124 - na_ontap_svm
2125 -- Note: `root_volume`, `root_volume_aggregate`, `root_volume_security_style` are not supported with REST.
2126 - na_ontap_job_schedule
2127
2128 ### Role Changes
2129 - na_ontap_cluster_config updated to all cleaner playbook
2130 - na_ontap_vserver_create updated to all cleaner playbook
2131 - na_ontap_nas_create updated to all cleaner playbook
2132 - na_ontap_san_create updated to all cleaner playbook