oci 2.100.0__py3-none-any.whl → 2.102.0__py3-none-any.whl

oci/core/compute_management_client.py

@@ -157,7 +157,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/attach_instance_pool_instance.py.html>`__ to see an example of how to use attach_instance_pool_instance API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/attach_instance_pool_instance.py.html>`__ to see an example of how to use attach_instance_pool_instance API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['instancePoolId']
@@ -270,7 +270,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/attach_load_balancer.py.html>`__ to see an example of how to use attach_load_balancer API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/attach_load_balancer.py.html>`__ to see an example of how to use attach_load_balancer API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['instancePoolId']
@@ -396,7 +396,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/change_cluster_network_compartment.py.html>`__ to see an example of how to use change_cluster_network_compartment API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/change_cluster_network_compartment.py.html>`__ to see an example of how to use change_cluster_network_compartment API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['clusterNetworkId']
@@ -528,7 +528,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/change_instance_configuration_compartment.py.html>`__ to see an example of how to use change_instance_configuration_compartment API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/change_instance_configuration_compartment.py.html>`__ to see an example of how to use change_instance_configuration_compartment API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['instanceConfigurationId']
@@ -654,7 +654,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/change_instance_pool_compartment.py.html>`__ to see an example of how to use change_instance_pool_compartment API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/change_instance_pool_compartment.py.html>`__ to see an example of how to use change_instance_pool_compartment API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['instancePoolId']
@@ -762,7 +762,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/create_cluster_network.py.html>`__ to see an example of how to use create_cluster_network API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/create_cluster_network.py.html>`__ to see an example of how to use create_cluster_network API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
@@ -854,7 +854,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/create_instance_configuration.py.html>`__ to see an example of how to use create_instance_configuration API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/create_instance_configuration.py.html>`__ to see an example of how to use create_instance_configuration API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
@@ -945,7 +945,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/create_instance_pool.py.html>`__ to see an example of how to use create_instance_pool API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/create_instance_pool.py.html>`__ to see an example of how to use create_instance_pool API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
@@ -1034,7 +1034,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/delete_instance_configuration.py.html>`__ to see an example of how to use delete_instance_configuration API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/delete_instance_configuration.py.html>`__ to see an example of how to use delete_instance_configuration API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['instanceConfigurationId']
@@ -1137,7 +1137,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/detach_instance_pool_instance.py.html>`__ to see an example of how to use detach_instance_pool_instance API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/detach_instance_pool_instance.py.html>`__ to see an example of how to use detach_instance_pool_instance API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['instancePoolId']
@@ -1248,7 +1248,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/detach_load_balancer.py.html>`__ to see an example of how to use detach_load_balancer API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/detach_load_balancer.py.html>`__ to see an example of how to use detach_load_balancer API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['instancePoolId']
@@ -1348,7 +1348,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/get_cluster_network.py.html>`__ to see an example of how to use get_cluster_network API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/get_cluster_network.py.html>`__ to see an example of how to use get_cluster_network API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['clusterNetworkId']
@@ -1434,7 +1434,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/get_instance_configuration.py.html>`__ to see an example of how to use get_instance_configuration API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/get_instance_configuration.py.html>`__ to see an example of how to use get_instance_configuration API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['instanceConfigurationId']
@@ -1522,7 +1522,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/get_instance_pool.py.html>`__ to see an example of how to use get_instance_pool API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/get_instance_pool.py.html>`__ to see an example of how to use get_instance_pool API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['instancePoolId']
@@ -1615,7 +1615,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/get_instance_pool_instance.py.html>`__ to see an example of how to use get_instance_pool_instance API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/get_instance_pool_instance.py.html>`__ to see an example of how to use get_instance_pool_instance API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['instancePoolId', 'instanceId']
@@ -1707,7 +1707,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/get_instance_pool_load_balancer_attachment.py.html>`__ to see an example of how to use get_instance_pool_load_balancer_attachment API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/get_instance_pool_load_balancer_attachment.py.html>`__ to see an example of how to use get_instance_pool_load_balancer_attachment API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['instancePoolId', 'instancePoolLoadBalancerAttachmentId']
@@ -1810,7 +1810,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/launch_instance_configuration.py.html>`__ to see an example of how to use launch_instance_configuration API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/launch_instance_configuration.py.html>`__ to see an example of how to use launch_instance_configuration API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['instanceConfigurationId']
@@ -1950,7 +1950,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/list_cluster_network_instances.py.html>`__ to see an example of how to use list_cluster_network_instances API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/list_cluster_network_instances.py.html>`__ to see an example of how to use list_cluster_network_instances API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['clusterNetworkId', 'compartmentId']
@@ -2116,7 +2116,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/list_cluster_networks.py.html>`__ to see an example of how to use list_cluster_networks API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/list_cluster_networks.py.html>`__ to see an example of how to use list_cluster_networks API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId']
@@ -2270,7 +2270,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/list_instance_configurations.py.html>`__ to see an example of how to use list_instance_configurations API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/list_instance_configurations.py.html>`__ to see an example of how to use list_instance_configurations API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId']
@@ -2421,7 +2421,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/list_instance_pool_instances.py.html>`__ to see an example of how to use list_instance_pool_instances API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/list_instance_pool_instances.py.html>`__ to see an example of how to use list_instance_pool_instances API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['instancePoolId', 'compartmentId']
@@ -2587,7 +2587,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/list_instance_pools.py.html>`__ to see an example of how to use list_instance_pools API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/list_instance_pools.py.html>`__ to see an example of how to use list_instance_pools API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId']
@@ -2720,7 +2720,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/reset_instance_pool.py.html>`__ to see an example of how to use reset_instance_pool API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/reset_instance_pool.py.html>`__ to see an example of how to use reset_instance_pool API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['instancePoolId']
@@ -2834,7 +2834,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/softreset_instance_pool.py.html>`__ to see an example of how to use softreset_instance_pool API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/softreset_instance_pool.py.html>`__ to see an example of how to use softreset_instance_pool API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['instancePoolId']
@@ -2906,6 +2906,120 @@ class ComputeManagementClient(object):
                 api_reference_link=api_reference_link,
                 required_arguments=required_arguments)
 
