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

oci/core/models/private_ip.py

@@ -36,7 +36,7 @@ class PrivateIp(object):
     :class:`CreateVnicDetails` when calling either
     :func:`launch_instance` or
     :func:`attach_vnic`. To update the hostname
-    for a primary private IP, you use :func:`update_vnic`.
+    for a primary private IP, you use `:func:`update_vnic``.
 
     `PrivateIp` objects that are created for use with the Oracle Cloud VMware Solution are
     assigned to a VLAN and not a VNIC in a subnet. See the

oci/core/models/update_instance_details.py

@@ -64,6 +64,10 @@ class UpdateInstanceDetails(object):
             The value to assign to the shape_config property of this UpdateInstanceDetails.
         :type shape_config: oci.core.models.UpdateInstanceShapeConfigDetails
 
+        :param source_details:
+            The value to assign to the source_details property of this UpdateInstanceDetails.
+        :type source_details: oci.core.models.UpdateInstanceSourceDetails
+
         :param update_operation_constraint:
             The value to assign to the update_operation_constraint property of this UpdateInstanceDetails.
             Allowed values for this property are: "ALLOW_DOWNTIME", "AVOID_DOWNTIME"
@@ -108,6 +112,7 @@ class UpdateInstanceDetails(object):
             'extended_metadata': 'dict(str, object)',
             'shape': 'str',
             'shape_config': 'UpdateInstanceShapeConfigDetails',
+            'source_details': 'UpdateInstanceSourceDetails',
             'update_operation_constraint': 'str',
             'instance_options': 'InstanceOptions',
             'fault_domain': 'str',
@@ -128,6 +133,7 @@ class UpdateInstanceDetails(object):
             'extended_metadata': 'extendedMetadata',
             'shape': 'shape',
             'shape_config': 'shapeConfig',
+            'source_details': 'sourceDetails',
             'update_operation_constraint': 'updateOperationConstraint',
             'instance_options': 'instanceOptions',
             'fault_domain': 'faultDomain',
@@ -147,6 +153,7 @@ class UpdateInstanceDetails(object):
         self._extended_metadata = None
         self._shape = None
         self._shape_config = None
+        self._source_details = None
         self._update_operation_constraint = None
         self._instance_options = None
         self._fault_domain = None
@@ -480,6 +487,26 @@ class UpdateInstanceDetails(object):
         """
         self._shape_config = shape_config
 
+    @property
+    def source_details(self):
+        """
+        Gets the source_details of this UpdateInstanceDetails.
+
+        :return: The source_details of this UpdateInstanceDetails.
+        :rtype: oci.core.models.UpdateInstanceSourceDetails
+        """
+        return self._source_details
+
+    @source_details.setter
+    def source_details(self, source_details):
+        """
+        Sets the source_details of this UpdateInstanceDetails.
+
+        :param source_details: The source_details of this UpdateInstanceDetails.
+        :type: oci.core.models.UpdateInstanceSourceDetails
+        """
+        self._source_details = source_details
+
     @property
     def update_operation_constraint(self):
         """

oci/core/models/update_instance_source_details.py

