Add OpenAPI spec for event email address endpoints

examples/v2/events/CreateEventEmailAddress.java

@@ -0,0 +1,46 @@
+// Create an event email address returns "Created" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.EventsApi;
+import com.datadog.api.client.v2.model.EventEmailAddressAlertType;
+import com.datadog.api.client.v2.model.EventEmailAddressCreateAttributes;
+import com.datadog.api.client.v2.model.EventEmailAddressCreateData;
+import com.datadog.api.client.v2.model.EventEmailAddressCreateRequest;
+import com.datadog.api.client.v2.model.EventEmailAddressFormat;
+import com.datadog.api.client.v2.model.EventEmailAddressResourceType;
+import com.datadog.api.client.v2.model.EventEmailAddressSingleResponse;
+import java.util.Arrays;
+import java.util.Collections;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setUnstableOperationEnabled("v2.createEventEmailAddress", true);
+    EventsApi apiInstance = new EventsApi(defaultClient);
+
+    EventEmailAddressCreateRequest body =
+        new EventEmailAddressCreateRequest()
+            .data(
+                new EventEmailAddressCreateData()
+                    .attributes(
+                        new EventEmailAddressCreateAttributes()
+                            .alertType(EventEmailAddressAlertType.INFO)
+                            .description("Email address for production alerts.")
+                            .format(EventEmailAddressFormat.JSON)
+                            .notifyHandles(Collections.singletonList("@slack-my-channel"))
+                            .tags(Arrays.asList("env:production", "team:my-team")))
+                    .type(EventEmailAddressResourceType.EVENT_EMAILS));
+
+    try {
+      EventEmailAddressSingleResponse result = apiInstance.createEventEmailAddress(body);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling EventsApi#createEventEmailAddress");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/events/CreateOnCallEventEmailAddress.java

@@ -0,0 +1,45 @@
+// Create an on-call event email address returns "Created" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.EventsApi;
+import com.datadog.api.client.v2.model.EventEmailAddressAlertType;
+import com.datadog.api.client.v2.model.EventEmailAddressFormat;
+import com.datadog.api.client.v2.model.EventEmailAddressResourceType;
+import com.datadog.api.client.v2.model.EventEmailAddressSingleResponse;
+import com.datadog.api.client.v2.model.OnCallEventEmailAddressCreateAttributes;
+import com.datadog.api.client.v2.model.OnCallEventEmailAddressCreateData;
+import com.datadog.api.client.v2.model.OnCallEventEmailAddressCreateRequest;
+import java.util.Arrays;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setUnstableOperationEnabled("v2.createOnCallEventEmailAddress", true);
+    EventsApi apiInstance = new EventsApi(defaultClient);
+
+    OnCallEventEmailAddressCreateRequest body =
+        new OnCallEventEmailAddressCreateRequest()
+            .data(
+                new OnCallEventEmailAddressCreateData()
+                    .attributes(
+                        new OnCallEventEmailAddressCreateAttributes()
+                            .alertType(EventEmailAddressAlertType.INFO)
+                            .description("On-call email address for my team.")
+                            .format(EventEmailAddressFormat.JSON)
+                            .tags(Arrays.asList("env:production", "team:my-team"))
+                            .teamHandle("my-team"))
+                    .type(EventEmailAddressResourceType.EVENT_EMAILS));
+
+    try {
+      EventEmailAddressSingleResponse result = apiInstance.createOnCallEventEmailAddress(body);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling EventsApi#createOnCallEventEmailAddress");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/events/DeleteEventEmailAddress.java

@@ -0,0 +1,24 @@
+// Revoke an event email address returns "No Content" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.EventsApi;
+import java.util.UUID;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setUnstableOperationEnabled("v2.deleteEventEmailAddress", true);
+    EventsApi apiInstance = new EventsApi(defaultClient);
+
+    try {
+      apiInstance.deleteEventEmailAddress(UUID.fromString("00000000-0000-0000-0000-000000000001"));
+    } catch (ApiException e) {
+      System.err.println("Exception when calling EventsApi#deleteEventEmailAddress");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/events/DeleteOnCallEventEmailAddress.java

@@ -0,0 +1,25 @@
+// Revoke an on-call event email address returns "No Content" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.EventsApi;
+import java.util.UUID;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setUnstableOperationEnabled("v2.deleteOnCallEventEmailAddress", true);
+    EventsApi apiInstance = new EventsApi(defaultClient);
+
+    try {
+      apiInstance.deleteOnCallEventEmailAddress(
+          UUID.fromString("00000000-0000-0000-0000-000000000001"));
+    } catch (ApiException e) {
+      System.err.println("Exception when calling EventsApi#deleteOnCallEventEmailAddress");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/events/GetEventEmailAddress.java

@@ -0,0 +1,27 @@
+// Get an event email address returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.EventsApi;
+import com.datadog.api.client.v2.model.EventEmailAddressSingleResponse;
+import java.util.UUID;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setUnstableOperationEnabled("v2.getEventEmailAddress", true);
+    EventsApi apiInstance = new EventsApi(defaultClient);
+
+    try {
+      EventEmailAddressSingleResponse result =
+          apiInstance.getEventEmailAddress(UUID.fromString("00000000-0000-0000-0000-000000000001"));
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling EventsApi#getEventEmailAddress");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/events/ListEventEmailAddresses.java

@@ -0,0 +1,25 @@
+// List event email addresses returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.EventsApi;
+import com.datadog.api.client.v2.model.EventEmailAddressesResponse;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setUnstableOperationEnabled("v2.listEventEmailAddresses", true);
+    EventsApi apiInstance = new EventsApi(defaultClient);
+
+    try {
+      EventEmailAddressesResponse result = apiInstance.listEventEmailAddresses();
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling EventsApi#listEventEmailAddresses");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/events/ListOnCallEventEmailAddresses.java

@@ -0,0 +1,25 @@
+// List on-call event email addresses returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.EventsApi;
+import com.datadog.api.client.v2.model.EventEmailAddressesResponse;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setUnstableOperationEnabled("v2.listOnCallEventEmailAddresses", true);
+    EventsApi apiInstance = new EventsApi(defaultClient);
+
+    try {
+      EventEmailAddressesResponse result = apiInstance.listOnCallEventEmailAddresses("my-team");
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling EventsApi#listOnCallEventEmailAddresses");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/events/UpdateEventEmailAddress.java

@@ -0,0 +1,47 @@
+// Update an event email address returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.EventsApi;
+import com.datadog.api.client.v2.model.EventEmailAddressAlertType;
+import com.datadog.api.client.v2.model.EventEmailAddressResourceType;
+import com.datadog.api.client.v2.model.EventEmailAddressSingleResponse;
+import com.datadog.api.client.v2.model.EventEmailAddressUpdateAttributes;
+import com.datadog.api.client.v2.model.EventEmailAddressUpdateData;
+import com.datadog.api.client.v2.model.EventEmailAddressUpdateRequest;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.UUID;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setUnstableOperationEnabled("v2.updateEventEmailAddress", true);
+    EventsApi apiInstance = new EventsApi(defaultClient);
+
+    EventEmailAddressUpdateRequest body =
+        new EventEmailAddressUpdateRequest()
+            .data(
+                new EventEmailAddressUpdateData()
+                    .attributes(
+                        new EventEmailAddressUpdateAttributes()
+                            .alertType(EventEmailAddressAlertType.INFO)
+                            .description("Updated description for the email address.")
+                            .notifyHandles(Collections.singletonList("@slack-my-channel"))
+                            .tags(Arrays.asList("env:production", "team:my-team")))
+                    .type(EventEmailAddressResourceType.EVENT_EMAILS));
+
+    try {
+      EventEmailAddressSingleResponse result =
+          apiInstance.updateEventEmailAddress(
+              UUID.fromString("00000000-0000-0000-0000-000000000001"), body);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling EventsApi#updateEventEmailAddress");
+      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/ApiClient.java

@@ -833,6 +833,14 @@ public class ApiClient {
           put("v2.getDeploymentRule", false);
           put("v2.updateDeploymentGate", false);
           put("v2.updateDeploymentRule", false);
+          put("v2.createEventEmailAddress", false);
+          put("v2.createOnCallEventEmailAddress", false);
+          put("v2.deleteEventEmailAddress", false);
+          put("v2.deleteOnCallEventEmailAddress", false);
+          put("v2.getEventEmailAddress", false);
+          put("v2.listEventEmailAddresses", false);
+          put("v2.listOnCallEventEmailAddresses", false);
+          put("v2.updateEventEmailAddress", false);
           put("v2.createHamrOrgConnection", false);
           put("v2.getHamrOrgConnection", false);
           put("v2.createGlobalIncidentHandle", false);