oci 2.154.3__py3-none-any.whl → 2.155.1__py3-none-any.whl

oci/apm_traces/models/update_scheduled_query_details.py

@@ -0,0 +1,471 @@
+# 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: 20200630
+
+
+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 UpdateScheduledQueryDetails(object):
+    """
+    Object that contains the details about the scheduled query to be updated.
+    """
+
+    #: A constant which can be used with the scheduled_query_processing_type property of a UpdateScheduledQueryDetails.
+    #: This constant has a value of "EXPORT"
+    SCHEDULED_QUERY_PROCESSING_TYPE_EXPORT = "EXPORT"
+
+    #: A constant which can be used with the scheduled_query_processing_type property of a UpdateScheduledQueryDetails.
+    #: This constant has a value of "QUERY"
+    SCHEDULED_QUERY_PROCESSING_TYPE_QUERY = "QUERY"
+
+    #: A constant which can be used with the scheduled_query_processing_type property of a UpdateScheduledQueryDetails.
+    #: This constant has a value of "ALERT"
+    SCHEDULED_QUERY_PROCESSING_TYPE_ALERT = "ALERT"
+
+    #: A constant which can be used with the scheduled_query_processing_sub_type property of a UpdateScheduledQueryDetails.
+    #: This constant has a value of "OBJECT_STORAGE"
+    SCHEDULED_QUERY_PROCESSING_SUB_TYPE_OBJECT_STORAGE = "OBJECT_STORAGE"
+
+    #: A constant which can be used with the scheduled_query_processing_sub_type property of a UpdateScheduledQueryDetails.
+    #: This constant has a value of "STREAMING"
+    SCHEDULED_QUERY_PROCESSING_SUB_TYPE_STREAMING = "STREAMING"
+
+    #: A constant which can be used with the scheduled_query_processing_sub_type property of a UpdateScheduledQueryDetails.
+    #: This constant has a value of "CUSTOM_METRIC"
+    SCHEDULED_QUERY_PROCESSING_SUB_TYPE_CUSTOM_METRIC = "CUSTOM_METRIC"
+
+    #: A constant which can be used with the scheduled_query_processing_sub_type property of a UpdateScheduledQueryDetails.
+    #: This constant has a value of "NONE"
+    SCHEDULED_QUERY_PROCESSING_SUB_TYPE_NONE = "NONE"
+
+    #: A constant which can be used with the scheduled_query_retention_criteria property of a UpdateScheduledQueryDetails.
+    #: This constant has a value of "KEEP_DATA_UNTIL_RETENTION_PERIOD"
+    SCHEDULED_QUERY_RETENTION_CRITERIA_KEEP_DATA_UNTIL_RETENTION_PERIOD = "KEEP_DATA_UNTIL_RETENTION_PERIOD"
+
+    #: A constant which can be used with the scheduled_query_retention_criteria property of a UpdateScheduledQueryDetails.
+    #: This constant has a value of "UPDATE"
+    SCHEDULED_QUERY_RETENTION_CRITERIA_UPDATE = "UPDATE"
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new UpdateScheduledQueryDetails object with values from keyword arguments.
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param scheduled_query_name:
+            The value to assign to the scheduled_query_name property of this UpdateScheduledQueryDetails.
+        :type scheduled_query_name: str
+
+        :param scheduled_query_processing_type:
+            The value to assign to the scheduled_query_processing_type property of this UpdateScheduledQueryDetails.
+            Allowed values for this property are: "EXPORT", "QUERY", "ALERT"
+        :type scheduled_query_processing_type: str
+
+        :param scheduled_query_processing_sub_type:
+            The value to assign to the scheduled_query_processing_sub_type property of this UpdateScheduledQueryDetails.
+            Allowed values for this property are: "OBJECT_STORAGE", "STREAMING", "CUSTOM_METRIC", "NONE"
+        :type scheduled_query_processing_sub_type: str
+
+        :param scheduled_query_text:
+            The value to assign to the scheduled_query_text property of this UpdateScheduledQueryDetails.
+        :type scheduled_query_text: str
+
+        :param scheduled_query_schedule:
+            The value to assign to the scheduled_query_schedule property of this UpdateScheduledQueryDetails.
+        :type scheduled_query_schedule: str
+
+        :param scheduled_query_description:
+            The value to assign to the scheduled_query_description property of this UpdateScheduledQueryDetails.
+        :type scheduled_query_description: str
+
+        :param scheduled_query_maximum_runtime_in_seconds:
+            The value to assign to the scheduled_query_maximum_runtime_in_seconds property of this UpdateScheduledQueryDetails.
+        :type scheduled_query_maximum_runtime_in_seconds: int
+
+        :param scheduled_query_retention_period_in_ms:
+            The value to assign to the scheduled_query_retention_period_in_ms property of this UpdateScheduledQueryDetails.
+        :type scheduled_query_retention_period_in_ms: int
+
+        :param scheduled_query_processing_configuration:
+            The value to assign to the scheduled_query_processing_configuration property of this UpdateScheduledQueryDetails.
+        :type scheduled_query_processing_configuration: oci.apm_traces.models.ScheduledQueryProcessingConfig
+
+        :param scheduled_query_retention_criteria:
+            The value to assign to the scheduled_query_retention_criteria property of this UpdateScheduledQueryDetails.
+            Allowed values for this property are: "KEEP_DATA_UNTIL_RETENTION_PERIOD", "UPDATE"
+        :type scheduled_query_retention_criteria: str
+
+        :param freeform_tags:
+            The value to assign to the freeform_tags property of this UpdateScheduledQueryDetails.
+        :type freeform_tags: dict(str, str)
+
+        :param defined_tags:
+            The value to assign to the defined_tags property of this UpdateScheduledQueryDetails.
+        :type defined_tags: dict(str, dict(str, object))
+
+        """
+        self.swagger_types = {
+            'scheduled_query_name': 'str',
+            'scheduled_query_processing_type': 'str',
+            'scheduled_query_processing_sub_type': 'str',
+            'scheduled_query_text': 'str',
+            'scheduled_query_schedule': 'str',
+            'scheduled_query_description': 'str',
+            'scheduled_query_maximum_runtime_in_seconds': 'int',
+            'scheduled_query_retention_period_in_ms': 'int',
+            'scheduled_query_processing_configuration': 'ScheduledQueryProcessingConfig',
+            'scheduled_query_retention_criteria': 'str',
+            'freeform_tags': 'dict(str, str)',
+            'defined_tags': 'dict(str, dict(str, object))'
+        }
+        self.attribute_map = {
+            'scheduled_query_name': 'scheduledQueryName',
+            'scheduled_query_processing_type': 'scheduledQueryProcessingType',
+            'scheduled_query_processing_sub_type': 'scheduledQueryProcessingSubType',
+            'scheduled_query_text': 'scheduledQueryText',
+            'scheduled_query_schedule': 'scheduledQuerySchedule',
+            'scheduled_query_description': 'scheduledQueryDescription',
+            'scheduled_query_maximum_runtime_in_seconds': 'scheduledQueryMaximumRuntimeInSeconds',
+            'scheduled_query_retention_period_in_ms': 'scheduledQueryRetentionPeriodInMs',
+            'scheduled_query_processing_configuration': 'scheduledQueryProcessingConfiguration',
+            'scheduled_query_retention_criteria': 'scheduledQueryRetentionCriteria',
+            'freeform_tags': 'freeformTags',
+            'defined_tags': 'definedTags'
+        }
+        self._scheduled_query_name = None
+        self._scheduled_query_processing_type = None
+        self._scheduled_query_processing_sub_type = None
+        self._scheduled_query_text = None
+        self._scheduled_query_schedule = None
+        self._scheduled_query_description = None
+        self._scheduled_query_maximum_runtime_in_seconds = None
+        self._scheduled_query_retention_period_in_ms = None
+        self._scheduled_query_processing_configuration = None
+        self._scheduled_query_retention_criteria = None
+        self._freeform_tags = None
+        self._defined_tags = None
+
+    @property
+    def scheduled_query_name(self):
+        """
+        Gets the scheduled_query_name of this UpdateScheduledQueryDetails.
+        Name of the scheduled query.
+
+
+        :return: The scheduled_query_name of this UpdateScheduledQueryDetails.
+        :rtype: str
+        """
+        return self._scheduled_query_name
+
+    @scheduled_query_name.setter
+    def scheduled_query_name(self, scheduled_query_name):
+        """
+        Sets the scheduled_query_name of this UpdateScheduledQueryDetails.
+        Name of the scheduled query.
+
+
+        :param scheduled_query_name: The scheduled_query_name of this UpdateScheduledQueryDetails.
+        :type: str
+        """
+        self._scheduled_query_name = scheduled_query_name
+
+    @property
+    def scheduled_query_processing_type(self):
+        """
+        Gets the scheduled_query_processing_type of this UpdateScheduledQueryDetails.
+        Type of the scheduled query.
+
+        Allowed values for this property are: "EXPORT", "QUERY", "ALERT"
+
+
+        :return: The scheduled_query_processing_type of this UpdateScheduledQueryDetails.
+        :rtype: str
+        """
+        return self._scheduled_query_processing_type
+
+    @scheduled_query_processing_type.setter
+    def scheduled_query_processing_type(self, scheduled_query_processing_type):
+        """
+        Sets the scheduled_query_processing_type of this UpdateScheduledQueryDetails.
+        Type of the scheduled query.
+
+
+        :param scheduled_query_processing_type: The scheduled_query_processing_type of this UpdateScheduledQueryDetails.
+        :type: str
+        """
+        allowed_values = ["EXPORT", "QUERY", "ALERT"]
+        if not value_allowed_none_or_none_sentinel(scheduled_query_processing_type, allowed_values):
+            raise ValueError(
+                f"Invalid value for `scheduled_query_processing_type`, must be None or one of {allowed_values}"
+            )
+        self._scheduled_query_processing_type = scheduled_query_processing_type
+
+    @property
+    def scheduled_query_processing_sub_type(self):
+        """
+        Gets the scheduled_query_processing_sub_type of this UpdateScheduledQueryDetails.
+        Processing sub type of the scheduled query.
+
+        Allowed values for this property are: "OBJECT_STORAGE", "STREAMING", "CUSTOM_METRIC", "NONE"
+
+
+        :return: The scheduled_query_processing_sub_type of this UpdateScheduledQueryDetails.
+        :rtype: str
+        """
+        return self._scheduled_query_processing_sub_type
+
+    @scheduled_query_processing_sub_type.setter
+    def scheduled_query_processing_sub_type(self, scheduled_query_processing_sub_type):
+        """
+        Sets the scheduled_query_processing_sub_type of this UpdateScheduledQueryDetails.
+        Processing sub type of the scheduled query.
+
+
+        :param scheduled_query_processing_sub_type: The scheduled_query_processing_sub_type of this UpdateScheduledQueryDetails.
+        :type: str
+        """
+        allowed_values = ["OBJECT_STORAGE", "STREAMING", "CUSTOM_METRIC", "NONE"]
+        if not value_allowed_none_or_none_sentinel(scheduled_query_processing_sub_type, allowed_values):
+            raise ValueError(
+                f"Invalid value for `scheduled_query_processing_sub_type`, must be None or one of {allowed_values}"
+            )
+        self._scheduled_query_processing_sub_type = scheduled_query_processing_sub_type
+
+    @property
+    def scheduled_query_text(self):
+        """
+        Gets the scheduled_query_text of this UpdateScheduledQueryDetails.
+        Scheduled query to be run.
+
+
+        :return: The scheduled_query_text of this UpdateScheduledQueryDetails.
+        :rtype: str
+        """
+        return self._scheduled_query_text
+
+    @scheduled_query_text.setter
+    def scheduled_query_text(self, scheduled_query_text):
+        """
+        Sets the scheduled_query_text of this UpdateScheduledQueryDetails.
+        Scheduled query to be run.
+
+
+        :param scheduled_query_text: The scheduled_query_text of this UpdateScheduledQueryDetails.
+        :type: str
+        """
+        self._scheduled_query_text = scheduled_query_text
+
+    @property
+    def scheduled_query_schedule(self):
+        """
+        Gets the scheduled_query_schedule of this UpdateScheduledQueryDetails.
+        Schedule for the scheduled query.
+
+
+        :return: The scheduled_query_schedule of this UpdateScheduledQueryDetails.
+        :rtype: str
+        """
+        return self._scheduled_query_schedule
+
+    @scheduled_query_schedule.setter
+    def scheduled_query_schedule(self, scheduled_query_schedule):
+        """
+        Sets the scheduled_query_schedule of this UpdateScheduledQueryDetails.
+        Schedule for the scheduled query.
+
+
+        :param scheduled_query_schedule: The scheduled_query_schedule of this UpdateScheduledQueryDetails.
+        :type: str
+        """
+        self._scheduled_query_schedule = scheduled_query_schedule
+
+    @property
+    def scheduled_query_description(self):
+        """
+        Gets the scheduled_query_description of this UpdateScheduledQueryDetails.
+        Description for the scheduled query.
+
+
+        :return: The scheduled_query_description of this UpdateScheduledQueryDetails.
+        :rtype: str
+        """
+        return self._scheduled_query_description
+
+    @scheduled_query_description.setter
+    def scheduled_query_description(self, scheduled_query_description):
+        """
+        Sets the scheduled_query_description of this UpdateScheduledQueryDetails.
+        Description for the scheduled query.
+
+
+        :param scheduled_query_description: The scheduled_query_description of this UpdateScheduledQueryDetails.
+        :type: str
+        """
+        self._scheduled_query_description = scheduled_query_description
+
+    @property
+    def scheduled_query_maximum_runtime_in_seconds(self):
+        """
+        Gets the scheduled_query_maximum_runtime_in_seconds of this UpdateScheduledQueryDetails.
+        Maximum runtime for the scheduled query in seconds.
+
+
+        :return: The scheduled_query_maximum_runtime_in_seconds of this UpdateScheduledQueryDetails.
+        :rtype: int
+        """
+        return self._scheduled_query_maximum_runtime_in_seconds
+
+    @scheduled_query_maximum_runtime_in_seconds.setter
+    def scheduled_query_maximum_runtime_in_seconds(self, scheduled_query_maximum_runtime_in_seconds):
+        """
+        Sets the scheduled_query_maximum_runtime_in_seconds of this UpdateScheduledQueryDetails.
+        Maximum runtime for the scheduled query in seconds.
+
+
+        :param scheduled_query_maximum_runtime_in_seconds: The scheduled_query_maximum_runtime_in_seconds of this UpdateScheduledQueryDetails.
+        :type: int
+        """
+        self._scheduled_query_maximum_runtime_in_seconds = scheduled_query_maximum_runtime_in_seconds
+
+    @property
+    def scheduled_query_retention_period_in_ms(self):
+        """
+        Gets the scheduled_query_retention_period_in_ms of this UpdateScheduledQueryDetails.
+        Retention period for the scheduled query in milliseconds.
+
+
+        :return: The scheduled_query_retention_period_in_ms of this UpdateScheduledQueryDetails.
+        :rtype: int
+        """
+        return self._scheduled_query_retention_period_in_ms
+
+    @scheduled_query_retention_period_in_ms.setter
+    def scheduled_query_retention_period_in_ms(self, scheduled_query_retention_period_in_ms):
+        """
+        Sets the scheduled_query_retention_period_in_ms of this UpdateScheduledQueryDetails.
+        Retention period for the scheduled query in milliseconds.
+
+
+        :param scheduled_query_retention_period_in_ms: The scheduled_query_retention_period_in_ms of this UpdateScheduledQueryDetails.
+        :type: int
+        """
+        self._scheduled_query_retention_period_in_ms = scheduled_query_retention_period_in_ms
+
+    @property
+    def scheduled_query_processing_configuration(self):
+        """
+        Gets the scheduled_query_processing_configuration of this UpdateScheduledQueryDetails.
+
+        :return: The scheduled_query_processing_configuration of this UpdateScheduledQueryDetails.
+        :rtype: oci.apm_traces.models.ScheduledQueryProcessingConfig
+        """
+        return self._scheduled_query_processing_configuration
+
+    @scheduled_query_processing_configuration.setter
+    def scheduled_query_processing_configuration(self, scheduled_query_processing_configuration):
+        """
+        Sets the scheduled_query_processing_configuration of this UpdateScheduledQueryDetails.
+
+        :param scheduled_query_processing_configuration: The scheduled_query_processing_configuration of this UpdateScheduledQueryDetails.
+        :type: oci.apm_traces.models.ScheduledQueryProcessingConfig
+        """
+        self._scheduled_query_processing_configuration = scheduled_query_processing_configuration
+
+    @property
+    def scheduled_query_retention_criteria(self):
+        """
+        Gets the scheduled_query_retention_criteria of this UpdateScheduledQueryDetails.
+        Retention criteria for the scheduled query.
+
+        Allowed values for this property are: "KEEP_DATA_UNTIL_RETENTION_PERIOD", "UPDATE"
+
+
+        :return: The scheduled_query_retention_criteria of this UpdateScheduledQueryDetails.
+        :rtype: str
+        """
+        return self._scheduled_query_retention_criteria
+
+    @scheduled_query_retention_criteria.setter
+    def scheduled_query_retention_criteria(self, scheduled_query_retention_criteria):
+        """
+        Sets the scheduled_query_retention_criteria of this UpdateScheduledQueryDetails.
+        Retention criteria for the scheduled query.
+
+
+        :param scheduled_query_retention_criteria: The scheduled_query_retention_criteria of this UpdateScheduledQueryDetails.
+        :type: str
+        """
+        allowed_values = ["KEEP_DATA_UNTIL_RETENTION_PERIOD", "UPDATE"]
+        if not value_allowed_none_or_none_sentinel(scheduled_query_retention_criteria, allowed_values):
+            raise ValueError(
+                f"Invalid value for `scheduled_query_retention_criteria`, must be None or one of {allowed_values}"
+            )
+        self._scheduled_query_retention_criteria = scheduled_query_retention_criteria
+
+    @property
+    def freeform_tags(self):
+        """
+        Gets the freeform_tags of this UpdateScheduledQueryDetails.
+        Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only.
+        Example: `{\"bar-key\": \"value\"}`
+
+
+        :return: The freeform_tags of this UpdateScheduledQueryDetails.
+        :rtype: dict(str, str)
+        """
+        return self._freeform_tags
+
+    @freeform_tags.setter
+    def freeform_tags(self, freeform_tags):
+        """
+        Sets the freeform_tags of this UpdateScheduledQueryDetails.
+        Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only.
+        Example: `{\"bar-key\": \"value\"}`
+
+
+        :param freeform_tags: The freeform_tags of this UpdateScheduledQueryDetails.
+        :type: dict(str, str)
+        """
+        self._freeform_tags = freeform_tags
+
+    @property
+    def defined_tags(self):
+        """
+        Gets the defined_tags of this UpdateScheduledQueryDetails.
+        Defined tags for this resource. Each key is predefined and scoped to a namespace.
+        Example: `{\"foo-namespace\": {\"bar-key\": \"value\"}}`
+
+
+        :return: The defined_tags of this UpdateScheduledQueryDetails.
+        :rtype: dict(str, dict(str, object))
+        """
+        return self._defined_tags
+
+    @defined_tags.setter
+    def defined_tags(self, defined_tags):
+        """
+        Sets the defined_tags of this UpdateScheduledQueryDetails.
+        Defined tags for this resource. Each key is predefined and scoped to a namespace.
+        Example: `{\"foo-namespace\": {\"bar-key\": \"value\"}}`
+
+
+        :param defined_tags: The defined_tags of this UpdateScheduledQueryDetails.
+        :type: dict(str, dict(str, object))
+        """
+        self._defined_tags = defined_tags
+
+    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/apm_traces/query_client.py

@@ -152,7 +152,7 @@ class QueryClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.154.3/apmtraces/list_quick_picks.py.html>`__ to see an example of how to use list_quick_picks API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.155.1/apmtraces/list_quick_picks.py.html>`__ to see an example of how to use list_quick_picks API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['apmDomainId']
@@ -232,14 +232,16 @@ class QueryClient(object):
             The APM Domain ID for the intended request.
 
         :param datetime time_span_started_greater_than_or_equal_to: (required)
-            Include spans that have a `spanStartTime` equal to or greater than this value.
+            Include spans that have a `spanStartTime` equal to or greater than this value.  Also, include logs and traces
+            that have startTime greater than this value.
 
         :param datetime time_span_started_less_than: (required)
-            Include spans that have a `spanStartTime`less than this value.
+            Include spans that have a `spanStartTime` less than this value.  Also, include traces that have startTime less than this value
+            and logs that have endTime less than this value.
 
         :param oci.apm_traces.models.QueryDetails query_details: (required)
-            Request body containing the query to be run against the trace data and to filter and
-            retrieve trace data results.
+            Request body containing the query to be run against the trace, span, services, background queries and other metric data and to filter and
+            retrieve the results.
 
         :param str opc_request_id: (optional)
             Unique Oracle-assigned identifier for the request.  If you need to contact Oracle about a
@@ -268,7 +270,7 @@ class QueryClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.154.3/apmtraces/query.py.html>`__ to see an example of how to use query API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.155.1/apmtraces/query.py.html>`__ to see an example of how to use query API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['apmDomainId', 'timeSpanStartedGreaterThanOrEqualTo', 'timeSpanStartedLessThan']