oci 2.145.0__py3-none-any.whl → 2.146.0__py3-none-any.whl

oci/dblm/db_life_cycle_management_client_composite_operations.py

@@ -0,0 +1,65 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, 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: 20240102
+
+import oci  # noqa: F401
+from oci.util import WAIT_RESOURCE_NOT_FOUND  # noqa: F401
+
+
+class DbLifeCycleManagementClientCompositeOperations(object):
+    """
+    This class provides a wrapper around :py:class:`~oci.dblm.DbLifeCycleManagementClient` and offers convenience methods
+    for operations that would otherwise need to be chained together. For example, instead of performing an action
+    on a resource (e.g. launching an instance, creating a load balancer) and then using a waiter to wait for the resource
+    to enter a given state, you can call a single method in this class to accomplish the same functionality
+    """
+
+    def __init__(self, client, **kwargs):
+        """
+        Creates a new DbLifeCycleManagementClientCompositeOperations object
+
+        :param DbLifeCycleManagementClient client:
+            The service client which will be wrapped by this object
+        """
+        self.client = client
+
+    def create_vulnerability_scan_and_wait_for_state(self, create_vulnerability_scan_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}):
+        """
+        Calls :py:func:`~oci.dblm.DbLifeCycleManagementClient.create_vulnerability_scan` and waits for the :py:class:`~oci.dblm.models.WorkRequest`
+        to enter the given state(s).
+
+        :param oci.dblm.models.CreateVulnerabilityScanDetails create_vulnerability_scan_details: (required)
+            Details for the new VulnerabilityScan.
+
+        :param list[str] wait_for_states:
+            An array of states to wait on. These should be valid values for :py:attr:`~oci.dblm.models.WorkRequest.status`
+
+        :param dict operation_kwargs:
+            A dictionary of keyword arguments to pass to :py:func:`~oci.dblm.DbLifeCycleManagementClient.create_vulnerability_scan`
+
+        :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.create_vulnerability_scan(create_vulnerability_scan_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)

oci/dblm/models/__init__.py

@@ -0,0 +1,70 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, 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: 20240102
+
+from __future__ import absolute_import
+
+from .aggregated_vulnerability_collection import AggregatedVulnerabilityCollection
+from .aggregated_vulnerability_summary import AggregatedVulnerabilitySummary
+from .child_pdb import ChildPdb
+from .create_vulnerability_scan_details import CreateVulnerabilityScanDetails
+from .dblm_vulnerability import DblmVulnerability
+from .host_info import HostInfo
+from .metric_error import MetricError
+from .notification_collection import NotificationCollection
+from .notification_summary import NotificationSummary
+from .patch_recommendation_summary import PatchRecommendationSummary
+from .patch_recommendations_details_summary import PatchRecommendationsDetailsSummary
+from .resource_info import ResourceInfo
+from .resource_summary import ResourceSummary
+from .vulnerabilities_summary import VulnerabilitiesSummary
+from .vulnerability_collection import VulnerabilityCollection
+from .vulnerability_resource_collection import VulnerabilityResourceCollection
+from .vulnerability_resource_summary import VulnerabilityResourceSummary
+from .vulnerability_scan import VulnerabilityScan
+from .vulnerability_scan_collection import VulnerabilityScanCollection
+from .vulnerability_scan_summary import VulnerabilityScanSummary
+from .vulnerability_summary import VulnerabilitySummary
+from .work_request import WorkRequest
+from .work_request_error import WorkRequestError
+from .work_request_error_collection import WorkRequestErrorCollection
+from .work_request_log_entry import WorkRequestLogEntry
+from .work_request_log_entry_collection import WorkRequestLogEntryCollection
+from .work_request_resource import WorkRequestResource
+from .work_request_summary import WorkRequestSummary
+from .work_request_summary_collection import WorkRequestSummaryCollection
+
+# Maps type names to classes for dblm services.
+dblm_type_mapping = {
+    "AggregatedVulnerabilityCollection": AggregatedVulnerabilityCollection,
+    "AggregatedVulnerabilitySummary": AggregatedVulnerabilitySummary,
+    "ChildPdb": ChildPdb,
+    "CreateVulnerabilityScanDetails": CreateVulnerabilityScanDetails,
+    "DblmVulnerability": DblmVulnerability,
+    "HostInfo": HostInfo,
+    "MetricError": MetricError,
+    "NotificationCollection": NotificationCollection,
+    "NotificationSummary": NotificationSummary,
+    "PatchRecommendationSummary": PatchRecommendationSummary,
+    "PatchRecommendationsDetailsSummary": PatchRecommendationsDetailsSummary,
+    "ResourceInfo": ResourceInfo,
+    "ResourceSummary": ResourceSummary,
+    "VulnerabilitiesSummary": VulnerabilitiesSummary,
+    "VulnerabilityCollection": VulnerabilityCollection,
+    "VulnerabilityResourceCollection": VulnerabilityResourceCollection,
+    "VulnerabilityResourceSummary": VulnerabilityResourceSummary,
+    "VulnerabilityScan": VulnerabilityScan,
+    "VulnerabilityScanCollection": VulnerabilityScanCollection,
+    "VulnerabilityScanSummary": VulnerabilityScanSummary,
+    "VulnerabilitySummary": VulnerabilitySummary,
+    "WorkRequest": WorkRequest,
+    "WorkRequestError": WorkRequestError,
+    "WorkRequestErrorCollection": WorkRequestErrorCollection,
+    "WorkRequestLogEntry": WorkRequestLogEntry,
+    "WorkRequestLogEntryCollection": WorkRequestLogEntryCollection,
+    "WorkRequestResource": WorkRequestResource,
+    "WorkRequestSummary": WorkRequestSummary,
+    "WorkRequestSummaryCollection": WorkRequestSummaryCollection
+}

oci/dblm/models/aggregated_vulnerability_collection.py

@@ -0,0 +1,72 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, 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: 20240102
+
+
+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 AggregatedVulnerabilityCollection(object):
+    """
+    The aggregated vulnerability data.
+    """
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new AggregatedVulnerabilityCollection object with values from keyword arguments.
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param items:
+            The value to assign to the items property of this AggregatedVulnerabilityCollection.
+        :type items: list[oci.dblm.models.AggregatedVulnerabilitySummary]
+
+        """
+        self.swagger_types = {
+            'items': 'list[AggregatedVulnerabilitySummary]'
+        }
+
+        self.attribute_map = {
+            'items': 'items'
+        }
+
+        self._items = None
+
+    @property
+    def items(self):
+        """
+        **[Required]** Gets the items of this AggregatedVulnerabilityCollection.
+        List of data
+
+
+        :return: The items of this AggregatedVulnerabilityCollection.
+        :rtype: list[oci.dblm.models.AggregatedVulnerabilitySummary]
+        """
+        return self._items
+
+    @items.setter
+    def items(self, items):
+        """
+        Sets the items of this AggregatedVulnerabilityCollection.
+        List of data
+
+
+        :param items: The items of this AggregatedVulnerabilityCollection.
+        :type: list[oci.dblm.models.AggregatedVulnerabilitySummary]
+        """
+        self._items = items
+
+    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/dblm/models/aggregated_vulnerability_summary.py

