Update Synthetics downtime spec for gate write ops on default-settings and add monthly weekday positions (#3847)

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

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

.generator/schemas/v2/openapi.yaml

@@ -75136,6 +75136,8 @@ components:
           example: 1
           format: int64
           type: integer
+        weekdayPositions:
+          $ref: "#/components/schemas/SyntheticsDowntimeWeekdayPositions"
         weekdays:
           $ref: "#/components/schemas/SyntheticsDowntimeWeekdays"
       required:
@@ -75153,6 +75155,8 @@ components:
           type: integer
         until:
           $ref: "#/components/schemas/SyntheticsDowntimeTimeSlotDate"
+        weekdayPositions:
+          $ref: "#/components/schemas/SyntheticsDowntimeWeekdayPositions"
         weekdays:
           $ref: "#/components/schemas/SyntheticsDowntimeWeekdays"
       required:
@@ -75264,6 +75268,32 @@ components:
         - FRIDAY
         - SATURDAY
         - SUNDAY
+    SyntheticsDowntimeWeekdayPosition:
+      description: >-
+        The position of a weekday within a month for a monthly Synthetics downtime recurrence. `1` through `4` select the first through fourth occurrence of the weekday in the month, and `-1` selects the last occurrence.
+      enum:
+        - 1
+        - 2
+        - 3
+        - 4
+        - -1
+      example: 1
+      format: int64
+      type: integer
+      x-enum-varnames:
+        - FIRST
+        - SECOND
+        - THIRD
+        - FOURTH
+        - LAST
+    SyntheticsDowntimeWeekdayPositions:
+      description: >-
+        Positions of the weekdays within a month for a monthly Synthetics downtime recurrence. Used in combination with `weekdays` to schedule occurrences such as "the first Monday of the month".
+      example:
+        - 1
+      items:
+        $ref: "#/components/schemas/SyntheticsDowntimeWeekdayPosition"
+      type: array
     SyntheticsDowntimeWeekdays:
       description: Days of the week for a Synthetics downtime recurrence schedule.
       example:
@@ -143381,6 +143411,7 @@ paths:
         operator: AND
         permissions:
           - synthetics_write
+          - synthetics_default_settings_write
   /api/v2/synthetics/downtimes/{downtime_id}:
     delete:
       description: Delete a Synthetics downtime by its ID.
@@ -143423,6 +143454,7 @@ paths:
         operator: AND
         permissions:
           - synthetics_write
+          - synthetics_default_settings_write
     get:
       description: Get a Synthetics downtime by its ID.
       operationId: GetSyntheticsDowntime
@@ -143596,6 +143628,7 @@ paths:
         operator: AND
         permissions:
           - synthetics_write
+          - synthetics_default_settings_write
   /api/v2/synthetics/downtimes/{downtime_id}/tests/{test_id}:
     delete:
       description: Disassociate a Synthetics test from a downtime.

src/main/java/com/datadog/api/client/v2/model/SyntheticsDowntimeTimeSlotRecurrenceRequest.java

@@ -24,6 +24,7 @@
   SyntheticsDowntimeTimeSlotRecurrenceRequest.JSON_PROPERTY_END,
   SyntheticsDowntimeTimeSlotRecurrenceRequest.JSON_PROPERTY_FREQUENCY,
   SyntheticsDowntimeTimeSlotRecurrenceRequest.JSON_PROPERTY_INTERVAL,
+  SyntheticsDowntimeTimeSlotRecurrenceRequest.JSON_PROPERTY_WEEKDAY_POSITIONS,
   SyntheticsDowntimeTimeSlotRecurrenceRequest.JSON_PROPERTY_WEEKDAYS
 })
 @jakarta.annotation.Generated(
@@ -39,6 +40,9 @@ public class SyntheticsDowntimeTimeSlotRecurrenceRequest {
   public static final String JSON_PROPERTY_INTERVAL = "interval";
   private Long interval;
 
+  public static final String JSON_PROPERTY_WEEKDAY_POSITIONS = "weekdayPositions";
+  private List<SyntheticsDowntimeWeekdayPosition> weekdayPositions = null;
+
   public static final String JSON_PROPERTY_WEEKDAYS = "weekdays";
   private List<SyntheticsDowntimeWeekday> weekdays = null;
 
@@ -120,6 +124,40 @@ public void setInterval(Long interval) {
     this.interval = interval;
   }
 
+  public SyntheticsDowntimeTimeSlotRecurrenceRequest weekdayPositions(
+      List<SyntheticsDowntimeWeekdayPosition> weekdayPositions) {
+    this.weekdayPositions = weekdayPositions;
+    return this;
+  }
+
+  public SyntheticsDowntimeTimeSlotRecurrenceRequest addWeekdayPositionsItem(
+      SyntheticsDowntimeWeekdayPosition weekdayPositionsItem) {
+    if (this.weekdayPositions == null) {
+      this.weekdayPositions = new ArrayList<>();
+    }
+    this.weekdayPositions.add(weekdayPositionsItem);
+    this.unparsed |= !weekdayPositionsItem.isValid();
+    return this;
+  }
+
+  /**
+   * Positions of the weekdays within a month for a monthly Synthetics downtime recurrence. Used in
+   * combination with <code>weekdays</code> to schedule occurrences such as "the first Monday of the
+   * month".
+   *
+   * @return weekdayPositions
+   */
+  @jakarta.annotation.Nullable
+  @JsonProperty(JSON_PROPERTY_WEEKDAY_POSITIONS)
+  @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+  public List<SyntheticsDowntimeWeekdayPosition> getWeekdayPositions() {
+    return weekdayPositions;
+  }
+
+  public void setWeekdayPositions(List<SyntheticsDowntimeWeekdayPosition> weekdayPositions) {
+    this.weekdayPositions = weekdayPositions;
+  }
+
   public SyntheticsDowntimeTimeSlotRecurrenceRequest weekdays(
       List<SyntheticsDowntimeWeekday> weekdays) {
     this.weekdays = weekdays;
@@ -213,6 +251,8 @@ public boolean equals(Object o) {
     return Objects.equals(this.end, syntheticsDowntimeTimeSlotRecurrenceRequest.end)
         && Objects.equals(this.frequency, syntheticsDowntimeTimeSlotRecurrenceRequest.frequency)
         && Objects.equals(this.interval, syntheticsDowntimeTimeSlotRecurrenceRequest.interval)
+        && Objects.equals(
+            this.weekdayPositions, syntheticsDowntimeTimeSlotRecurrenceRequest.weekdayPositions)
         && Objects.equals(this.weekdays, syntheticsDowntimeTimeSlotRecurrenceRequest.weekdays)
         && Objects.equals(
             this.additionalProperties,
@@ -221,7 +261,7 @@ public boolean equals(Object o) {
 
   @Override
   public int hashCode() {
-    return Objects.hash(end, frequency, interval, weekdays, additionalProperties);
+    return Objects.hash(end, frequency, interval, weekdayPositions, weekdays, additionalProperties);
   }
 
   @Override
@@ -231,6 +271,7 @@ public String toString() {
     sb.append("    end: ").append(toIndentedString(end)).append("\n");
     sb.append("    frequency: ").append(toIndentedString(frequency)).append("\n");
     sb.append("    interval: ").append(toIndentedString(interval)).append("\n");
+    sb.append("    weekdayPositions: ").append(toIndentedString(weekdayPositions)).append("\n");
     sb.append("    weekdays: ").append(toIndentedString(weekdays)).append("\n");
     sb.append("    additionalProperties: ")
         .append(toIndentedString(additionalProperties))

src/main/java/com/datadog/api/client/v2/model/SyntheticsDowntimeTimeSlotRecurrenceResponse.java

@@ -24,6 +24,7 @@
   SyntheticsDowntimeTimeSlotRecurrenceResponse.JSON_PROPERTY_FREQUENCY,
   SyntheticsDowntimeTimeSlotRecurrenceResponse.JSON_PROPERTY_INTERVAL,
   SyntheticsDowntimeTimeSlotRecurrenceResponse.JSON_PROPERTY_UNTIL,
+  SyntheticsDowntimeTimeSlotRecurrenceResponse.JSON_PROPERTY_WEEKDAY_POSITIONS,
   SyntheticsDowntimeTimeSlotRecurrenceResponse.JSON_PROPERTY_WEEKDAYS
 })
 @jakarta.annotation.Generated(
@@ -39,6 +40,9 @@ public class SyntheticsDowntimeTimeSlotRecurrenceResponse {
   public static final String JSON_PROPERTY_UNTIL = "until";
   private SyntheticsDowntimeTimeSlotDate until;
 
+  public static final String JSON_PROPERTY_WEEKDAY_POSITIONS = "weekdayPositions";
+  private List<SyntheticsDowntimeWeekdayPosition> weekdayPositions = null;
+
   public static final String JSON_PROPERTY_WEEKDAYS = "weekdays";
   private List<SyntheticsDowntimeWeekday> weekdays = new ArrayList<>();
 
@@ -124,6 +128,40 @@ public void setUntil(SyntheticsDowntimeTimeSlotDate until) {
     this.until = until;
   }
 
+  public SyntheticsDowntimeTimeSlotRecurrenceResponse weekdayPositions(
+      List<SyntheticsDowntimeWeekdayPosition> weekdayPositions) {
+    this.weekdayPositions = weekdayPositions;
+    return this;
+  }
+
+  public SyntheticsDowntimeTimeSlotRecurrenceResponse addWeekdayPositionsItem(
+      SyntheticsDowntimeWeekdayPosition weekdayPositionsItem) {
+    if (this.weekdayPositions == null) {
+      this.weekdayPositions = new ArrayList<>();
+    }
+    this.weekdayPositions.add(weekdayPositionsItem);
+    this.unparsed |= !weekdayPositionsItem.isValid();
+    return this;
+  }
+
+  /**
+   * Positions of the weekdays within a month for a monthly Synthetics downtime recurrence. Used in
+   * combination with <code>weekdays</code> to schedule occurrences such as "the first Monday of the
+   * month".
+   *
+   * @return weekdayPositions
+   */
+  @jakarta.annotation.Nullable
+  @JsonProperty(JSON_PROPERTY_WEEKDAY_POSITIONS)
+  @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+  public List<SyntheticsDowntimeWeekdayPosition> getWeekdayPositions() {
+    return weekdayPositions;
+  }
+
+  public void setWeekdayPositions(List<SyntheticsDowntimeWeekdayPosition> weekdayPositions) {
+    this.weekdayPositions = weekdayPositions;
+  }
+
   public SyntheticsDowntimeTimeSlotRecurrenceResponse weekdays(
       List<SyntheticsDowntimeWeekday> weekdays) {
     this.weekdays = weekdays;
@@ -213,6 +251,8 @@ public boolean equals(Object o) {
     return Objects.equals(this.frequency, syntheticsDowntimeTimeSlotRecurrenceResponse.frequency)
         && Objects.equals(this.interval, syntheticsDowntimeTimeSlotRecurrenceResponse.interval)
         && Objects.equals(this.until, syntheticsDowntimeTimeSlotRecurrenceResponse.until)
+        && Objects.equals(
+            this.weekdayPositions, syntheticsDowntimeTimeSlotRecurrenceResponse.weekdayPositions)
         && Objects.equals(this.weekdays, syntheticsDowntimeTimeSlotRecurrenceResponse.weekdays)
         && Objects.equals(
             this.additionalProperties,
@@ -221,7 +261,8 @@ public boolean equals(Object o) {
 
   @Override
   public int hashCode() {
-    return Objects.hash(frequency, interval, until, weekdays, additionalProperties);
+    return Objects.hash(
+        frequency, interval, until, weekdayPositions, weekdays, additionalProperties);
   }
 
   @Override
@@ -231,6 +272,7 @@ public String toString() {
     sb.append("    frequency: ").append(toIndentedString(frequency)).append("\n");
     sb.append("    interval: ").append(toIndentedString(interval)).append("\n");
     sb.append("    until: ").append(toIndentedString(until)).append("\n");
+    sb.append("    weekdayPositions: ").append(toIndentedString(weekdayPositions)).append("\n");
     sb.append("    weekdays: ").append(toIndentedString(weekdays)).append("\n");
     sb.append("    additionalProperties: ")
         .append(toIndentedString(additionalProperties))

src/main/java/com/datadog/api/client/v2/model/SyntheticsDowntimeWeekdayPosition.java

@@ -0,0 +1,70 @@
+/*
+ * 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.
+ */
+
+package com.datadog.api.client.v2.model;
+
+import com.datadog.api.client.ModelEnum;
+import com.fasterxml.jackson.annotation.JsonCreator;
+import com.fasterxml.jackson.core.JsonGenerator;
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.databind.SerializerProvider;
+import com.fasterxml.jackson.databind.annotation.JsonSerialize;
+import com.fasterxml.jackson.databind.ser.std.StdSerializer;
+import java.io.IOException;
+import java.util.Arrays;
+import java.util.HashSet;
+import java.util.Set;
+
+/**
+ * The position of a weekday within a month for a monthly Synthetics downtime recurrence. <code>1
+ * </code> through <code>4</code> select the first through fourth occurrence of the weekday in the
+ * month, and <code>-1</code> selects the last occurrence.
+ */
+@JsonSerialize(
+    using = SyntheticsDowntimeWeekdayPosition.SyntheticsDowntimeWeekdayPositionSerializer.class)
+public class SyntheticsDowntimeWeekdayPosition extends ModelEnum<Long> {
+
+  private static final Set<Long> allowedValues =
+      new HashSet<Long>(Arrays.asList(1l, 2l, 3l, 4l, -1l));
+
+  public static final SyntheticsDowntimeWeekdayPosition FIRST =
+      new SyntheticsDowntimeWeekdayPosition(1l);
+  public static final SyntheticsDowntimeWeekdayPosition SECOND =
+      new SyntheticsDowntimeWeekdayPosition(2l);
+  public static final SyntheticsDowntimeWeekdayPosition THIRD =
+      new SyntheticsDowntimeWeekdayPosition(3l);
+  public static final SyntheticsDowntimeWeekdayPosition FOURTH =
+      new SyntheticsDowntimeWeekdayPosition(4l);
+  public static final SyntheticsDowntimeWeekdayPosition LAST =
+      new SyntheticsDowntimeWeekdayPosition(-1l);
+
+  SyntheticsDowntimeWeekdayPosition(Long value) {
+    super(value, allowedValues);
+  }
+
+  public static class SyntheticsDowntimeWeekdayPositionSerializer
+      extends StdSerializer<SyntheticsDowntimeWeekdayPosition> {
+    public SyntheticsDowntimeWeekdayPositionSerializer(Class<SyntheticsDowntimeWeekdayPosition> t) {
+      super(t);
+    }
+
+    public SyntheticsDowntimeWeekdayPositionSerializer() {
+      this(null);
+    }
+
+    @Override
+    public void serialize(
+        SyntheticsDowntimeWeekdayPosition value, JsonGenerator jgen, SerializerProvider provider)
+        throws IOException, JsonProcessingException {
+      jgen.writeObject(value.value);
+    }
+  }
+
+  @JsonCreator
+  public static SyntheticsDowntimeWeekdayPosition fromValue(Long value) {
+    return new SyntheticsDowntimeWeekdayPosition(value);
+  }
+}