Document Feature Flag updates and approvals

examples/v2/feature-flags/ApplyFlagSuggestion.java

@@ -0,0 +1,27 @@
+// Apply an approved flag change suggestion returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.FeatureFlagsApi;
+import com.datadog.api.client.v2.model.FeatureFlagSuggestionResponse;
+import java.util.UUID;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN"));
+    FeatureFlagsApi apiInstance = new FeatureFlagsApi(defaultClient);
+
+    try {
+      FeatureFlagSuggestionResponse result =
+          apiInstance.applyFlagSuggestion(UUID.fromString("550e8400-e29b-41d4-a716-446655440020"));
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling FeatureFlagsApi#applyFlagSuggestion");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/feature-flags/ApproveFlagSuggestion.java

@@ -0,0 +1,42 @@
+// Approve a flag change suggestion returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.FeatureFlagsApi;
+import com.datadog.api.client.v2.model.ApproveFlagSuggestionAttributes;
+import com.datadog.api.client.v2.model.ApproveFlagSuggestionData;
+import com.datadog.api.client.v2.model.ApproveFlagSuggestionRequest;
+import com.datadog.api.client.v2.model.FeatureFlagSuggestionResponse;
+import com.datadog.api.client.v2.model.ReviewFlagSuggestionDataType;
+import java.util.UUID;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN"));
+    FeatureFlagsApi apiInstance = new FeatureFlagsApi(defaultClient);
+
+    ApproveFlagSuggestionRequest body =
+        new ApproveFlagSuggestionRequest()
+            .data(
+                new ApproveFlagSuggestionData()
+                    .attributes(
+                        new ApproveFlagSuggestionAttributes()
+                            .apply(false)
+                            .comment("Approved for rollout."))
+                    .type(ReviewFlagSuggestionDataType.FLAG_SUGGESTION_EVENTS));
+
+    try {
+      FeatureFlagSuggestionResponse result =
+          apiInstance.approveFlagSuggestion(
+              UUID.fromString("550e8400-e29b-41d4-a716-446655440020"), body);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling FeatureFlagsApi#approveFlagSuggestion");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/feature-flags/CreateFlagSuggestion.java

@@ -0,0 +1,53 @@
+// Create a flag change suggestion returns "Created" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.FeatureFlagsApi;
+import com.datadog.api.client.v2.model.CreateFlagSuggestionAttributes;
+import com.datadog.api.client.v2.model.CreateFlagSuggestionData;
+import com.datadog.api.client.v2.model.CreateFlagSuggestionRequest;
+import com.datadog.api.client.v2.model.FeatureFlagSuggestionDataType;
+import com.datadog.api.client.v2.model.FeatureFlagSuggestionMetadataRequest;
+import com.datadog.api.client.v2.model.FeatureFlagSuggestionResponse;
+import java.util.Collections;
+import java.util.UUID;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN"));
+    FeatureFlagsApi apiInstance = new FeatureFlagsApi(defaultClient);
+
+    CreateFlagSuggestionRequest body =
+        new CreateFlagSuggestionRequest()
+            .data(
+                new CreateFlagSuggestionData()
+                    .attributes(
+                        new CreateFlagSuggestionAttributes()
+                            .action("updated")
+                            .comment("Restrict this flag to server applications.")
+                            .environmentId(UUID.fromString("550e8400-e29b-41d4-a716-446655440001"))
+                            .notificationRuleTargets(
+                                Collections.singletonList("requester@example.com"))
+                            .property("DISTRIBUTION_CHANNEL")
+                            .suggestion("SERVER")
+                            .suggestionMetadata(
+                                new FeatureFlagSuggestionMetadataRequest()
+                                    .variantId(
+                                        UUID.fromString("550e8400-e29b-41d4-a716-446655440002"))))
+                    .type(FeatureFlagSuggestionDataType.FLAG_SUGGESTIONS));
+
+    try {
+      FeatureFlagSuggestionResponse result =
+          apiInstance.createFlagSuggestion(
+              UUID.fromString("550e8400-e29b-41d4-a716-446655440000"), body);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling FeatureFlagsApi#createFlagSuggestion");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/feature-flags/DeleteFlagSuggestion.java

@@ -0,0 +1,24 @@
+// Delete or discard a flag change suggestion returns "No Content" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.FeatureFlagsApi;
+import java.util.UUID;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN"));
+    FeatureFlagsApi apiInstance = new FeatureFlagsApi(defaultClient);
+
+    try {
+      apiInstance.deleteFlagSuggestion(UUID.fromString("550e8400-e29b-41d4-a716-446655440020"));
+    } catch (ApiException e) {
+      System.err.println("Exception when calling FeatureFlagsApi#deleteFlagSuggestion");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/feature-flags/GetFlagSuggestion.java

@@ -0,0 +1,27 @@
+// Get a flag change suggestion returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.FeatureFlagsApi;
+import com.datadog.api.client.v2.model.FeatureFlagSuggestionResponse;
+import java.util.UUID;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN"));
+    FeatureFlagsApi apiInstance = new FeatureFlagsApi(defaultClient);
+
+    try {
+      FeatureFlagSuggestionResponse result =
+          apiInstance.getFlagSuggestion(UUID.fromString("550e8400-e29b-41d4-a716-446655440020"));
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling FeatureFlagsApi#getFlagSuggestion");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/feature-flags/RejectFlagSuggestion.java

@@ -0,0 +1,41 @@
+// Reject a flag change suggestion returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.FeatureFlagsApi;
+import com.datadog.api.client.v2.model.FeatureFlagSuggestionResponse;
+import com.datadog.api.client.v2.model.RejectFlagSuggestionAttributes;
+import com.datadog.api.client.v2.model.RejectFlagSuggestionData;
+import com.datadog.api.client.v2.model.RejectFlagSuggestionRequest;
+import com.datadog.api.client.v2.model.ReviewFlagSuggestionDataType;
+import java.util.UUID;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN"));
+    FeatureFlagsApi apiInstance = new FeatureFlagsApi(defaultClient);
+
+    RejectFlagSuggestionRequest body =
+        new RejectFlagSuggestionRequest()
+            .data(
+                new RejectFlagSuggestionData()
+                    .attributes(
+                        new RejectFlagSuggestionAttributes()
+                            .comment("Keep the existing configuration."))
+                    .type(ReviewFlagSuggestionDataType.FLAG_SUGGESTION_EVENTS));
+
+    try {
+      FeatureFlagSuggestionResponse result =
+          apiInstance.rejectFlagSuggestion(
+              UUID.fromString("550e8400-e29b-41d4-a716-446655440020"), body);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling FeatureFlagsApi#rejectFlagSuggestion");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/feature-flags/UpdateFeatureFlagApprovals.java

@@ -0,0 +1,39 @@
+// Set the approval requirement for a feature flag returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.FeatureFlagsApi;
+import com.datadog.api.client.v2.model.FeatureFlagApprovalsDataType;
+import com.datadog.api.client.v2.model.FeatureFlagResponse;
+import com.datadog.api.client.v2.model.UpdateFeatureFlagApprovalsAttributes;
+import com.datadog.api.client.v2.model.UpdateFeatureFlagApprovalsData;
+import com.datadog.api.client.v2.model.UpdateFeatureFlagApprovalsRequest;
+import java.util.UUID;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN"));
+    FeatureFlagsApi apiInstance = new FeatureFlagsApi(defaultClient);
+
+    UpdateFeatureFlagApprovalsRequest body =
+        new UpdateFeatureFlagApprovalsRequest()
+            .data(
+                new UpdateFeatureFlagApprovalsData()
+                    .attributes(new UpdateFeatureFlagApprovalsAttributes().enabled(true))
+                    .type(FeatureFlagApprovalsDataType.FEATURE_FLAG_APPROVALS));
+
+    try {
+      FeatureFlagResponse result =
+          apiInstance.updateFeatureFlagApprovals(
+              UUID.fromString("550e8400-e29b-41d4-a716-446655440000"), body);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling FeatureFlagsApi#updateFeatureFlagApprovals");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}