Regenerate client from commit 09cb5b9 of spec repo (#3944)

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

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

.generator/schemas/v1/openapi.yaml

@@ -1443,6 +1443,10 @@ components:
           format: date-time
           readOnly: true
           type: string
+        default_timeframe:
+          $ref: "#/components/schemas/DashboardDefaultTimeframeSetting"
+          description: The default timeframe applied when opening the dashboard. Set to `null` to clear.
+          nullable: true
         description:
           description: Description of the dashboard.
           nullable: true
@@ -1557,13 +1561,48 @@ components:
       required:
         - data
       type: object
+    DashboardDefaultTimeframeSetting:
+      description: The default timeframe applied when opening the dashboard. Set to `null` to clear the dashboard's default timeframe.
+      oneOf:
+        - $ref: "#/components/schemas/DashboardLiveTimeframe"
+        - $ref: "#/components/schemas/DashboardFixedTimeframe"
     DashboardDeleteResponse:
       description: Response from the delete dashboard call.
       properties:
         deleted_dashboard_id:
           description: ID of the deleted dashboard.
           type: string
       type: object
+    DashboardFixedTimeframe:
+      description: A fixed dashboard timeframe.
+      properties:
+        from:
+          description: Start time in milliseconds since epoch.
+          example: 1712080128000
+          format: int64
+          minimum: 0
+          type: integer
+        to:
+          description: End time in milliseconds since epoch.
+          example: 1712083128000
+          format: int64
+          minimum: 0
+          type: integer
+        type:
+          $ref: "#/components/schemas/DashboardFixedTimeframeType"
+      required:
+        - type
+        - from
+        - to
+      type: object
+    DashboardFixedTimeframeType:
+      description: Type of fixed timeframe.
+      enum:
+        - fixed
+      example: fixed
+      type: string
+      x-enum-varnames:
+        - FIXED
     DashboardGlobalTime:
       description: Object containing the live span selection for the dashboard.
       properties:
@@ -1672,6 +1711,32 @@ components:
             $ref: "#/components/schemas/DashboardList"
           type: array
       type: object
+    DashboardLiveTimeframe:
+      description: A live dashboard timeframe.
+      properties:
+        type:
+          $ref: "#/components/schemas/DashboardLiveTimeframeType"
+        unit:
+          $ref: "#/components/schemas/WidgetLiveSpanUnit"
+        value:
+          description: Value of the live timeframe span.
+          example: 4
+          format: int64
+          minimum: 1
+          type: integer
+      required:
+        - type
+        - value
+        - unit
+      type: object
+    DashboardLiveTimeframeType:
+      description: Type of live timeframe.
+      enum:
+        - live
+      example: live
+      type: string
+      x-enum-varnames:
+        - LIVE
     DashboardReflowType:
       description: |-
         Reflow type for a **new dashboard layout** dashboard. Set this only when layout type is 'ordered'.

examples/v1/dashboards/CreateDashboard_4032568083.java

@@ -0,0 +1,61 @@
+// Create a new dashboard with a live default_timeframe returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v1.api.DashboardsApi;
+import com.datadog.api.client.v1.model.Dashboard;
+import com.datadog.api.client.v1.model.DashboardDefaultTimeframeSetting;
+import com.datadog.api.client.v1.model.DashboardLayoutType;
+import com.datadog.api.client.v1.model.DashboardLiveTimeframe;
+import com.datadog.api.client.v1.model.DashboardLiveTimeframeType;
+import com.datadog.api.client.v1.model.NoteWidgetDefinition;
+import com.datadog.api.client.v1.model.NoteWidgetDefinitionType;
+import com.datadog.api.client.v1.model.Widget;
+import com.datadog.api.client.v1.model.WidgetDefinition;
+import com.datadog.api.client.v1.model.WidgetLiveSpanUnit;
+import com.datadog.api.client.v1.model.WidgetTextAlign;
+import com.datadog.api.client.v1.model.WidgetTickEdge;
+import java.util.Collections;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    DashboardsApi apiInstance = new DashboardsApi(defaultClient);
+
+    Dashboard body =
+        new Dashboard()
+            .title("Example-Dashboard")
+            .layoutType(DashboardLayoutType.ORDERED)
+            .widgets(
+                Collections.singletonList(
+                    new Widget()
+                        .definition(
+                            new WidgetDefinition(
+                                new NoteWidgetDefinition()
+                                    .type(NoteWidgetDefinitionType.NOTE)
+                                    .content("test")
+                                    .backgroundColor("white")
+                                    .fontSize("14")
+                                    .textAlign(WidgetTextAlign.LEFT)
+                                    .showTick(false)
+                                    .tickPos("50%")
+                                    .tickEdge(WidgetTickEdge.LEFT)))))
+            .defaultTimeframe(
+                new DashboardDefaultTimeframeSetting(
+                    new DashboardLiveTimeframe()
+                        .type(DashboardLiveTimeframeType.LIVE)
+                        .unit(WidgetLiveSpanUnit.HOUR)
+                        .value(4L)));
+
+    try {
+      Dashboard result = apiInstance.createDashboard(body);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling DashboardsApi#createDashboard");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

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

@@ -29,6 +29,7 @@
   Dashboard.JSON_PROPERTY_AUTHOR_HANDLE,
   Dashboard.JSON_PROPERTY_AUTHOR_NAME,
   Dashboard.JSON_PROPERTY_CREATED_AT,
+  Dashboard.JSON_PROPERTY_DEFAULT_TIMEFRAME,
   Dashboard.JSON_PROPERTY_DESCRIPTION,
   Dashboard.JSON_PROPERTY_ID,
   Dashboard.JSON_PROPERTY_IS_READ_ONLY,
@@ -58,6 +59,9 @@ public class Dashboard {
   public static final String JSON_PROPERTY_CREATED_AT = "created_at";
   private OffsetDateTime createdAt;
 
+  public static final String JSON_PROPERTY_DEFAULT_TIMEFRAME = "default_timeframe";
+  private DashboardDefaultTimeframeSetting defaultTimeframe;
+
   public static final String JSON_PROPERTY_DESCRIPTION = "description";
   private JsonNullable<String> description = JsonNullable.<String>undefined();
 
@@ -172,6 +176,32 @@ public OffsetDateTime getCreatedAt() {
     return createdAt;
   }
 
+  public Dashboard defaultTimeframe(DashboardDefaultTimeframeSetting defaultTimeframe) {
+    this.defaultTimeframe = defaultTimeframe;
+    this.unparsed |= defaultTimeframe.unparsed;
+    return this;
+  }
+
+  /**
+   * The default timeframe applied when opening the dashboard. Set to <code>null</code> to clear the
+   * dashboard's default timeframe.
+   *
+   * @return defaultTimeframe
+   */
+  @jakarta.annotation.Nullable
+  @JsonProperty(JSON_PROPERTY_DEFAULT_TIMEFRAME)
+  @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+  public DashboardDefaultTimeframeSetting getDefaultTimeframe() {
+    return defaultTimeframe;
+  }
+
+  public void setDefaultTimeframe(DashboardDefaultTimeframeSetting defaultTimeframe) {
+    this.defaultTimeframe = defaultTimeframe;
+    if (defaultTimeframe != null) {
+      this.unparsed |= defaultTimeframe.unparsed;
+    }
+  }
+
   public Dashboard description(String description) {
     this.description = JsonNullable.<String>of(description);
     return this;
@@ -686,6 +716,7 @@ public boolean equals(Object o) {
     return Objects.equals(this.authorHandle, dashboard.authorHandle)
         && Objects.equals(this.authorName, dashboard.authorName)
         && Objects.equals(this.createdAt, dashboard.createdAt)
+        && Objects.equals(this.defaultTimeframe, dashboard.defaultTimeframe)
         && Objects.equals(this.description, dashboard.description)
         && Objects.equals(this.id, dashboard.id)
         && Objects.equals(this.isReadOnly, dashboard.isReadOnly)
@@ -710,6 +741,7 @@ public int hashCode() {
         authorHandle,
         authorName,
         createdAt,
+        defaultTimeframe,
         description,
         id,
         isReadOnly,
@@ -735,6 +767,7 @@ public String toString() {
     sb.append("    authorHandle: ").append(toIndentedString(authorHandle)).append("\n");
     sb.append("    authorName: ").append(toIndentedString(authorName)).append("\n");
     sb.append("    createdAt: ").append(toIndentedString(createdAt)).append("\n");
+    sb.append("    defaultTimeframe: ").append(toIndentedString(defaultTimeframe)).append("\n");
     sb.append("    description: ").append(toIndentedString(description)).append("\n");
     sb.append("    id: ").append(toIndentedString(id)).append("\n");
     sb.append("    isReadOnly: ").append(toIndentedString(isReadOnly)).append("\n");