IBM Spectrum Virtualize Collection v1.11.0 (ansible-collections#77)

* IBM Spectrum Virtualize Collection v1.11.0

Author: Shilpi-J

README.md

@@ -98,13 +98,16 @@ Alternatively, you can add a full namepsace and collection name in the `collecti
 - ibm_svc_vol_map - Manages volume mapping for Spectrum Virtualize storage systems
 - ibm_svcinfo_command - Runs svcinfo CLI command on Spectrum Virtualize storage systems over SSH session
 - ibm_svctask_command - Runs svctask CLI command(s) on Spectrum Virtualize storage systems over SSH session
+- ibm_sv_manage_awss3_cloudaccount - Manages Amazon S3 cloud account configuration on Spectrum Virtualize storage systems
+- ibm_sv_manage_cloud_backup - Manages cloud backups on Spectrum Virtualize storage systems
 - ibm_sv_manage_ip_partnership - Manages IP partnership configuration on Spectrum Virtualize storage systems
 - ibm_sv_manage_provisioning_policy - Manages provisioning policy configuration on Spectrum Virtualize storage systems
 - ibm_sv_manage_replication_policy - Manages policy-based replication configuration on Spectrum Virtualize storage systems
 - ibm_sv_manage_snapshot - Manages snapshots (mutual consistent images of a volume) on Spectrum Virtualize storage systems
 - ibm_sv_manage_snapshotpolicy - Manages snapshot policy configuration on Spectrum Virtualize storage systems
 - ibm_sv_manage_ssl_certificate - Exports an existing system certificate on to Spectrum Virtualize storage systems
 - ibm_sv_manage_truststore_for_replication - Manages certificate trust stores for replication on Spectrum Virtualize family storage systems
+- ibm_sv_restore_cloud_backup - Restores cloud backups on Spectrum Virtualize storage systems
 - ibm_sv_switch_replication_direction - Switches the replication direction on Spectrum Virtualize storage systems
 
 ### Other Feature Information
@@ -140,6 +143,7 @@ The modules in the IBM Spectrum Virtualize Ansible collection leverage REST APIs
 
 Currently we are not accepting community contributions.
 Though, you may periodically review this content to learn when and how contributions can be made in the future.
+IBM Spectrum Virtualize Ansible Collection maintainers can follow the [Maintainer guidelines](https://docs.ansible.com/ansible/devel/community/maintainers.html).
 
 ## License
 

changelogs/changelog.yaml

@@ -103,3 +103,20 @@ releases:
     - description: Manages the certificates trust store on Spectrum Virtualize storage systems
       name: ibm_sv_manage_truststore_for_replication
       namespace: ''
+  1.11.0:
+    release_date: '2022-12-16'
+    changes:
+      release_summary: Added new modules for configuring Transparent Cloud Tiering (TCT) through Ansible.
+      minor_changes:
+        - ibm_svc_host - Added support for modification of iSCSI host.
+        - ibm_svc_manage_migraiton - Added support for volume migration across pools.
+    modules:
+    - description: Manages AWS cloud account configuration on Spectrum Virtualize systems
+      name: ibm_sv_manage_awss3_cloudaccount
+      namespace: ''
+    - description: Manages cloud backup on Spectrum Virtualize systems
+      name: ibm_sv_manage_cloud_backups
+      namespace: ''
+    - description: Allows user to restore an existing cloud backup on Spectrum Virtualize systems
+      name: ibm_sv_restore_cloud_backup
+      namespace: ''

galaxy.yml

@@ -9,7 +9,7 @@ namespace: ibm
 name: spectrum_virtualize
 
 # The version of the collection. Must be compatible with semantic versioning
-version: 1.10.0
+version: 1.11.0
 
 # The path to the Markdown (.md) readme file. This path is relative to the root of the collection
 readme: README.md

plugins/module_utils/ibm_svc_utils.py

@@ -152,7 +152,7 @@ def token(self):
     def token(self, value):
         return setattr(self, '_token', value)
 
-    def _svc_rest(self, method, headers, cmd, cmdopts, cmdargs):
+    def _svc_rest(self, method, headers, cmd, cmdopts, cmdargs, timeout=10):
         """ Run SVC command with token info added into header
         :param method: http method, POST or GET
         :type method: string
@@ -163,6 +163,8 @@ def _svc_rest(self, method, headers, cmd, cmdopts, cmdargs):
         :param cmdopts: svc command options, name paramter and value
         :type cmdopts: dict
         :param cmdargs: svc command arguments, non-named paramaters
+        :type timeout: int
+        :param timeout: open_url argument to set timeout for http gateway
         :return: dict of command results
         :rtype: dict
         """
@@ -189,7 +191,7 @@ def _svc_rest(self, method, headers, cmd, cmdopts, cmdargs):
         self.log("_svc_rest: payload=%s", payload)
 
         try:
-            o = open_url(url, method=method, headers=headers,
+            o = open_url(url, method=method, headers=headers, timeout=timeout,
                          validate_certs=self.validate_certs, data=bytes(data))
         except HTTPError as e:
             self.log('_svc_rest: httperror %s', str(e))
@@ -236,14 +238,16 @@ def _svc_authorize(self):
 
         return None
 
-    def _svc_token_wrap(self, cmd, cmdopts, cmdargs):
+    def _svc_token_wrap(self, cmd, cmdopts, cmdargs, timeout=10):
         """ Run SVC command with token info added into header
         :param cmd: svc command to run
         :type cmd: string
         :param cmdopts: svc command options, name paramter and value
         :type cmdopts: dict
         :param cmdargs: svc command arguments, non-named paramaters
         :type cmdargs: list
+        :param timeout: open_url argument to set timeout for http gateway
+        :type timeout: int
         :returns: command results
         """
 
@@ -257,20 +261,22 @@ def _svc_token_wrap(self, cmd, cmdopts, cmdargs):
         }
 
         return self._svc_rest(method='POST', headers=headers, cmd=cmd,
-                              cmdopts=cmdopts, cmdargs=cmdargs)
+                              cmdopts=cmdopts, cmdargs=cmdargs, timeout=timeout)
 
-    def svc_run_command(self, cmd, cmdopts, cmdargs):
+    def svc_run_command(self, cmd, cmdopts, cmdargs, timeout=10):
         """ Generic execute a SVC command
         :param cmd: svc command to run
         :type cmd: string
         :param cmdopts: svc command options, name parameter and value
         :type cmdopts: dict
         :param cmdargs: svc command arguments, non-named parameters
         :type cmdargs: list
+        :param timeout: open_url argument to set timeout for http gateway
+        :type timeout: int
         :returns: command output
         """
 
-        rest = self._svc_token_wrap(cmd, cmdopts, cmdargs)
+        rest = self._svc_token_wrap(cmd, cmdopts, cmdargs, timeout)
         self.log("svc_run_command rest=%s", rest)
 
         if rest['err']:
@@ -281,19 +287,21 @@ def svc_run_command(self, cmd, cmdopts, cmdargs):
         # Might be None
         return rest['out']
 
-    def svc_obj_info(self, cmd, cmdopts, cmdargs):
+    def svc_obj_info(self, cmd, cmdopts, cmdargs, timeout=10):
         """ Obtain information about an SVC object through the ls command
         :param cmd: svc command to run
         :type cmd: string
         :param cmdopts: svc command options, name parameter and value
         :type cmdopts: dict
         :param cmdargs: svc command arguments, non-named paramaters
         :type cmdargs: list
+        :param timeout: open_url argument to set timeout for http gateway
+        :type timeout: int
         :returns: command output
         :rtype: dict
         """
 
-        rest = self._svc_token_wrap(cmd, cmdopts, cmdargs)
+        rest = self._svc_token_wrap(cmd, cmdopts, cmdargs, timeout)
         self.log("svc_obj_info rest=%s", rest)
 
         if rest['code']: