SLO-3314: Update docs for SLO timeframe values (#1964)

Co-authored-by: ci.datadog-api-spec <[email protected]>

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

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-05-10 16:39:45.913034",
-            "spec_repo_commit": "d6c22916"
+            "regenerated": "2024-05-14 14:47:49.021323",
+            "spec_repo_commit": "48746015"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-05-10 16:39:45.942353",
-            "spec_repo_commit": "d6c22916"
+            "regenerated": "2024-05-14 14:47:49.038170",
+            "spec_repo_commit": "48746015"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -11498,7 +11498,10 @@ components:
       - time_slice
       type: object
     SLOTimeframe:
-      description: The SLO time window options.
+      description: 'The SLO time window options. Note that "custom" is not a valid
+        option for creating
+
+        or updating SLOs. It is only used when querying SLO history over custom timeframes.'
       enum:
       - 7d
       - 30d

src/datadog_api_client/v1/model/service_level_objective.py

@@ -172,7 +172,8 @@ def __init__(
             objective object.
         :type thresholds: [SLOThreshold]
 
-        :param timeframe: The SLO time window options.
+        :param timeframe: The SLO time window options. Note that "custom" is not a valid option for creating
+            or updating SLOs. It is only used when querying SLO history over custom timeframes.
         :type timeframe: SLOTimeframe, optional
 
         :param type: The type of the service level objective.

src/datadog_api_client/v1/model/service_level_objective_request.py

@@ -123,7 +123,8 @@ def __init__(
             objective object.
         :type thresholds: [SLOThreshold]
 
-        :param timeframe: The SLO time window options.
+        :param timeframe: The SLO time window options. Note that "custom" is not a valid option for creating
+            or updating SLOs. It is only used when querying SLO history over custom timeframes.
         :type timeframe: SLOTimeframe, optional
 
         :param type: The type of the service level objective.

src/datadog_api_client/v1/model/slo_overall_statuses.py

@@ -92,7 +92,8 @@ def __init__(
         :param target: The target of the SLO.
         :type target: float, optional
 
-        :param timeframe: The SLO time window options.
+        :param timeframe: The SLO time window options. Note that "custom" is not a valid option for creating
+            or updating SLOs. It is only used when querying SLO history over custom timeframes.
         :type timeframe: SLOTimeframe, optional
         """
         if error is not unset:

src/datadog_api_client/v1/model/slo_response_data.py

@@ -178,7 +178,8 @@ def __init__(
             objective object.
         :type thresholds: [SLOThreshold], optional
 
-        :param timeframe: The SLO time window options.
+        :param timeframe: The SLO time window options. Note that "custom" is not a valid option for creating
+            or updating SLOs. It is only used when querying SLO history over custom timeframes.
         :type timeframe: SLOTimeframe, optional
 
         :param type: The type of the service level objective.

src/datadog_api_client/v1/model/slo_threshold.py

@@ -61,7 +61,8 @@ def __init__(
             create/update requests.
         :type target_display: str, optional
 
-        :param timeframe: The SLO time window options.
+        :param timeframe: The SLO time window options. Note that "custom" is not a valid option for creating
+            or updating SLOs. It is only used when querying SLO history over custom timeframes.
         :type timeframe: SLOTimeframe
 
         :param warning: The warning value for the service level objective.

src/datadog_api_client/v1/model/slo_timeframe.py

@@ -14,7 +14,8 @@
 
 class SLOTimeframe(ModelSimple):
     """
-    The SLO time window options.
+    The SLO time window options. Note that "custom" is not a valid option for creating
+        or updating SLOs. It is only used when querying SLO history over custom timeframes.
 
     :param value: Must be one of ["7d", "30d", "90d", "custom"].
     :type value: str