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

oci/bds/models/batching_based_patching_configs.py

@@ -0,0 +1,144 @@
+# coding: utf-8
+# Copyright (c) 2016, 2024, 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.
+
+# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20190531
+
+from .patching_configs import PatchingConfigs
+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 BatchingBasedPatchingConfigs(PatchingConfigs):
+    """
+    Patching configurations which allows patch the nodes batch by batch.
+    """
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new BatchingBasedPatchingConfigs object with values from keyword arguments. The default value of the :py:attr:`~oci.bds.models.BatchingBasedPatchingConfigs.patching_config_strategy` attribute
+        of this class is ``BATCHING_BASED`` and it should not be changed.
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param patching_config_strategy:
+            The value to assign to the patching_config_strategy property of this BatchingBasedPatchingConfigs.
+            Allowed values for this property are: "DOWNTIME_BASED", "BATCHING_BASED"
+        :type patching_config_strategy: str
+
+        :param batch_size:
+            The value to assign to the batch_size property of this BatchingBasedPatchingConfigs.
+        :type batch_size: int
+
+        :param wait_time_between_batch_in_seconds:
+            The value to assign to the wait_time_between_batch_in_seconds property of this BatchingBasedPatchingConfigs.
+        :type wait_time_between_batch_in_seconds: int
+
+        :param tolerance_threshold_per_batch:
+            The value to assign to the tolerance_threshold_per_batch property of this BatchingBasedPatchingConfigs.
+        :type tolerance_threshold_per_batch: int
+
+        """
+        self.swagger_types = {
+            'patching_config_strategy': 'str',
+            'batch_size': 'int',
+            'wait_time_between_batch_in_seconds': 'int',
+            'tolerance_threshold_per_batch': 'int'
+        }
+
+        self.attribute_map = {
+            'patching_config_strategy': 'patchingConfigStrategy',
+            'batch_size': 'batchSize',
+            'wait_time_between_batch_in_seconds': 'waitTimeBetweenBatchInSeconds',
+            'tolerance_threshold_per_batch': 'toleranceThresholdPerBatch'
+        }
+
+        self._patching_config_strategy = None
+        self._batch_size = None
+        self._wait_time_between_batch_in_seconds = None
+        self._tolerance_threshold_per_batch = None
+        self._patching_config_strategy = 'BATCHING_BASED'
+
+    @property
+    def batch_size(self):
+        """
+        **[Required]** Gets the batch_size of this BatchingBasedPatchingConfigs.
+        How many nodes to be patched and rebooted in each iteration.
+
+
+        :return: The batch_size of this BatchingBasedPatchingConfigs.
+        :rtype: int
+        """
+        return self._batch_size
+
+    @batch_size.setter
+    def batch_size(self, batch_size):
+        """
+        Sets the batch_size of this BatchingBasedPatchingConfigs.
+        How many nodes to be patched and rebooted in each iteration.
+
+
+        :param batch_size: The batch_size of this BatchingBasedPatchingConfigs.
+        :type: int
+        """
+        self._batch_size = batch_size
+
+    @property
+    def wait_time_between_batch_in_seconds(self):
+        """
+        **[Required]** Gets the wait_time_between_batch_in_seconds of this BatchingBasedPatchingConfigs.
+        The wait time between batches in seconds.
+
+
+        :return: The wait_time_between_batch_in_seconds of this BatchingBasedPatchingConfigs.
+        :rtype: int
+        """
+        return self._wait_time_between_batch_in_seconds
+
+    @wait_time_between_batch_in_seconds.setter
+    def wait_time_between_batch_in_seconds(self, wait_time_between_batch_in_seconds):
+        """
+        Sets the wait_time_between_batch_in_seconds of this BatchingBasedPatchingConfigs.
+        The wait time between batches in seconds.
+
+
+        :param wait_time_between_batch_in_seconds: The wait_time_between_batch_in_seconds of this BatchingBasedPatchingConfigs.
+        :type: int
+        """
+        self._wait_time_between_batch_in_seconds = wait_time_between_batch_in_seconds
+
+    @property
+    def tolerance_threshold_per_batch(self):
+        """
+        **[Required]** Gets the tolerance_threshold_per_batch of this BatchingBasedPatchingConfigs.
+        Acceptable number of failed-to-be-patched nodes in each batch. The maximum number of failed-to-patch nodes cannot exceed 20% of the number of nodes.
+
+
+        :return: The tolerance_threshold_per_batch of this BatchingBasedPatchingConfigs.
+        :rtype: int
+        """
+        return self._tolerance_threshold_per_batch
+
+    @tolerance_threshold_per_batch.setter
+    def tolerance_threshold_per_batch(self, tolerance_threshold_per_batch):
+        """
+        Sets the tolerance_threshold_per_batch of this BatchingBasedPatchingConfigs.
+        Acceptable number of failed-to-be-patched nodes in each batch. The maximum number of failed-to-patch nodes cannot exceed 20% of the number of nodes.
+
+
+        :param tolerance_threshold_per_batch: The tolerance_threshold_per_batch of this BatchingBasedPatchingConfigs.
+        :type: int
+        """
+        self._tolerance_threshold_per_batch = tolerance_threshold_per_batch
+
+    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

oci/bds/models/downtime_based_patching_configs.py

@@ -0,0 +1,51 @@
+# coding: utf-8
+# Copyright (c) 2016, 2024, 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.
+
+# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20190531
+
+from .patching_configs import PatchingConfigs
+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 DowntimeBasedPatchingConfigs(PatchingConfigs):
+    """
+    Patching configurations which allows downtime. This patching config will patch and reboot all the nodes in parallel.
+    """
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new DowntimeBasedPatchingConfigs object with values from keyword arguments. The default value of the :py:attr:`~oci.bds.models.DowntimeBasedPatchingConfigs.patching_config_strategy` attribute
+        of this class is ``DOWNTIME_BASED`` and it should not be changed.
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param patching_config_strategy:
+            The value to assign to the patching_config_strategy property of this DowntimeBasedPatchingConfigs.
+            Allowed values for this property are: "DOWNTIME_BASED", "BATCHING_BASED"
+        :type patching_config_strategy: str
+
+        """
+        self.swagger_types = {
+            'patching_config_strategy': 'str'
+        }
+
+        self.attribute_map = {
+            'patching_config_strategy': 'patchingConfigStrategy'
+        }
+
+        self._patching_config_strategy = None
+        self._patching_config_strategy = 'DOWNTIME_BASED'
+
+    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