@@ -0,0 +1,134 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, 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: 20240102
+
+
+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 AggregatedVulnerabilitySummary(object):
+    """
+    Singular information of an aggregated vulnerability datapoint.
+    """
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new AggregatedVulnerabilitySummary object with values from keyword arguments.
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param timestamp:
+            The value to assign to the timestamp property of this AggregatedVulnerabilitySummary.
+        :type timestamp: datetime
+
+        :param vulnerabilities_count:
+            The value to assign to the vulnerabilities_count property of this AggregatedVulnerabilitySummary.
+        :type vulnerabilities_count: int
+
+        :param registered_resources_count:
+            The value to assign to the registered_resources_count property of this AggregatedVulnerabilitySummary.
+        :type registered_resources_count: int
+
+        """
+        self.swagger_types = {
+            'timestamp': 'datetime',
+            'vulnerabilities_count': 'int',
+            'registered_resources_count': 'int'
+        }
+
+        self.attribute_map = {
+            'timestamp': 'timestamp',
+            'vulnerabilities_count': 'vulnerabilitiesCount',
+            'registered_resources_count': 'registeredResourcesCount'
+        }
+
+        self._timestamp = None
+        self._vulnerabilities_count = None
+        self._registered_resources_count = None
+
+    @property
+    def timestamp(self):
+        """
+        **[Required]** Gets the timestamp of this AggregatedVulnerabilitySummary.
+        UTC timestamp when the scan completed.
+
+
+        :return: The timestamp of this AggregatedVulnerabilitySummary.
+        :rtype: datetime
+        """
+        return self._timestamp
+
+    @timestamp.setter
+    def timestamp(self, timestamp):
+        """
+        Sets the timestamp of this AggregatedVulnerabilitySummary.
+        UTC timestamp when the scan completed.
+
+
+        :param timestamp: The timestamp of this AggregatedVulnerabilitySummary.
+        :type: datetime
+        """
+        self._timestamp = timestamp
+
+    @property
+    def vulnerabilities_count(self):
+        """
+        **[Required]** Gets the vulnerabilities_count of this AggregatedVulnerabilitySummary.
+        Unresolved vulnerabilities that were found by the scan.
+
+
+        :return: The vulnerabilities_count of this AggregatedVulnerabilitySummary.
+        :rtype: int
+        """
+        return self._vulnerabilities_count
+
+    @vulnerabilities_count.setter
+    def vulnerabilities_count(self, vulnerabilities_count):
+        """
+        Sets the vulnerabilities_count of this AggregatedVulnerabilitySummary.
+        Unresolved vulnerabilities that were found by the scan.
+
+
+        :param vulnerabilities_count: The vulnerabilities_count of this AggregatedVulnerabilitySummary.
+        :type: int
+        """
+        self._vulnerabilities_count = vulnerabilities_count
+
+    @property
+    def registered_resources_count(self):
+        """
+        **[Required]** Gets the registered_resources_count of this AggregatedVulnerabilitySummary.
+        Registered databases against which the scan ran.
+
+
+        :return: The registered_resources_count of this AggregatedVulnerabilitySummary.
+        :rtype: int
+        """
+        return self._registered_resources_count
+
+    @registered_resources_count.setter
+    def registered_resources_count(self, registered_resources_count):
+        """
+        Sets the registered_resources_count of this AggregatedVulnerabilitySummary.
+        Registered databases against which the scan ran.
+
+
+        :param registered_resources_count: The registered_resources_count of this AggregatedVulnerabilitySummary.
+        :type: int
+        """
+        self._registered_resources_count = registered_resources_count
+
+    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/dblm/models/child_pdb.py

@@ -0,0 +1,227 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, 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: 20240102
+
+
+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 ChildPdb(object):
+    """
+    Child PDB for a CDB.
+    """
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new ChildPdb object with values from keyword arguments.
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param pdb_id:
+            The value to assign to the pdb_id property of this ChildPdb.
+        :type pdb_id: str
+
+        :param name:
+            The value to assign to the name property of this ChildPdb.
+        :type name: str
+
+        :param open_mode:
+            The value to assign to the open_mode property of this ChildPdb.
+        :type open_mode: str
+
+        :param restricted:
+            The value to assign to the restricted property of this ChildPdb.
+        :type restricted: str
+
+        :param recovery_status:
+            The value to assign to the recovery_status property of this ChildPdb.
+        :type recovery_status: str
+
+        :param last_changed_by:
+            The value to assign to the last_changed_by property of this ChildPdb.
+        :type last_changed_by: str
+
+        """
+        self.swagger_types = {
+            'pdb_id': 'str',
+            'name': 'str',
+            'open_mode': 'str',
+            'restricted': 'str',
+            'recovery_status': 'str',
+            'last_changed_by': 'str'
+        }
+
+        self.attribute_map = {
+            'pdb_id': 'pdbId',
+            'name': 'name',
+            'open_mode': 'openMode',
+            'restricted': 'restricted',
+            'recovery_status': 'recoveryStatus',
+            'last_changed_by': 'lastChangedBy'
+        }
+
+        self._pdb_id = None
+        self._name = None
+        self._open_mode = None
+        self._restricted = None
+        self._recovery_status = None
+        self._last_changed_by = None
+
+    @property
+    def pdb_id(self):
+        """
+        **[Required]** Gets the pdb_id of this ChildPdb.
+        Identifier for the pluggable database.
+
+
+        :return: The pdb_id of this ChildPdb.
+        :rtype: str
+        """
+        return self._pdb_id
+
+    @pdb_id.setter
+    def pdb_id(self, pdb_id):
+        """
+        Sets the pdb_id of this ChildPdb.
+        Identifier for the pluggable database.
+
+
+        :param pdb_id: The pdb_id of this ChildPdb.
+        :type: str
+        """
+        self._pdb_id = pdb_id
+
+    @property
+    def name(self):
+        """
+        **[Required]** Gets the name of this ChildPdb.
+        Name fo the pluggable database.
+
+
+        :return: The name of this ChildPdb.
+        :rtype: str
+        """
+        return self._name
+
+    @name.setter
+    def name(self, name):
+        """
+        Sets the name of this ChildPdb.
+        Name fo the pluggable database.
+
+
+        :param name: The name of this ChildPdb.
+        :type: str
+        """
+        self._name = name
+
+    @property
+    def open_mode(self):
+        """
+        **[Required]** Gets the open_mode of this ChildPdb.
+        Open mode
+
+
+        :return: The open_mode of this ChildPdb.
+        :rtype: str
+        """
+        return self._open_mode
+
+    @open_mode.setter
+    def open_mode(self, open_mode):
+        """
+        Sets the open_mode of this ChildPdb.
+        Open mode
+
+
+        :param open_mode: The open_mode of this ChildPdb.
+        :type: str
+        """
+        self._open_mode = open_mode
+
+    @property
+    def restricted(self):
+        """
+        **[Required]** Gets the restricted of this ChildPdb.
+        Restricted
+
+
+        :return: The restricted of this ChildPdb.
+        :rtype: str
+        """
+        return self._restricted
+
+    @restricted.setter
+    def restricted(self, restricted):
+        """
+        Sets the restricted of this ChildPdb.
+        Restricted
+
+
+        :param restricted: The restricted of this ChildPdb.
+        :type: str
+        """
+        self._restricted = restricted
+
+    @property
+    def recovery_status(self):
+        """
+        **[Required]** Gets the recovery_status of this ChildPdb.
+        Recovery status
+
+
+        :return: The recovery_status of this ChildPdb.
+        :rtype: str
+        """
+        return self._recovery_status
+
+    @recovery_status.setter
+    def recovery_status(self, recovery_status):
+        """
+        Sets the recovery_status of this ChildPdb.
+        Recovery status
+
+
+        :param recovery_status: The recovery_status of this ChildPdb.
+        :type: str
+        """
+        self._recovery_status = recovery_status
+
+    @property
+    def last_changed_by(self):
+        """
+        **[Required]** Gets the last_changed_by of this ChildPdb.
+        Last changed by
+
+
+        :return: The last_changed_by of this ChildPdb.
+        :rtype: str
+        """
+        return self._last_changed_by
+
+    @last_changed_by.setter
+    def last_changed_by(self, last_changed_by):
+        """
+        Sets the last_changed_by of this ChildPdb.
+        Last changed by
+
+
+        :param last_changed_by: The last_changed_by of this ChildPdb.
+        :type: str
+        """
+        self._last_changed_by = last_changed_by
+
+    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/dblm/models/create_vulnerability_scan_details.py

