Add downtime duration policy to Monitor Config Policy API spec

.generator/schemas/v2/openapi.yaml

@@ -70755,6 +70755,32 @@ components:
       required:
         - data
       type: object
+    MonitorConfigPolicyDowntimePolicy:
+      additionalProperties: false
+      description: Downtime duration attributes of a monitor configuration policy.
+      properties:
+        max_duration_ms:
+          description: The maximum allowed downtime duration, in milliseconds.
+          example: 3600000
+          format: int64
+          minimum: 1
+          type: integer
+      required:
+        - max_duration_ms
+      type: object
+    MonitorConfigPolicyDowntimePolicyCreateRequest:
+      additionalProperties: false
+      description: Downtime duration attributes of a monitor configuration policy.
+      properties:
+        max_duration_ms:
+          description: The maximum allowed downtime duration, in milliseconds.
+          example: 3600000
+          format: int64
+          minimum: 1
+          type: integer
+      required:
+        - max_duration_ms
+      type: object
     MonitorConfigPolicyEditData:
       description: A monitor configuration policy data.
       properties:
@@ -70792,10 +70818,12 @@ components:
       description: Configuration for the policy.
       oneOf:
         - $ref: '#/components/schemas/MonitorConfigPolicyTagPolicy'
+        - $ref: '#/components/schemas/MonitorConfigPolicyDowntimePolicy'
     MonitorConfigPolicyPolicyCreateRequest:
       description: Configuration for the policy.
       oneOf:
         - $ref: '#/components/schemas/MonitorConfigPolicyTagPolicyCreateRequest'
+        - $ref: '#/components/schemas/MonitorConfigPolicyDowntimePolicyCreateRequest'
     MonitorConfigPolicyResourceType:
       default: monitor-config-policy
       description: Monitor configuration policy resource type.
@@ -70824,6 +70852,7 @@ components:
           $ref: '#/components/schemas/MonitorConfigPolicyResourceType'
       type: object
     MonitorConfigPolicyTagPolicy:
+      additionalProperties: false
       description: Tag attributes of a monitor configuration policy.
       properties:
         tag_key:
@@ -70845,6 +70874,7 @@ components:
           type: array
       type: object
     MonitorConfigPolicyTagPolicyCreateRequest:
+      additionalProperties: false
       description: Tag attributes of a monitor configuration policy.
       properties:
         tag_key:
@@ -70871,13 +70901,18 @@ components:
       type: object
     MonitorConfigPolicyType:
       default: tag
-      description: The monitor configuration policy type.
+      description: |-
+        The monitor configuration policy type.
+        `tag` enforces required tags on monitors.
+        `downtime` sets a maximum downtime duration for the organization.
       enum:
         - tag
+        - downtime
       example: "tag"
       type: string
       x-enum-varnames:
         - TAG
+        - DOWNTIME
     MonitorDowntimeMatchResourceType:
       default: downtime_match
       description: Monitor Downtime Match resource type.
@@ -181032,6 +181067,16 @@ paths:
                           policy_type: tag
                         id: "00000000-0000-1234-0000-000000000000"
                         type: monitor-config-policy
+                downtime:
+                  summary: Downtime duration policy
+                  value:
+                    data:
+                      - attributes:
+                          policy:
+                            max_duration_ms: 3600000
+                          policy_type: downtime
+                        id: "00000000-0000-1234-0000-000000000000"
+                        type: monitor-config-policy
               schema:
                 $ref: '#/components/schemas/MonitorConfigPolicyListResponse'
           description: OK
@@ -181074,6 +181119,15 @@ paths:
                           - staging
                       policy_type: tag
                     type: monitor-config-policy
+              downtime:
+                summary: Downtime duration policy
+                value:
+                  data:
+                    attributes:
+                      policy:
+                        max_duration_ms: 3600000
+                      policy_type: downtime
+                    type: monitor-config-policy
             schema:
               $ref: '#/components/schemas/MonitorConfigPolicyCreateRequest'
         description: Create a monitor configuration policy request body.
@@ -181096,6 +181150,16 @@ paths:
                         policy_type: tag
                       id: "00000000-0000-1234-0000-000000000000"
                       type: monitor-config-policy
