oci 2.125.2__py3-none-any.whl → 2.126.0__py3-none-any.whl

oci/os_management_hub/managed_instance_client_composite_operations.py

@@ -31,7 +31,9 @@ class ManagedInstanceClientCompositeOperations(object):
         to enter the given state(s).
 
         :param str managed_instance_id: (required)
-            The OCID of the managed instance.
+            The `OCID`__ of the managed instance.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param oci.os_management_hub.models.AttachSoftwareSourcesToManagedInstanceDetails attach_software_sources_to_managed_instance_details: (required)
             Details of software sources to be attached to a managed instance.
@@ -67,13 +69,64 @@ class ManagedInstanceClientCompositeOperations(object):
         except Exception as e:
             raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e)
 
+    def delete_managed_instance_and_wait_for_state(self, managed_instance_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}):
+        """
+        Calls :py:func:`~oci.os_management_hub.ManagedInstanceClient.delete_managed_instance` and waits for the :py:class:`~oci.os_management_hub.models.WorkRequest`
+        to enter the given state(s).
+
+        :param str managed_instance_id: (required)
+            The `OCID`__ of the managed instance.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
+
+        :param list[str] wait_for_states:
+            An array of states to wait on. These should be valid values for :py:attr:`~oci.os_management_hub.models.WorkRequest.status`
+
+        :param dict operation_kwargs:
+            A dictionary of keyword arguments to pass to :py:func:`~oci.os_management_hub.ManagedInstanceClient.delete_managed_instance`
+
+        :param dict waiter_kwargs:
+            A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds``
+            as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait
+        """
+        operation_result = None
+        try:
+            operation_result = self.client.delete_managed_instance(managed_instance_id, **operation_kwargs)
+        except oci.exceptions.ServiceError as e:
+            if e.status == 404:
+                return WAIT_RESOURCE_NOT_FOUND
+            else:
+                raise e
+
+        if not wait_for_states:
+            return operation_result
+        lowered_wait_for_states = [w.lower() for w in wait_for_states]
+        if 'opc-work-request-id' not in operation_result.headers:
+            return operation_result
+        wait_for_resource_id = operation_result.headers['opc-work-request-id']
+
+        try:
+            waiter_result = oci.wait_until(
+                self.client,
+                self.client.get_work_request(wait_for_resource_id),
+                evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_wait_for_states,
+                **waiter_kwargs
+            )
+            result_to_return = waiter_result
+
+            return result_to_return
+        except Exception as e:
+            raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e)
+
     def detach_software_sources_from_managed_instance_and_wait_for_state(self, managed_instance_id, detach_software_sources_from_managed_instance_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}):
         """
         Calls :py:func:`~oci.os_management_hub.ManagedInstanceClient.detach_software_sources_from_managed_instance` and waits for the :py:class:`~oci.os_management_hub.models.WorkRequest`
         to enter the given state(s).
 
         :param str managed_instance_id: (required)
-            The OCID of the managed instance.
+            The `OCID`__ of the managed instance.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param oci.os_management_hub.models.DetachSoftwareSourcesFromManagedInstanceDetails detach_software_sources_from_managed_instance_details: (required)
             Details of software sources to be detached from a managed instance.
@@ -115,7 +168,9 @@ class ManagedInstanceClientCompositeOperations(object):
         to enter the given state(s).
 
         :param str managed_instance_id: (required)
-            The OCID of the managed instance.
+            The `OCID`__ of the managed instance.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param oci.os_management_hub.models.DisableModuleStreamOnManagedInstanceDetails disable_module_stream_on_managed_instance_details: (required)
             The details of the module stream to be disabled on a managed instance.
@@ -157,7 +212,9 @@ class ManagedInstanceClientCompositeOperations(object):
         to enter the given state(s).
 
         :param str managed_instance_id: (required)
-            The OCID of the managed instance.
+            The `OCID`__ of the managed instance.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param oci.os_management_hub.models.EnableModuleStreamOnManagedInstanceDetails enable_module_stream_on_managed_instance_details: (required)
             The details of the module stream to be enabled on a managed instance.
@@ -193,13 +250,54 @@ class ManagedInstanceClientCompositeOperations(object):
         except Exception as e:
             raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e)
 
+    def install_all_windows_updates_on_managed_instances_in_compartment_and_wait_for_state(self, install_all_windows_updates_on_managed_instances_in_compartment_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}):
+        """
+        Calls :py:func:`~oci.os_management_hub.ManagedInstanceClient.install_all_windows_updates_on_managed_instances_in_compartment` and waits for the :py:class:`~oci.os_management_hub.models.WorkRequest`
+        to enter the given state(s).
+
+        :param oci.os_management_hub.models.InstallAllWindowsUpdatesOnManagedInstancesInCompartmentDetails install_all_windows_updates_on_managed_instances_in_compartment_details: (required)
+            The details about Windows update types to be installed on all managed instances in a compartment.
+
+        :param list[str] wait_for_states:
+            An array of states to wait on. These should be valid values for :py:attr:`~oci.os_management_hub.models.WorkRequest.status`
+
+        :param dict operation_kwargs:
+            A dictionary of keyword arguments to pass to :py:func:`~oci.os_management_hub.ManagedInstanceClient.install_all_windows_updates_on_managed_instances_in_compartment`
+
+        :param dict waiter_kwargs:
+            A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds``
+            as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait
+        """
+        operation_result = self.client.install_all_windows_updates_on_managed_instances_in_compartment(install_all_windows_updates_on_managed_instances_in_compartment_details, **operation_kwargs)
+        if not wait_for_states:
+            return operation_result
+        lowered_wait_for_states = [w.lower() for w in wait_for_states]
+        if 'opc-work-request-id' not in operation_result.headers:
+            return operation_result
+        wait_for_resource_id = operation_result.headers['opc-work-request-id']
+
+        try:
+            waiter_result = oci.wait_until(
+                self.client,
+                self.client.get_work_request(wait_for_resource_id),
+                evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_wait_for_states,
+                **waiter_kwargs
+            )
+            result_to_return = waiter_result
+
+            return result_to_return
+        except Exception as e:
+            raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e)
+
     def install_module_stream_profile_on_managed_instance_and_wait_for_state(self, managed_instance_id, install_module_stream_profile_on_managed_instance_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}):
         """
         Calls :py:func:`~oci.os_management_hub.ManagedInstanceClient.install_module_stream_profile_on_managed_instance` and waits for the :py:class:`~oci.os_management_hub.models.WorkRequest`
         to enter the given state(s).
 
         :param str managed_instance_id: (required)