oci/bds/models/install_os_patch_details.py

@@ -28,19 +28,26 @@ class InstallOsPatchDetails(object):
             The value to assign to the cluster_admin_password property of this InstallOsPatchDetails.
         :type cluster_admin_password: str
 
+        :param patching_configs:
+            The value to assign to the patching_configs property of this InstallOsPatchDetails.
+        :type patching_configs: oci.bds.models.PatchingConfigs
+
         """
         self.swagger_types = {
             'os_patch_version': 'str',
-            'cluster_admin_password': 'str'
+            'cluster_admin_password': 'str',
+            'patching_configs': 'PatchingConfigs'
         }
 
         self.attribute_map = {
             'os_patch_version': 'osPatchVersion',
-            'cluster_admin_password': 'clusterAdminPassword'
+            'cluster_admin_password': 'clusterAdminPassword',
+            'patching_configs': 'patchingConfigs'
         }
 
         self._os_patch_version = None
         self._cluster_admin_password = None
+        self._patching_configs = None
 
     @property
     def os_patch_version(self):
@@ -90,6 +97,26 @@ class InstallOsPatchDetails(object):
         """
         self._cluster_admin_password = cluster_admin_password
 
+    @property
+    def patching_configs(self):
+        """
+        Gets the patching_configs of this InstallOsPatchDetails.
+
+        :return: The patching_configs of this InstallOsPatchDetails.
+        :rtype: oci.bds.models.PatchingConfigs
+        """
+        return self._patching_configs
+
+    @patching_configs.setter
+    def patching_configs(self, patching_configs):
+        """
+        Sets the patching_configs of this InstallOsPatchDetails.
+
+        :param patching_configs: The patching_configs of this InstallOsPatchDetails.
+        :type: oci.bds.models.PatchingConfigs
+        """
+        self._patching_configs = patching_configs
+
     def __repr__(self):
         return formatted_flat_dict(self)
 