+    def softstop_instance_pool(self, instance_pool_id, **kwargs):
+        """
+        Performs the softstop (ACPI shutdown and power on) action on the specified instance pool,
+        which performs the action on all the instances in the pool.
+
+        Softstop gracefully reboots the instances by sending a shutdown command to the operating systems.
+        After waiting 15 minutes for the OS to shutdown, the instances are powered off and then powered back on.
+
+
+        :param str instance_pool_id: (required)
+            The `OCID`__ of the instance pool.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
+
+        :param str opc_retry_token: (optional)
+            A token that uniquely identifies a request so it can be retried in case of a timeout or
+            server error without risk of executing that same action again. Retry tokens expire after 24
+            hours, but can be invalidated before then due to conflicting operations (for example, if a resource
+            has been deleted and purged from the system, then a retry of the original creation request
+            may be rejected).
+
+        :param str if_match: (optional)
+            For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
+            parameter to the value of the etag from a previous GET or POST response for that resource. The resource
+            will be updated or deleted only if the etag you provide matches the resource's current etag value.
+
+        :param obj retry_strategy: (optional)
+            A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
+
+            This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it.
+            The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
+
+            To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
+
+        :param bool allow_control_chars: (optional)
+            allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
+            By default, the response will not allow control characters in strings
+
+        :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.core.models.InstancePool`
+        :rtype: :class:`~oci.response.Response`
+
+        :example:
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/softstop_instance_pool.py.html>`__ to see an example of how to use softstop_instance_pool API.
+        """
+        # Required path and query arguments. These are in camelCase to replace values in service endpoints.
+        required_arguments = ['instancePoolId']
+        resource_path = "/instancePools/{instancePoolId}/actions/softstop"
+        method = "POST"
+        operation_name = "softstop_instance_pool"
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/iaas/20160918/InstancePool/SoftstopInstancePool"
+
+        # Don't accept unknown kwargs
+        expected_kwargs = [
+            "allow_control_chars",
+            "retry_strategy",
+            "opc_retry_token",
+            "if_match"
+        ]
+        extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
+        if extra_kwargs:
+            raise ValueError(
+                "softstop_instance_pool got unknown kwargs: {!r}".format(extra_kwargs))
+
+        path_params = {
+            "instancePoolId": instance_pool_id
+        }
+
+        path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
+
+        for (k, v) in six.iteritems(path_params):
+            if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
+                raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k))
+
+        header_params = {
+            "accept": "application/json",
+            "content-type": "application/json",
+            "opc-retry-token": kwargs.get("opc_retry_token", missing),
+            "if-match": kwargs.get("if_match", missing)
+        }
+        header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
+
+        retry_strategy = self.base_client.get_preferred_retry_strategy(
+            operation_retry_strategy=kwargs.get('retry_strategy'),
+            client_retry_strategy=self.retry_strategy
+        )
+
+        if retry_strategy:
+            if not isinstance(retry_strategy, retry.NoneRetryStrategy):
+                self.base_client.add_opc_retry_token_if_needed(header_params)
+                self.base_client.add_opc_client_retries_header(header_params)
+                retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
+            return retry_strategy.make_retrying_call(
+                self.base_client.call_api,
+                resource_path=resource_path,
+                method=method,
+                path_params=path_params,
+                header_params=header_params,
+                response_type="InstancePool",
+                allow_control_chars=kwargs.get('allow_control_chars'),
+                operation_name=operation_name,
+                api_reference_link=api_reference_link,
+                required_arguments=required_arguments)
+        else:
+            return self.base_client.call_api(
+                resource_path=resource_path,
+                method=method,
+                path_params=path_params,
+                header_params=header_params,
+                response_type="InstancePool",
+                allow_control_chars=kwargs.get('allow_control_chars'),
+                operation_name=operation_name,
+                api_reference_link=api_reference_link,
+                required_arguments=required_arguments)
+
     def start_instance_pool(self, instance_pool_id, **kwargs):
         """
         Performs the start (power on) action on the specified instance pool,
@@ -2945,7 +3059,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/start_instance_pool.py.html>`__ to see an example of how to use start_instance_pool API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/start_instance_pool.py.html>`__ to see an example of how to use start_instance_pool API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['instancePoolId']
@@ -3056,7 +3170,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/stop_instance_pool.py.html>`__ to see an example of how to use stop_instance_pool API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/stop_instance_pool.py.html>`__ to see an example of how to use stop_instance_pool API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['instancePoolId']
@@ -3162,7 +3276,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/terminate_cluster_network.py.html>`__ to see an example of how to use terminate_cluster_network API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/terminate_cluster_network.py.html>`__ to see an example of how to use terminate_cluster_network API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['clusterNetworkId']
@@ -3267,7 +3381,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/terminate_instance_pool.py.html>`__ to see an example of how to use terminate_instance_pool API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/terminate_instance_pool.py.html>`__ to see an example of how to use terminate_instance_pool API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['instancePoolId']
@@ -3375,7 +3489,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/update_cluster_network.py.html>`__ to see an example of how to use update_cluster_network API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/update_cluster_network.py.html>`__ to see an example of how to use update_cluster_network API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['clusterNetworkId']
@@ -3488,7 +3602,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/update_instance_configuration.py.html>`__ to see an example of how to use update_instance_configuration API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/update_instance_configuration.py.html>`__ to see an example of how to use update_instance_configuration API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['instanceConfigurationId']
@@ -3605,7 +3719,7 @@ class ComputeManagementClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.100.0/core/update_instance_pool.py.html>`__ to see an example of how to use update_instance_pool API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.102.0/core/update_instance_pool.py.html>`__ to see an example of how to use update_instance_pool API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['instancePoolId']

oci/core/compute_management_client_composite_operations.py

@@ -500,6 +500,51 @@ class ComputeManagementClientCompositeOperations(object):
         except Exception as e:
             raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e)
 
+    def softstop_instance_pool_and_wait_for_state(self, instance_pool_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}):
+        """
+        Calls :py:func:`~oci.core.ComputeManagementClient.softstop_instance_pool` and waits for the :py:class:`~oci.core.models.InstancePool` acted upon
+        to enter the given state(s).
+
+        :param str instance_pool_id: (required)
+            The `OCID`__ of the instance pool.
+
+            __ 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.core.models.InstancePool.lifecycle_state`
+
+        :param dict operation_kwargs:
+            A dictionary of keyword arguments to pass to :py:func:`~oci.core.ComputeManagementClient.softstop_instance_pool`
+
+        :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.softstop_instance_pool(instance_pool_id, **operation_kwargs)
+        if not wait_for_states:
+            return operation_result
+
+        lowered_wait_for_states = [w.lower() for w in wait_for_states]
+        instance_pool_id = operation_result.data.id
+
+        try:
+            waiter_result = oci.wait_until(
+                self.client,
+                self.client.get_instance_pool(instance_pool_id),  # noqa: F821
+                evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states,
+                **waiter_kwargs
+            )
+            result_to_return = waiter_result
+
+            return result_to_return
+        except (NameError, TypeError) as e:
+            if not e.args:
+                e.args = ('',)
+            e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', )
+            raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e)
+        except Exception as e:
+            raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e)
+
     def start_instance_pool_and_wait_for_state(self, instance_pool_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}):
         """
         Calls :py:func:`~oci.core.ComputeManagementClient.start_instance_pool` and waits for the :py:class:`~oci.core.models.InstancePool` acted upon

oci/core/models/__init__.py

@@ -286,6 +286,7 @@ from .instance_configuration_attach_volume_details import InstanceConfigurationA
 from .instance_configuration_autotune_policy import InstanceConfigurationAutotunePolicy
 from .instance_configuration_availability_config import InstanceConfigurationAvailabilityConfig
 from .instance_configuration_block_volume_details import InstanceConfigurationBlockVolumeDetails
+from .instance_configuration_block_volume_replica_details import InstanceConfigurationBlockVolumeReplicaDetails
 from .instance_configuration_create_vnic_details import InstanceConfigurationCreateVnicDetails
 from .instance_configuration_create_volume_details import InstanceConfigurationCreateVolumeDetails
 from .instance_configuration_detached_volume_autotune_policy import InstanceConfigurationDetachedVolumeAutotunePolicy
@@ -820,6 +821,7 @@ core_type_mapping = {
     "InstanceConfigurationAutotunePolicy": InstanceConfigurationAutotunePolicy,
     "InstanceConfigurationAvailabilityConfig": InstanceConfigurationAvailabilityConfig,
     "InstanceConfigurationBlockVolumeDetails": InstanceConfigurationBlockVolumeDetails,
+    "InstanceConfigurationBlockVolumeReplicaDetails": InstanceConfigurationBlockVolumeReplicaDetails,
     "InstanceConfigurationCreateVnicDetails": InstanceConfigurationCreateVnicDetails,
     "InstanceConfigurationCreateVolumeDetails": InstanceConfigurationCreateVolumeDetails,
     "InstanceConfigurationDetachedVolumeAutotunePolicy": InstanceConfigurationDetachedVolumeAutotunePolicy,

oci/core/models/instance_configuration_availability_config.py

@@ -26,6 +26,10 @@ class InstanceConfigurationAvailabilityConfig(object):
         Initializes a new InstanceConfigurationAvailabilityConfig object with values from keyword arguments.
         The following keyword arguments are supported (corresponding to the getters/setters of this class):
 
+        :param is_live_migration_preferred:
+            The value to assign to the is_live_migration_preferred property of this InstanceConfigurationAvailabilityConfig.
+        :type is_live_migration_preferred: bool
+
         :param recovery_action:
             The value to assign to the recovery_action property of this InstanceConfigurationAvailabilityConfig.
             Allowed values for this property are: "RESTORE_INSTANCE", "STOP_INSTANCE", 'UNKNOWN_ENUM_VALUE'.
@@ -34,15 +38,46 @@ class InstanceConfigurationAvailabilityConfig(object):
 
         """
         self.swagger_types = {
+            'is_live_migration_preferred': 'bool',
             'recovery_action': 'str'
         }
 
         self.attribute_map = {
+            'is_live_migration_preferred': 'isLiveMigrationPreferred',
             'recovery_action': 'recoveryAction'
         }
 
+        self._is_live_migration_preferred = None
         self._recovery_action = None
 
+    @property
+    def is_live_migration_preferred(self):
+        """
+        Gets the is_live_migration_preferred of this InstanceConfigurationAvailabilityConfig.
+        Whether to live migrate supported VM instances to a healthy physical VM host without
+        disrupting running instances during infrastructure maintenance events. If null, Oracle
+        chooses the best option for migrating the VM during infrastructure maintenance events.
+
+
+        :return: The is_live_migration_preferred of this InstanceConfigurationAvailabilityConfig.
+        :rtype: bool
+        """
+        return self._is_live_migration_preferred
+
+    @is_live_migration_preferred.setter
+    def is_live_migration_preferred(self, is_live_migration_preferred):
+        """
+        Sets the is_live_migration_preferred of this InstanceConfigurationAvailabilityConfig.
+        Whether to live migrate supported VM instances to a healthy physical VM host without
+        disrupting running instances during infrastructure maintenance events. If null, Oracle
+        chooses the best option for migrating the VM during infrastructure maintenance events.
+
+
+        :param is_live_migration_preferred: The is_live_migration_preferred of this InstanceConfigurationAvailabilityConfig.
+        :type: bool
+        """
+        self._is_live_migration_preferred = is_live_migration_preferred
+
     @property
     def recovery_action(self):
         """

oci/core/models/instance_configuration_block_volume_replica_details.py

@@ -0,0 +1,107 @@
+# coding: utf-8
+# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+
+from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel  # noqa: F401
+from oci.decorators import init_model_state_from_kwargs
+
+
+@init_model_state_from_kwargs
+class InstanceConfigurationBlockVolumeReplicaDetails(object):
+    """
+    Contains the details for the block volume replica
+    """
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new InstanceConfigurationBlockVolumeReplicaDetails object with values from keyword arguments.
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param display_name:
+            The value to assign to the display_name property of this InstanceConfigurationBlockVolumeReplicaDetails.
+        :type display_name: str
+
+        :param availability_domain:
+            The value to assign to the availability_domain property of this InstanceConfigurationBlockVolumeReplicaDetails.
+        :type availability_domain: str
+
+        """
+        self.swagger_types = {
+            'display_name': 'str',
+            'availability_domain': 'str'
+        }
+
+        self.attribute_map = {
+            'display_name': 'displayName',
+            'availability_domain': 'availabilityDomain'
+        }
+
+        self._display_name = None
+        self._availability_domain = None
+
+    @property
+    def display_name(self):
+        """
+        Gets the display_name of this InstanceConfigurationBlockVolumeReplicaDetails.
+        The display name of the block volume replica. You may optionally specify a *display name* for
+        the block volume replica, otherwise a default is provided.
+
+
+        :return: The display_name of this InstanceConfigurationBlockVolumeReplicaDetails.
+        :rtype: str
+        """
+        return self._display_name
+
+    @display_name.setter
+    def display_name(self, display_name):
+        """
+        Sets the display_name of this InstanceConfigurationBlockVolumeReplicaDetails.
+        The display name of the block volume replica. You may optionally specify a *display name* for
+        the block volume replica, otherwise a default is provided.
+
+
+        :param display_name: The display_name of this InstanceConfigurationBlockVolumeReplicaDetails.
+        :type: str
+        """
+        self._display_name = display_name
+
+    @property
+    def availability_domain(self):
+        """
+        **[Required]** Gets the availability_domain of this InstanceConfigurationBlockVolumeReplicaDetails.
+        The availability domain of the block volume replica.
+
+        Example: `Uocm:PHX-AD-1`
+
+
+        :return: The availability_domain of this InstanceConfigurationBlockVolumeReplicaDetails.
+        :rtype: str
+        """
+        return self._availability_domain
+
+    @availability_domain.setter
+    def availability_domain(self, availability_domain):
+        """
+        Sets the availability_domain of this InstanceConfigurationBlockVolumeReplicaDetails.
+        The availability domain of the block volume replica.
+
+        Example: `Uocm:PHX-AD-1`
+
+
+        :param availability_domain: The availability_domain of this InstanceConfigurationBlockVolumeReplicaDetails.
+        :type: str
+        """
+        self._availability_domain = availability_domain
+
+    def __repr__(self):
+        return formatted_flat_dict(self)
+
+    def __eq__(self, other):
+        if other is None:
+            return False
+
+        return self.__dict__ == other.__dict__
+
+    def __ne__(self, other):
+        return not self == other