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

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

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:57.617582",
-            "spec_repo_commit": "d6c22916"
+            "regenerated": "2024-05-14 14:47:45.391704",
+            "spec_repo_commit": "48746015"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-05-10 16:39:57.635288",
-            "spec_repo_commit": "d6c22916"
+            "regenerated": "2024-05-14 14:47:45.409386",
+            "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/main/java/com/datadog/api/client/v1/model/SLOOverallStatuses.java

@@ -295,7 +295,8 @@ public SLOOverallStatuses timeframe(SLOTimeframe timeframe) {
   }
 
   /**
-   * 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.
    *
    * @return timeframe
    */

src/main/java/com/datadog/api/client/v1/model/SLOResponseData.java

@@ -474,7 +474,8 @@ public SLOResponseData timeframe(SLOTimeframe timeframe) {
   }
 
   /**
-   * 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.
    *
    * @return timeframe
    */

src/main/java/com/datadog/api/client/v1/model/SLOThreshold.java

@@ -106,7 +106,8 @@ public SLOThreshold timeframe(SLOTimeframe timeframe) {
   }
 
   /**
-   * 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.
    *
    * @return timeframe
    */

src/main/java/com/datadog/api/client/v1/model/SLOTimeframe.java

@@ -18,7 +18,10 @@
 import java.util.HashSet;
 import java.util.Set;
 
-/** 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.
+ */
 @JsonSerialize(using = SLOTimeframe.SLOTimeframeSerializer.class)
 public class SLOTimeframe extends ModelEnum<String> {
 

src/main/java/com/datadog/api/client/v1/model/ServiceLevelObjective.java

@@ -451,7 +451,8 @@ public ServiceLevelObjective timeframe(SLOTimeframe timeframe) {
   }
 
   /**
-   * 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.
    *
    * @return timeframe
    */

src/main/java/com/datadog/api/client/v1/model/ServiceLevelObjectiveRequest.java

@@ -344,7 +344,8 @@ public ServiceLevelObjectiveRequest timeframe(SLOTimeframe timeframe) {
   }
 
   /**
-   * 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.
    *
    * @return timeframe
    */