oci/bds/models/node.py

@@ -176,6 +176,14 @@ class Node(object):
             The value to assign to the time_maintenance_reboot_due property of this Node.
         :type time_maintenance_reboot_due: datetime
 
+        :param os_version:
+            The value to assign to the os_version property of this Node.
+        :type os_version: str
+
+        :param is_reboot_required:
+            The value to assign to the is_reboot_required property of this Node.
+        :type is_reboot_required: bool
+
         """
         self.swagger_types = {
             'instance_id': 'str',
@@ -197,7 +205,9 @@ class Node(object):
             'memory_in_gbs': 'int',
             'nvmes': 'int',
             'local_disks_total_size_in_gbs': 'float',
-            'time_maintenance_reboot_due': 'datetime'
+            'time_maintenance_reboot_due': 'datetime',
+            'os_version': 'str',
+            'is_reboot_required': 'bool'
         }
 
         self.attribute_map = {
@@ -220,7 +230,9 @@ class Node(object):
             'memory_in_gbs': 'memoryInGBs',
             'nvmes': 'nvmes',
             'local_disks_total_size_in_gbs': 'localDisksTotalSizeInGBs',
-            'time_maintenance_reboot_due': 'timeMaintenanceRebootDue'
+            'time_maintenance_reboot_due': 'timeMaintenanceRebootDue',
+            'os_version': 'osVersion',
+            'is_reboot_required': 'isRebootRequired'
         }
 
         self._instance_id = None
@@ -243,6 +255,8 @@ class Node(object):
         self._nvmes = None
         self._local_disks_total_size_in_gbs = None
         self._time_maintenance_reboot_due = None
+        self._os_version = None
+        self._is_reboot_required = None
 
     @property
     def instance_id(self):
@@ -736,6 +750,54 @@ class Node(object):
         """
         self._time_maintenance_reboot_due = time_maintenance_reboot_due
 
+    @property
+    def os_version(self):
+        """
+        Gets the os_version of this Node.
+        BDS-assigned Operating System version for the node.
+
+
+        :return: The os_version of this Node.
+        :rtype: str
+        """
+        return self._os_version
+
+    @os_version.setter
+    def os_version(self, os_version):
+        """
+        Sets the os_version of this Node.
+        BDS-assigned Operating System version for the node.
+
+
+        :param os_version: The os_version of this Node.
+        :type: str
+        """
+        self._os_version = os_version
+
+    @property
+    def is_reboot_required(self):
+        """
+        Gets the is_reboot_required of this Node.
+        Indicates if the node requires a reboot to either reflect the latest os kernel or take actions for maintenance reboot.
+
+
+        :return: The is_reboot_required of this Node.
+        :rtype: bool
+        """
+        return self._is_reboot_required
+
+    @is_reboot_required.setter
+    def is_reboot_required(self, is_reboot_required):
+        """
+        Sets the is_reboot_required of this Node.
+        Indicates if the node requires a reboot to either reflect the latest os kernel or take actions for maintenance reboot.
+
+
+        :param is_reboot_required: The is_reboot_required of this Node.
+        :type: bool
+        """
+        self._is_reboot_required = is_reboot_required
+
     def __repr__(self):
         return formatted_flat_dict(self)
 

oci/bds/models/patching_configs.py