+                downtime:
+                  summary: Downtime duration policy
+                  value:
+                    data:
+                      attributes:
+                        policy:
+                          max_duration_ms: 3600000
+                        policy_type: downtime
+                      id: "00000000-0000-1234-0000-000000000000"
+                      type: monitor-config-policy
               schema:
                 $ref: '#/components/schemas/MonitorConfigPolicyResponse'
           description: OK
@@ -181192,6 +181256,16 @@ paths:
                         policy_type: tag
                       id: "00000000-0000-1234-0000-000000000000"
                       type: monitor-config-policy
+                downtime:
+                  summary: Downtime duration policy
+                  value:
+                    data:
+                      attributes:
+                        policy:
+                          max_duration_ms: 3600000
+                        policy_type: downtime
+                      id: "00000000-0000-1234-0000-000000000000"
+                      type: monitor-config-policy
               schema:
                 $ref: '#/components/schemas/MonitorConfigPolicyResponse'
           description: OK
@@ -181249,6 +181323,16 @@ paths:
                       policy_type: tag
                     id: 00000000-0000-1234-0000-000000000000
                     type: monitor-config-policy
+              downtime:
+                summary: Downtime duration policy
+                value:
+                  data:
+                    attributes:
+                      policy:
+                        max_duration_ms: 3600000
+                      policy_type: downtime
+                    id: 00000000-0000-1234-0000-000000000000
+                    type: monitor-config-policy
             schema:
               $ref: '#/components/schemas/MonitorConfigPolicyEditRequest'
         description: Description of the update.
@@ -181271,6 +181355,16 @@ paths:
                         policy_type: tag
                       id: "00000000-0000-1234-0000-000000000000"
                       type: monitor-config-policy
+                downtime:
+                  summary: Downtime duration policy
+                  value:
+                    data:
+                      attributes:
+                        policy:
+                          max_duration_ms: 3600000
+                        policy_type: downtime
+                      id: "00000000-0000-1234-0000-000000000000"
+                      type: monitor-config-policy
               schema:
                 $ref: '#/components/schemas/MonitorConfigPolicyResponse'
           description: OK

examples/v2/monitors/CreateMonitorConfigPolicy_1934105875.java