@@ -0,0 +1,128 @@
+# 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: 20160918
+
+
+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 UpdateInstanceSourceDetails(object):
+    """
+    The details for updating the instance source.
+    """
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new UpdateInstanceSourceDetails 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.core.models.UpdateInstanceSourceViaBootVolumeDetails`
+        * :class:`~oci.core.models.UpdateInstanceSourceViaImageDetails`
+
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param source_type:
+            The value to assign to the source_type property of this UpdateInstanceSourceDetails.
+        :type source_type: str
+
+        :param is_preserve_boot_volume_enabled:
+            The value to assign to the is_preserve_boot_volume_enabled property of this UpdateInstanceSourceDetails.
+        :type is_preserve_boot_volume_enabled: bool
+
+        """
+        self.swagger_types = {
+            'source_type': 'str',
+            'is_preserve_boot_volume_enabled': 'bool'
+        }
+
+        self.attribute_map = {
+            'source_type': 'sourceType',
+            'is_preserve_boot_volume_enabled': 'isPreserveBootVolumeEnabled'
+        }
+
+        self._source_type = None
+        self._is_preserve_boot_volume_enabled = 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['sourceType']
+
+        if type == 'bootVolume':
+            return 'UpdateInstanceSourceViaBootVolumeDetails'
+
+        if type == 'image':
+            return 'UpdateInstanceSourceViaImageDetails'
+        else:
+            return 'UpdateInstanceSourceDetails'
+
+    @property
+    def source_type(self):
+        """
+        **[Required]** Gets the source_type of this UpdateInstanceSourceDetails.
+        The source type for the instance.
+        Use `image` when specifying the image OCID. Use `bootVolume` when specifying
+        the boot volume OCID.
+
+
+        :return: The source_type of this UpdateInstanceSourceDetails.
+        :rtype: str
+        """
+        return self._source_type
+
+    @source_type.setter
+    def source_type(self, source_type):
+        """
+        Sets the source_type of this UpdateInstanceSourceDetails.
+        The source type for the instance.
+        Use `image` when specifying the image OCID. Use `bootVolume` when specifying
+        the boot volume OCID.
+
+
+        :param source_type: The source_type of this UpdateInstanceSourceDetails.
+        :type: str
+        """
+        self._source_type = source_type
+
+    @property
+    def is_preserve_boot_volume_enabled(self):
+        """
+        Gets the is_preserve_boot_volume_enabled of this UpdateInstanceSourceDetails.
+        Whether to preserve the boot volume that was previously attached to the instance after a successful replacement of that boot volume.
+
+
+        :return: The is_preserve_boot_volume_enabled of this UpdateInstanceSourceDetails.
+        :rtype: bool
+        """
+        return self._is_preserve_boot_volume_enabled
+
+    @is_preserve_boot_volume_enabled.setter
+    def is_preserve_boot_volume_enabled(self, is_preserve_boot_volume_enabled):
+        """
+        Sets the is_preserve_boot_volume_enabled of this UpdateInstanceSourceDetails.
+        Whether to preserve the boot volume that was previously attached to the instance after a successful replacement of that boot volume.
+
+
+        :param is_preserve_boot_volume_enabled: The is_preserve_boot_volume_enabled of this UpdateInstanceSourceDetails.
+        :type: bool
+        """
+        self._is_preserve_boot_volume_enabled = is_preserve_boot_volume_enabled
+
+    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/core/models/update_instance_source_via_boot_volume_details.py

@@ -0,0 +1,88 @@
+# 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: 20160918
+
+from .update_instance_source_details import UpdateInstanceSourceDetails
+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 UpdateInstanceSourceViaBootVolumeDetails(UpdateInstanceSourceDetails):
+    """
+    The details for updating the instance source from an existing boot volume.
+    """
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new UpdateInstanceSourceViaBootVolumeDetails object with values from keyword arguments. The default value of the :py:attr:`~oci.core.models.UpdateInstanceSourceViaBootVolumeDetails.source_type` attribute
+        of this class is ``bootVolume`` and it should not be changed.
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param source_type:
+            The value to assign to the source_type property of this UpdateInstanceSourceViaBootVolumeDetails.
+        :type source_type: str
+
+        :param is_preserve_boot_volume_enabled:
+            The value to assign to the is_preserve_boot_volume_enabled property of this UpdateInstanceSourceViaBootVolumeDetails.
+        :type is_preserve_boot_volume_enabled: bool
+
+        :param boot_volume_id:
+            The value to assign to the boot_volume_id property of this UpdateInstanceSourceViaBootVolumeDetails.
+        :type boot_volume_id: str
+
+        """
+        self.swagger_types = {
+            'source_type': 'str',
+            'is_preserve_boot_volume_enabled': 'bool',
+            'boot_volume_id': 'str'
+        }
+
+        self.attribute_map = {
+            'source_type': 'sourceType',
+            'is_preserve_boot_volume_enabled': 'isPreserveBootVolumeEnabled',
+            'boot_volume_id': 'bootVolumeId'
+        }
+
+        self._source_type = None
+        self._is_preserve_boot_volume_enabled = None
+        self._boot_volume_id = None
+        self._source_type = 'bootVolume'
+
+    @property
+    def boot_volume_id(self):
+        """
+        **[Required]** Gets the boot_volume_id of this UpdateInstanceSourceViaBootVolumeDetails.
+        The OCID of the boot volume used to boot the instance.
+
+
+        :return: The boot_volume_id of this UpdateInstanceSourceViaBootVolumeDetails.
+        :rtype: str
+        """
+        return self._boot_volume_id
+
+    @boot_volume_id.setter
+    def boot_volume_id(self, boot_volume_id):
+        """
+        Sets the boot_volume_id of this UpdateInstanceSourceViaBootVolumeDetails.
+        The OCID of the boot volume used to boot the instance.
+
+
+        :param boot_volume_id: The boot_volume_id of this UpdateInstanceSourceViaBootVolumeDetails.
+        :type: str
+        """
+        self._boot_volume_id = boot_volume_id
+
+    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/core/models/update_instance_source_via_image_details.py

@@ -0,0 +1,150 @@
+# 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: 20160918
+
+from .update_instance_source_details import UpdateInstanceSourceDetails
+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 UpdateInstanceSourceViaImageDetails(UpdateInstanceSourceDetails):
+    """
+    The details for updating the instance source from an image.
+    """
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new UpdateInstanceSourceViaImageDetails object with values from keyword arguments. The default value of the :py:attr:`~oci.core.models.UpdateInstanceSourceViaImageDetails.source_type` attribute
+        of this class is ``image`` and it should not be changed.
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param source_type:
+            The value to assign to the source_type property of this UpdateInstanceSourceViaImageDetails.
+        :type source_type: str
+
+        :param is_preserve_boot_volume_enabled:
+            The value to assign to the is_preserve_boot_volume_enabled property of this UpdateInstanceSourceViaImageDetails.
+        :type is_preserve_boot_volume_enabled: bool
+
+        :param boot_volume_size_in_gbs:
+            The value to assign to the boot_volume_size_in_gbs property of this UpdateInstanceSourceViaImageDetails.
+        :type boot_volume_size_in_gbs: int
+
+        :param image_id:
+            The value to assign to the image_id property of this UpdateInstanceSourceViaImageDetails.
+        :type image_id: str
+
+        :param kms_key_id:
+            The value to assign to the kms_key_id property of this UpdateInstanceSourceViaImageDetails.
+        :type kms_key_id: str
+
+        """
+        self.swagger_types = {
+            'source_type': 'str',
+            'is_preserve_boot_volume_enabled': 'bool',
+            'boot_volume_size_in_gbs': 'int',
+            'image_id': 'str',
+            'kms_key_id': 'str'
+        }
+
+        self.attribute_map = {
+            'source_type': 'sourceType',
+            'is_preserve_boot_volume_enabled': 'isPreserveBootVolumeEnabled',
+            'boot_volume_size_in_gbs': 'bootVolumeSizeInGBs',
+            'image_id': 'imageId',
+            'kms_key_id': 'kmsKeyId'
+        }
+
+        self._source_type = None
+        self._is_preserve_boot_volume_enabled = None
+        self._boot_volume_size_in_gbs = None
+        self._image_id = None
+        self._kms_key_id = None
+        self._source_type = 'image'
+
+    @property
+    def boot_volume_size_in_gbs(self):
+        """
+        Gets the boot_volume_size_in_gbs of this UpdateInstanceSourceViaImageDetails.
+        The size of the boot volume in GBs. Minimum value is 50 GB and maximum value is 32,768 GB (32 TB).
+
+
+        :return: The boot_volume_size_in_gbs of this UpdateInstanceSourceViaImageDetails.
+        :rtype: int
+        """
+        return self._boot_volume_size_in_gbs
+
+    @boot_volume_size_in_gbs.setter
+    def boot_volume_size_in_gbs(self, boot_volume_size_in_gbs):
+        """
+        Sets the boot_volume_size_in_gbs of this UpdateInstanceSourceViaImageDetails.
+        The size of the boot volume in GBs. Minimum value is 50 GB and maximum value is 32,768 GB (32 TB).
+
+
+        :param boot_volume_size_in_gbs: The boot_volume_size_in_gbs of this UpdateInstanceSourceViaImageDetails.
+        :type: int
+        """
+        self._boot_volume_size_in_gbs = boot_volume_size_in_gbs
+
+    @property
+    def image_id(self):
+        """
+        **[Required]** Gets the image_id of this UpdateInstanceSourceViaImageDetails.
+        The OCID of the image used to boot the instance.
+
+
+        :return: The image_id of this UpdateInstanceSourceViaImageDetails.
+        :rtype: str
+        """
+        return self._image_id
+
+    @image_id.setter
+    def image_id(self, image_id):
+        """
+        Sets the image_id of this UpdateInstanceSourceViaImageDetails.
+        The OCID of the image used to boot the instance.
+
+
+        :param image_id: The image_id of this UpdateInstanceSourceViaImageDetails.
+        :type: str
+        """
+        self._image_id = image_id
+
+    @property
+    def kms_key_id(self):
+        """
+        Gets the kms_key_id of this UpdateInstanceSourceViaImageDetails.
+        The OCID of the Vault service key to assign as the master encryption key for the boot volume.
+
+
+        :return: The kms_key_id of this UpdateInstanceSourceViaImageDetails.
+        :rtype: str
+        """
+        return self._kms_key_id
+
+    @kms_key_id.setter
+    def kms_key_id(self, kms_key_id):
+        """
+        Sets the kms_key_id of this UpdateInstanceSourceViaImageDetails.
+        The OCID of the Vault service key to assign as the master encryption key for the boot volume.
+
+
+        :param kms_key_id: The kms_key_id of this UpdateInstanceSourceViaImageDetails.
+        :type: str
+        """
+        self._kms_key_id = kms_key_id
+
+    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/core/models/update_vnic_details.py

@@ -174,7 +174,7 @@ class UpdateVnicDetails(object):
         Must be unique across all VNICs in the subnet and comply with
         `RFC 952`__ and
         `RFC 1123`__.
-        The value appears in the :class:`Vnic` object and also the
+        The value appears in the `:class:`Vnic`` object and also the
         :class:`PrivateIp` object returned by
         :func:`list_private_ips` and
         :func:`get_private_ip`.
@@ -202,7 +202,7 @@ class UpdateVnicDetails(object):
         Must be unique across all VNICs in the subnet and comply with
         `RFC 952`__ and
         `RFC 1123`__.
-        The value appears in the :class:`Vnic` object and also the
+        The value appears in the `:class:`Vnic`` object and also the
         :class:`PrivateIp` object returned by
         :func:`list_private_ips` and
         :func:`get_private_ip`.

oci/core/models/volume.py

@@ -102,6 +102,10 @@ class Volume(object):
             The value to assign to the vpus_per_gb property of this Volume.
         :type vpus_per_gb: int
 
+        :param cluster_placement_group_id:
+            The value to assign to the cluster_placement_group_id property of this Volume.
+        :type cluster_placement_group_id: str
+
         :param size_in_gbs:
             The value to assign to the size_in_gbs property of this Volume.
         :type size_in_gbs: int
@@ -151,6 +155,7 @@ class Volume(object):
             'kms_key_id': 'str',
             'lifecycle_state': 'str',
             'vpus_per_gb': 'int',
+            'cluster_placement_group_id': 'str',
             'size_in_gbs': 'int',
             'size_in_mbs': 'int',
             'source_details': 'VolumeSourceDetails',
@@ -174,6 +179,7 @@ class Volume(object):
             'kms_key_id': 'kmsKeyId',
             'lifecycle_state': 'lifecycleState',
             'vpus_per_gb': 'vpusPerGB',
+            'cluster_placement_group_id': 'clusterPlacementGroupId',
             'size_in_gbs': 'sizeInGBs',
             'size_in_mbs': 'sizeInMBs',
             'source_details': 'sourceDetails',
@@ -196,6 +202,7 @@ class Volume(object):
         self._kms_key_id = None
         self._lifecycle_state = None
         self._vpus_per_gb = None
+        self._cluster_placement_group_id = None
         self._size_in_gbs = None
         self._size_in_mbs = None
         self._source_details = None
@@ -536,6 +543,30 @@ class Volume(object):
         """
         self._vpus_per_gb = vpus_per_gb
 
+    @property
+    def cluster_placement_group_id(self):
+        """
+        Gets the cluster_placement_group_id of this Volume.
+        The clusterPlacementGroup Id of the volume for volume placement.
+
+
+        :return: The cluster_placement_group_id of this Volume.
+        :rtype: str
+        """
+        return self._cluster_placement_group_id
+
+    @cluster_placement_group_id.setter
+    def cluster_placement_group_id(self, cluster_placement_group_id):
+        """
+        Sets the cluster_placement_group_id of this Volume.
+        The clusterPlacementGroup Id of the volume for volume placement.
+
+
+        :param cluster_placement_group_id: The cluster_placement_group_id of this Volume.
+        :type: str
+        """
+        self._cluster_placement_group_id = cluster_placement_group_id
+
     @property
     def size_in_gbs(self):
         """