-            The OCID of the managed instance.
+            The `OCID`__ of the managed instance.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param oci.os_management_hub.models.InstallModuleStreamProfileOnManagedInstanceDetails install_module_stream_profile_on_managed_instance_details: (required)
             The details of the module stream profile to be installed on a managed instance.
@@ -241,7 +339,9 @@ class ManagedInstanceClientCompositeOperations(object):
         to enter the given state(s).
 
         :param str managed_instance_id: (required)
-            The OCID of the managed instance.
+            The `OCID`__ of the managed instance.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param oci.os_management_hub.models.InstallPackagesOnManagedInstanceDetails install_packages_on_managed_instance_details: (required)
             Details about packages to be installed on a managed instance.
@@ -277,13 +377,59 @@ class ManagedInstanceClientCompositeOperations(object):
         except Exception as e:
             raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e)
 
+    def install_windows_updates_on_managed_instance_and_wait_for_state(self, managed_instance_id, install_windows_updates_on_managed_instance_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}):
+        """
+        Calls :py:func:`~oci.os_management_hub.ManagedInstanceClient.install_windows_updates_on_managed_instance` and waits for the :py:class:`~oci.os_management_hub.models.WorkRequest`
+        to enter the given state(s).
+
+        :param str managed_instance_id: (required)
+            The `OCID`__ of the managed instance.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
+
+        :param oci.os_management_hub.models.InstallWindowsUpdatesOnManagedInstanceDetails install_windows_updates_on_managed_instance_details: (required)
+            Details about Windows updates to be installed on a managed instance.
+
+        :param list[str] wait_for_states:
+            An array of states to wait on. These should be valid values for :py:attr:`~oci.os_management_hub.models.WorkRequest.status`
+
+        :param dict operation_kwargs:
+            A dictionary of keyword arguments to pass to :py:func:`~oci.os_management_hub.ManagedInstanceClient.install_windows_updates_on_managed_instance`
+
+        :param dict waiter_kwargs:
+            A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds``
+            as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait
+        """
+        operation_result = self.client.install_windows_updates_on_managed_instance(managed_instance_id, install_windows_updates_on_managed_instance_details, **operation_kwargs)
+        if not wait_for_states:
+            return operation_result
+        lowered_wait_for_states = [w.lower() for w in wait_for_states]
+        if 'opc-work-request-id' not in operation_result.headers:
+            return operation_result
+        wait_for_resource_id = operation_result.headers['opc-work-request-id']
+
+        try:
+            waiter_result = oci.wait_until(
+                self.client,
+                self.client.get_work_request(wait_for_resource_id),
+                evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_wait_for_states,
+                **waiter_kwargs
+            )
+            result_to_return = waiter_result
+
+            return result_to_return
+        except Exception as e:
+            raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e)
+
     def list_managed_instance_modules_and_wait_for_state(self, managed_instance_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}):
         """
         Calls :py:func:`~oci.os_management_hub.ManagedInstanceClient.list_managed_instance_modules` and waits for the :py:class:`~oci.os_management_hub.models.WorkRequest`
         to enter the given state(s).
 
         :param str managed_instance_id: (required)
-            The OCID of the managed instance.
+            The `OCID`__ of the managed instance.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param list[str] wait_for_states:
             An array of states to wait on. These should be valid values for :py:attr:`~oci.os_management_hub.models.WorkRequest.status`
@@ -322,7 +468,9 @@ class ManagedInstanceClientCompositeOperations(object):
         to enter the given state(s).
 
         :param str managed_instance_id: (required)
-            The OCID of the managed instance.
+            The `OCID`__ of the managed instance.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param oci.os_management_hub.models.ManageModuleStreamsOnManagedInstanceDetails manage_module_streams_on_managed_instance_details: (required)
             A description of an operation to perform against the modules, streams, and profiles of a managed instance.
@@ -364,7 +512,9 @@ class ManagedInstanceClientCompositeOperations(object):
         to enter the given state(s).
 
         :param str managed_instance_id: (required)
-            The OCID of the managed instance.
+            The `OCID`__ of the managed instance.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param list[str] wait_for_states:
             An array of states to wait on. These should be valid values for :py:attr:`~oci.os_management_hub.models.WorkRequest.status`
@@ -403,7 +553,9 @@ class ManagedInstanceClientCompositeOperations(object):
         to enter the given state(s).
 
         :param str managed_instance_id: (required)
-            The OCID of the managed instance.
+            The `OCID`__ of the managed instance.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param oci.os_management_hub.models.RemoveModuleStreamProfileFromManagedInstanceDetails remove_module_stream_profile_from_managed_instance_details: (required)
             The details of the module stream profile to be removed from a managed instance.
@@ -445,7 +597,9 @@ class ManagedInstanceClientCompositeOperations(object):
         to enter the given state(s).
 
         :param str managed_instance_id: (required)
-            The OCID of the managed instance.
+            The `OCID`__ of the managed instance.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param oci.os_management_hub.models.RemovePackagesFromManagedInstanceDetails remove_packages_from_managed_instance_details: (required)
             Details about packages to be removed on a managed instance.
@@ -487,7 +641,9 @@ class ManagedInstanceClientCompositeOperations(object):
         to enter the given state(s).
 
         :param str managed_instance_id: (required)
-            The OCID of the managed instance.
+            The `OCID`__ of the managed instance.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param oci.os_management_hub.models.SwitchModuleStreamOnManagedInstanceDetails switch_module_stream_on_managed_instance_details: (required)
             The details of the module stream to be switched on a managed instance.
@@ -568,7 +724,9 @@ class ManagedInstanceClientCompositeOperations(object):
         to enter the given state(s).
 
         :param str managed_instance_id: (required)
-            The OCID of the managed instance.
+            The `OCID`__ of the managed instance.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param oci.os_management_hub.models.UpdatePackagesOnManagedInstanceDetails update_packages_on_managed_instance_details: (required)
             Details about packages to be updated on a managed instance.