@@ -0,0 +1,103 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, 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: 20240102
+
+
+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 CreateVulnerabilityScanDetails(object):
+    """
+    The data to create a VulnerabilityScan.
+    """
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new CreateVulnerabilityScanDetails object with values from keyword arguments.
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param compartment_id:
+            The value to assign to the compartment_id property of this CreateVulnerabilityScanDetails.
+        :type compartment_id: str
+
+        :param vulnerability_scan_type:
+            The value to assign to the vulnerability_scan_type property of this CreateVulnerabilityScanDetails.
+        :type vulnerability_scan_type: str
+
+        """
+        self.swagger_types = {
+            'compartment_id': 'str',
+            'vulnerability_scan_type': 'str'
+        }
+
+        self.attribute_map = {
+            'compartment_id': 'compartmentId',
+            'vulnerability_scan_type': 'vulnerabilityScanType'
+        }
+
+        self._compartment_id = None
+        self._vulnerability_scan_type = None
+
+    @property
+    def compartment_id(self):
+        """
+        **[Required]** Gets the compartment_id of this CreateVulnerabilityScanDetails.
+        Compartment Identifier
+
+
+        :return: The compartment_id of this CreateVulnerabilityScanDetails.
+        :rtype: str
+        """
+        return self._compartment_id
+
+    @compartment_id.setter
+    def compartment_id(self, compartment_id):
+        """
+        Sets the compartment_id of this CreateVulnerabilityScanDetails.
+        Compartment Identifier
+
+
+        :param compartment_id: The compartment_id of this CreateVulnerabilityScanDetails.
+        :type: str
+        """
+        self._compartment_id = compartment_id
+
+    @property
+    def vulnerability_scan_type(self):
+        """
+        **[Required]** Gets the vulnerability_scan_type of this CreateVulnerabilityScanDetails.
+        Vulnerability Scan type is CVE, PATCH or IMAGE_PATCH
+
+
+        :return: The vulnerability_scan_type of this CreateVulnerabilityScanDetails.
+        :rtype: str
+        """
+        return self._vulnerability_scan_type
+
+    @vulnerability_scan_type.setter
+    def vulnerability_scan_type(self, vulnerability_scan_type):
+        """
+        Sets the vulnerability_scan_type of this CreateVulnerabilityScanDetails.
+        Vulnerability Scan type is CVE, PATCH or IMAGE_PATCH
+
+
+        :param vulnerability_scan_type: The vulnerability_scan_type of this CreateVulnerabilityScanDetails.
+        :type: str
+        """
+        self._vulnerability_scan_type = vulnerability_scan_type
+
+    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