@@ -0,0 +1,44 @@
+// Create a downtime duration monitor configuration policy returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.MonitorsApi;
+import com.datadog.api.client.v2.model.MonitorConfigPolicyAttributeCreateRequest;
+import com.datadog.api.client.v2.model.MonitorConfigPolicyCreateData;
+import com.datadog.api.client.v2.model.MonitorConfigPolicyCreateRequest;
+import com.datadog.api.client.v2.model.MonitorConfigPolicyDowntimePolicyCreateRequest;
+import com.datadog.api.client.v2.model.MonitorConfigPolicyPolicyCreateRequest;
+import com.datadog.api.client.v2.model.MonitorConfigPolicyResourceType;
+import com.datadog.api.client.v2.model.MonitorConfigPolicyResponse;
+import com.datadog.api.client.v2.model.MonitorConfigPolicyType;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    MonitorsApi apiInstance = new MonitorsApi(defaultClient);
+
+    MonitorConfigPolicyCreateRequest body =
+        new MonitorConfigPolicyCreateRequest()
+            .data(
+                new MonitorConfigPolicyCreateData()
+                    .attributes(
+                        new MonitorConfigPolicyAttributeCreateRequest()
+                            .policyType(MonitorConfigPolicyType.DOWNTIME)
+                            .policy(
+                                new MonitorConfigPolicyPolicyCreateRequest(
+                                    new MonitorConfigPolicyDowntimePolicyCreateRequest()
+                                        .maxDurationMs(3600000L))))
+                    .type(MonitorConfigPolicyResourceType.MONITOR_CONFIG_POLICY));
+
+    try {
+      MonitorConfigPolicyResponse result = apiInstance.createMonitorConfigPolicy(body);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling MonitorsApi#createMonitorConfigPolicy");
+      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/v2/model/MonitorConfigPolicyAttributeCreateRequest.java

@@ -78,7 +78,8 @@ public MonitorConfigPolicyAttributeCreateRequest policyType(MonitorConfigPolicyT
   }
 
   /**
-   * The monitor configuration policy type.
+   * The monitor configuration policy type. <code>tag</code> enforces required tags on monitors.
+   * <code>downtime</code> sets a maximum downtime duration for the organization.
    *
    * @return policyType
    */

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

@@ -76,7 +76,8 @@ public MonitorConfigPolicyAttributeEditRequest policyType(MonitorConfigPolicyTyp
   }
 
   /**
-   * The monitor configuration policy type.
+   * The monitor configuration policy type. <code>tag</code> enforces required tags on monitors.
+   * <code>downtime</code> sets a maximum downtime duration for the organization.
    *
    * @return policyType
    */

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

@@ -63,7 +63,8 @@ public MonitorConfigPolicyAttributeResponse policyType(MonitorConfigPolicyType p
   }
 
   /**
-   * The monitor configuration policy type.
+   * The monitor configuration policy type. <code>tag</code> enforces required tags on monitors.
+   * <code>downtime</code> sets a maximum downtime duration for the organization.
    *
    * @return policyType
    */

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

@@ -0,0 +1,90 @@
+/*
+ * 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.fasterxml.jackson.annotation.JsonCreator;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyOrder;
+import java.util.Objects;
+
+/** Downtime duration attributes of a monitor configuration policy. */
+@JsonPropertyOrder({MonitorConfigPolicyDowntimePolicy.JSON_PROPERTY_MAX_DURATION_MS})
+@jakarta.annotation.Generated(
+    value = "https://github.com/DataDog/datadog-api-client-java/blob/master/.generator")
+public class MonitorConfigPolicyDowntimePolicy {
+  @JsonIgnore public boolean unparsed = false;
+  public static final String JSON_PROPERTY_MAX_DURATION_MS = "max_duration_ms";
+  private Long maxDurationMs;
+
+  public MonitorConfigPolicyDowntimePolicy() {}
+
+  @JsonCreator
+  public MonitorConfigPolicyDowntimePolicy(
+      @JsonProperty(required = true, value = JSON_PROPERTY_MAX_DURATION_MS) Long maxDurationMs) {
+    this.maxDurationMs = maxDurationMs;
+  }
+
+  public MonitorConfigPolicyDowntimePolicy maxDurationMs(Long maxDurationMs) {
+    this.maxDurationMs = maxDurationMs;
+    return this;
+  }
+
+  /**
+   * The maximum allowed downtime duration, in milliseconds. minimum: 1
+   *
+   * @return maxDurationMs
+   */
+  @JsonProperty(JSON_PROPERTY_MAX_DURATION_MS)
+  @JsonInclude(value = JsonInclude.Include.ALWAYS)
+  public Long getMaxDurationMs() {
+    return maxDurationMs;
+  }
+
+  public void setMaxDurationMs(Long maxDurationMs) {
+    this.maxDurationMs = maxDurationMs;
+  }
+
+  /** Return true if this MonitorConfigPolicyDowntimePolicy object is equal to o. */
+  @Override
+  public boolean equals(Object o) {
+    if (this == o) {
+      return true;
+    }
+    if (o == null || getClass() != o.getClass()) {
+      return false;
+    }
+    MonitorConfigPolicyDowntimePolicy monitorConfigPolicyDowntimePolicy =
+        (MonitorConfigPolicyDowntimePolicy) o;
+    return Objects.equals(this.maxDurationMs, monitorConfigPolicyDowntimePolicy.maxDurationMs);
+  }
+
+  @Override
+  public int hashCode() {
+    return Objects.hash(maxDurationMs);
+  }
+
+  @Override
+  public String toString() {
+    StringBuilder sb = new StringBuilder();
+    sb.append("class MonitorConfigPolicyDowntimePolicy {\n");
+    sb.append("    maxDurationMs: ").append(toIndentedString(maxDurationMs)).append("\n");
+    sb.append('}');
+    return sb.toString();
+  }
+
+  /**
+   * Convert the given object to string with each line indented by 4 spaces (except the first line).
+   */
+  private String toIndentedString(Object o) {
+    if (o == null) {
+      return "null";
+    }
+    return o.toString().replace("\n", "\n    ");
+  }
+}