Add query_interval_seconds to time-slice SLO condition parameters (#1936)

Co-authored-by: ci.datadog-api-spec <[email protected]>
Co-authored-by: api-clients-generation-pipeline[bot] <54105614+api-clients-generation-pipeline[bot]@users.noreply.github.com>

Author: api-clients-generation-pipeline[bot]

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-04-02 13:17:39.250860",
-            "spec_repo_commit": "de9967cc"
+            "regenerated": "2024-04-03 15:02:14.618599",
+            "spec_repo_commit": "e8144990"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-04-02 13:17:39.275860",
-            "spec_repo_commit": "de9967cc"
+            "regenerated": "2024-04-03 15:02:14.635120",
+            "spec_repo_commit": "e8144990"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -11370,7 +11370,8 @@ components:
       description: 'The time-slice condition, composed of 3 parts: 1. the metric timeseries
         query, 2. the comparator,
 
-        and 3. the threshold.'
+        and 3. the threshold. Optionally, a fourth part, the query interval, can be
+        provided.'
       example:
         comparator: <
         query:
@@ -11389,6 +11390,8 @@ components:
           $ref: '#/components/schemas/SLOTimeSliceComparator'
         query:
           $ref: '#/components/schemas/SLOTimeSliceQuery'
+        query_interval_seconds:
+          $ref: '#/components/schemas/SLOTimeSliceInterval'
         threshold:
           description: The threshold value to which each SLI value will be compared.
           example: 5
@@ -11399,6 +11402,22 @@ components:
       - threshold
       - query
       type: object
+    SLOTimeSliceInterval:
+      description: 'The interval used when querying data, which defines the size of
+        a time slice.
+
+        Two values are allowed: 60 (1 minute) and 300 (5 minutes).
+
+        If not provided, the value defaults to 300 (5 minutes).'
+      enum:
+      - 60
+      - 300
+      example: 300
+      format: int32
+      type: integer
+      x-enum-varnames:
+      - ONE_MINUTE
+      - FIVE_MINUTES
     SLOTimeSliceQuery:
       description: The queries and formula used to calculate the SLI value.
       example:

docs/datadog_api_client.v1.model.rst

@@ -3571,6 +3571,13 @@ slo\_time\_slice\_condition
    :members:
    :show-inheritance:
 
+slo\_time\_slice\_interval
+--------------------------
+
+.. automodule:: datadog_api_client.v1.model.slo_time_slice_interval
+   :members:
+   :show-inheritance:
+
 slo\_time\_slice\_query
 -----------------------
 

src/datadog_api_client/v1/model/slo_sli_spec.py

@@ -16,7 +16,7 @@ def __init__(self, **kwargs):
         A generic SLI specification. This is currently used for time-slice SLOs only.
 
         :param time_slice: The time-slice condition, composed of 3 parts: 1. the metric timeseries query, 2. the comparator,
-            and 3. the threshold.
+            and 3. the threshold. Optionally, a fourth part, the query interval, can be provided.
         :type time_slice: SLOTimeSliceCondition
         """
         super().__init__(kwargs)

src/datadog_api_client/v1/model/slo_time_slice_condition.py

@@ -3,51 +3,71 @@
 # Copyright 2019-Present Datadog, Inc.
 from __future__ import annotations
 
-from typing import TYPE_CHECKING
+from typing import Union, TYPE_CHECKING
 
 from datadog_api_client.model_utils import (
     ModelNormal,
     cached_property,
+    unset,
+    UnsetType,
 )
 
 
 if TYPE_CHECKING:
     from datadog_api_client.v1.model.slo_time_slice_comparator import SLOTimeSliceComparator
     from datadog_api_client.v1.model.slo_time_slice_query import SLOTimeSliceQuery
+    from datadog_api_client.v1.model.slo_time_slice_interval import SLOTimeSliceInterval
 
 
 class SLOTimeSliceCondition(ModelNormal):
     @cached_property
     def openapi_types(_):
         from datadog_api_client.v1.model.slo_time_slice_comparator import SLOTimeSliceComparator
         from datadog_api_client.v1.model.slo_time_slice_query import SLOTimeSliceQuery
+        from datadog_api_client.v1.model.slo_time_slice_interval import SLOTimeSliceInterval
 
         return {
             "comparator": (SLOTimeSliceComparator,),
             "query": (SLOTimeSliceQuery,),
+            "query_interval_seconds": (SLOTimeSliceInterval,),
             "threshold": (float,),
         }
 
     attribute_map = {
         "comparator": "comparator",
         "query": "query",
+        "query_interval_seconds": "query_interval_seconds",
         "threshold": "threshold",
     }
 
-    def __init__(self_, comparator: SLOTimeSliceComparator, query: SLOTimeSliceQuery, threshold: float, **kwargs):
+    def __init__(
+        self_,
+        comparator: SLOTimeSliceComparator,
+        query: SLOTimeSliceQuery,
+        threshold: float,
+        query_interval_seconds: Union[SLOTimeSliceInterval, UnsetType] = unset,
+        **kwargs,
+    ):
         """
         The time-slice condition, composed of 3 parts: 1. the metric timeseries query, 2. the comparator,
-        and 3. the threshold.
+        and 3. the threshold. Optionally, a fourth part, the query interval, can be provided.
 
         :param comparator: The comparator used to compare the SLI value to the threshold.
         :type comparator: SLOTimeSliceComparator
 
         :param query: The queries and formula used to calculate the SLI value.
         :type query: SLOTimeSliceQuery
 
+        :param query_interval_seconds: The interval used when querying data, which defines the size of a time slice.
+            Two values are allowed: 60 (1 minute) and 300 (5 minutes).
+            If not provided, the value defaults to 300 (5 minutes).
+        :type query_interval_seconds: SLOTimeSliceInterval, optional
+
         :param threshold: The threshold value to which each SLI value will be compared.
         :type threshold: float
         """
+        if query_interval_seconds is not unset:
+            kwargs["query_interval_seconds"] = query_interval_seconds
         super().__init__(kwargs)
 
         self_.comparator = comparator

src/datadog_api_client/v1/model/slo_time_slice_interval.py

@@ -0,0 +1,40 @@
+# Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+# This product includes software developed at Datadog (https://www.datadoghq.com/).
+# Copyright 2019-Present Datadog, Inc.
+from __future__ import annotations
+
+
+from datadog_api_client.model_utils import (
+    ModelSimple,
+    cached_property,
+)
+
+from typing import ClassVar
+
+
+class SLOTimeSliceInterval(ModelSimple):
+    """
+    The interval used when querying data, which defines the size of a time slice.
+        Two values are allowed: 60 (1 minute) and 300 (5 minutes).
+        If not provided, the value defaults to 300 (5 minutes).
+
+    :param value: Must be one of [60, 300].
+    :type value: int
+    """
+
+    allowed_values = {
+        60,
+        300,
+    }
+    ONE_MINUTE: ClassVar["SLOTimeSliceInterval"]
+    FIVE_MINUTES: ClassVar["SLOTimeSliceInterval"]
+
+    @cached_property
+    def openapi_types(_):
+        return {
+            "value": (int,),
+        }
+
+
+SLOTimeSliceInterval.ONE_MINUTE = SLOTimeSliceInterval(60)
+SLOTimeSliceInterval.FIVE_MINUTES = SLOTimeSliceInterval(300)

src/datadog_api_client/v1/model/slo_time_slice_spec.py

@@ -33,7 +33,7 @@ def __init__(self_, time_slice: SLOTimeSliceCondition, **kwargs):
         A time-slice SLI specification.
 
         :param time_slice: The time-slice condition, composed of 3 parts: 1. the metric timeseries query, 2. the comparator,
-            and 3. the threshold.
+            and 3. the threshold. Optionally, a fourth part, the query interval, can be provided.
         :type time_slice: SLOTimeSliceCondition
         """
         super().__init__(kwargs)

src/datadog_api_client/v1/models/__init__.py

@@ -517,6 +517,7 @@
 from datadog_api_client.v1.model.slo_threshold import SLOThreshold
 from datadog_api_client.v1.model.slo_time_slice_comparator import SLOTimeSliceComparator
 from datadog_api_client.v1.model.slo_time_slice_condition import SLOTimeSliceCondition
+from datadog_api_client.v1.model.slo_time_slice_interval import SLOTimeSliceInterval
 from datadog_api_client.v1.model.slo_time_slice_query import SLOTimeSliceQuery
 from datadog_api_client.v1.model.slo_time_slice_spec import SLOTimeSliceSpec
 from datadog_api_client.v1.model.slo_timeframe import SLOTimeframe
@@ -1416,6 +1417,7 @@
     "SLOThreshold",
     "SLOTimeSliceComparator",
     "SLOTimeSliceCondition",
+    "SLOTimeSliceInterval",
     "SLOTimeSliceQuery",
     "SLOTimeSliceSpec",
     "SLOTimeframe",