Add Team Connection API Documentation

examples/v2/team-connections/CreateTeamConnections.java

@@ -0,0 +1,63 @@
+// Create team connections returns "Created" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.TeamConnectionsApi;
+import com.datadog.api.client.v2.model.ConnectedTeamRef;
+import com.datadog.api.client.v2.model.ConnectedTeamRefData;
+import com.datadog.api.client.v2.model.ConnectedTeamRefDataType;
+import com.datadog.api.client.v2.model.TeamConnectionAttributes;
+import com.datadog.api.client.v2.model.TeamConnectionCreateData;
+import com.datadog.api.client.v2.model.TeamConnectionCreateRequest;
+import com.datadog.api.client.v2.model.TeamConnectionRelationships;
+import com.datadog.api.client.v2.model.TeamConnectionType;
+import com.datadog.api.client.v2.model.TeamConnectionsResponse;
+import com.datadog.api.client.v2.model.TeamRef;
+import com.datadog.api.client.v2.model.TeamRefData;
+import com.datadog.api.client.v2.model.TeamRefDataType;
+import java.util.Collections;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setUnstableOperationEnabled("v2.createTeamConnections", true);
+    TeamConnectionsApi apiInstance = new TeamConnectionsApi(defaultClient);
+
+    // there is a valid "dd_team" in the system
+    String DD_TEAM_DATA_ID = System.getenv("DD_TEAM_DATA_ID");
+
+    TeamConnectionCreateRequest body =
+        new TeamConnectionCreateRequest()
+            .data(
+                Collections.singletonList(
+                    new TeamConnectionCreateData()
+                        .type(TeamConnectionType.TEAM_CONNECTION)
+                        .attributes(
+                            new TeamConnectionAttributes().source("github").managedBy("datadog"))
+                        .relationships(
+                            new TeamConnectionRelationships()
+                                .team(
+                                    new TeamRef()
+                                        .data(
+                                            new TeamRefData()
+                                                .id(DD_TEAM_DATA_ID)
+                                                .type(TeamRefDataType.TEAM)))
+                                .connectedTeam(
+                                    new ConnectedTeamRef()
+                                        .data(
+                                            new ConnectedTeamRefData()
+                                                .id("@MyGitHubAccount/my-team-name")
+                                                .type(ConnectedTeamRefDataType.GITHUB_TEAM))))));
+
+    try {
+      TeamConnectionsResponse result = apiInstance.createTeamConnections(body);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling TeamConnectionsApi#createTeamConnections");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/team-connections/DeleteTeamConnections.java

@@ -0,0 +1,35 @@
+// Delete team connections returns "No Content" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.TeamConnectionsApi;
+import com.datadog.api.client.v2.model.TeamConnectionDeleteRequest;
+import com.datadog.api.client.v2.model.TeamConnectionDeleteRequestDataItem;
+import com.datadog.api.client.v2.model.TeamConnectionType;
+import java.util.Collections;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setUnstableOperationEnabled("v2.deleteTeamConnections", true);
+    TeamConnectionsApi apiInstance = new TeamConnectionsApi(defaultClient);
+
+    TeamConnectionDeleteRequest body =
+        new TeamConnectionDeleteRequest()
+            .data(
+                Collections.singletonList(
+                    new TeamConnectionDeleteRequestDataItem()
+                        .id("12345678-1234-5678-9abc-123456789012")
+                        .type(TeamConnectionType.TEAM_CONNECTION)));
+
+    try {
+      apiInstance.deleteTeamConnections(body);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling TeamConnectionsApi#deleteTeamConnections");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/team-connections/ListTeamConnections.java

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

examples/v2/team-connections/ListTeamConnections_1473516764.java

@@ -0,0 +1,31 @@
+// List team connections with filters returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.TeamConnectionsApi;
+import com.datadog.api.client.v2.api.TeamConnectionsApi.ListTeamConnectionsOptionalParameters;
+import com.datadog.api.client.v2.model.TeamConnectionsResponse;
+import java.util.Collections;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setUnstableOperationEnabled("v2.listTeamConnections", true);
+    TeamConnectionsApi apiInstance = new TeamConnectionsApi(defaultClient);
+
+    try {
+      TeamConnectionsResponse result =
+          apiInstance.listTeamConnections(
+              new ListTeamConnectionsOptionalParameters()
+                  .filterSources(Collections.singletonList("github"))
+                  .pageSize(10L));
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling TeamConnectionsApi#listTeamConnections");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/team-connections/ListTeamConnections_2418873869.java

@@ -0,0 +1,27 @@
+// List team connections returns "OK" response with pagination
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.PaginationIterable;
+import com.datadog.api.client.v2.api.TeamConnectionsApi;
+import com.datadog.api.client.v2.model.TeamConnection;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setUnstableOperationEnabled("v2.listTeamConnections", true);
+    TeamConnectionsApi apiInstance = new TeamConnectionsApi(defaultClient);
+
+    try {
+      PaginationIterable<TeamConnection> iterable = apiInstance.listTeamConnectionsWithPagination();
+
+      for (TeamConnection item : iterable) {
+        System.out.println(item);
+      }
+    } catch (RuntimeException e) {
+      System.err.println(
+          "Exception when calling TeamConnectionsApi#listTeamConnectionsWithPagination");
+      System.err.println("Reason: " + e.getMessage());
+      e.printStackTrace();
+    }
+  }
+}

src/main/java/com/datadog/api/client/ApiClient.java

@@ -815,6 +815,9 @@ public class ApiClient {
           put("v2.listMemberTeams", false);
           put("v2.removeMemberTeam", false);
           put("v2.syncTeams", false);
+          put("v2.createTeamConnections", false);
+          put("v2.deleteTeamConnections", false);
+          put("v2.listTeamConnections", false);
           put("v2.createIncidentTeam", false);
           put("v2.deleteIncidentTeam", false);
           put("v2.getIncidentTeam", false);