@@ -0,0 +1,109 @@
+# coding: utf-8
+# Copyright (c) 2016, 2024, 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.
+
+# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20190531
+
+
+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 PatchingConfigs(object):
+    """
+    Detailed configurations for defining the behavior when installing os patches. If not provided, nodes will be patched and rebooted AD/FD by AD/FD.
+    """
+
+    #: A constant which can be used with the patching_config_strategy property of a PatchingConfigs.
+    #: This constant has a value of "DOWNTIME_BASED"
+    PATCHING_CONFIG_STRATEGY_DOWNTIME_BASED = "DOWNTIME_BASED"
+
+    #: A constant which can be used with the patching_config_strategy property of a PatchingConfigs.
+    #: This constant has a value of "BATCHING_BASED"
+    PATCHING_CONFIG_STRATEGY_BATCHING_BASED = "BATCHING_BASED"
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new PatchingConfigs object with values from keyword arguments. This class has the following subclasses and if you are using this class as input
+        to a service operations then you should favor using a subclass over the base class:
+
+        * :class:`~oci.bds.models.BatchingBasedPatchingConfigs`
+        * :class:`~oci.bds.models.DowntimeBasedPatchingConfigs`
+
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param patching_config_strategy:
+            The value to assign to the patching_config_strategy property of this PatchingConfigs.
+            Allowed values for this property are: "DOWNTIME_BASED", "BATCHING_BASED"
+        :type patching_config_strategy: str
+
+        """
+        self.swagger_types = {
+            'patching_config_strategy': 'str'
+        }
+
+        self.attribute_map = {
+            'patching_config_strategy': 'patchingConfigStrategy'
+        }
+
+        self._patching_config_strategy = None
+
+    @staticmethod
+    def get_subtype(object_dictionary):
+        """
+        Given the hash representation of a subtype of this class,
+        use the info in the hash to return the class of the subtype.
+        """
+        type = object_dictionary['patchingConfigStrategy']
+
+        if type == 'BATCHING_BASED':
+            return 'BatchingBasedPatchingConfigs'
+
+        if type == 'DOWNTIME_BASED':
+            return 'DowntimeBasedPatchingConfigs'
+        else:
+            return 'PatchingConfigs'
+
+    @property
+    def patching_config_strategy(self):
+        """
+        **[Required]** Gets the patching_config_strategy of this PatchingConfigs.
+        Type of strategy used for detailed patching configuration
+
+        Allowed values for this property are: "DOWNTIME_BASED", "BATCHING_BASED"
+
+
+        :return: The patching_config_strategy of this PatchingConfigs.
+        :rtype: str
+        """
+        return self._patching_config_strategy
+
+    @patching_config_strategy.setter
+    def patching_config_strategy(self, patching_config_strategy):
+        """
+        Sets the patching_config_strategy of this PatchingConfigs.
+        Type of strategy used for detailed patching configuration
+
+
+        :param patching_config_strategy: The patching_config_strategy of this PatchingConfigs.
+        :type: str
+        """
+        allowed_values = ["DOWNTIME_BASED", "BATCHING_BASED"]
+        if not value_allowed_none_or_none_sentinel(patching_config_strategy, allowed_values):
+            raise ValueError(
+                f"Invalid value for `patching_config_strategy`, must be None or one of {allowed_values}"
+            )
+        self._patching_config_strategy = patching_config_strategy
+
+    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

oci/bds/models/work_request_error.py

@@ -53,7 +53,7 @@ class WorkRequestError(object):
     def code(self):
         """
         **[Required]** Gets the code of this WorkRequestError.
-        A machine-usable code for the error that occured. Error codes are listed on (https://docs.oracle.com/en-us/iaas/Content/API/References/apierrors.htm).
+        A machine-usable code for the error that occurred. Error codes are listed on (https://docs.oracle.com/en-us/iaas/Content/API/References/apierrors.htm).
 
 
         :return: The code of this WorkRequestError.
@@ -65,7 +65,7 @@ class WorkRequestError(object):
     def code(self, code):
         """
         Sets the code of this WorkRequestError.
-        A machine-usable code for the error that occured. Error codes are listed on (https://docs.oracle.com/en-us/iaas/Content/API/References/apierrors.htm).
+        A machine-usable code for the error that occurred. Error codes are listed on (https://docs.oracle.com/en-us/iaas/Content/API/References/apierrors.htm).
 
 
         :param code: The code of this WorkRequestError.
@@ -101,7 +101,7 @@ class WorkRequestError(object):
     def timestamp(self):
         """
         **[Required]** Gets the timestamp of this WorkRequestError.
-        The time the error occured, shown as an RFC 3339 formatted datetime string.
+        The time the error occurred, shown as an RFC 3339 formatted datetime string.
 
 
         :return: The timestamp of this WorkRequestError.
@@ -113,7 +113,7 @@ class WorkRequestError(object):
     def timestamp(self, timestamp):
         """
         Sets the timestamp of this WorkRequestError.
-        The time the error occured, shown as an RFC 3339 formatted datetime string.
+        The time the error occurred, shown as an RFC 3339 formatted datetime string.
 
 
         :param timestamp: The timestamp of this WorkRequestError.