Add tag indexing rule APIs to v2 metrics spec

examples/v2/metrics/CreateTagIndexingRule.java

@@ -0,0 +1,60 @@
+// Create a tag indexing rule returns "Created" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.MetricsApi;
+import com.datadog.api.client.v2.model.TagIndexingRuleCreateAttributes;
+import com.datadog.api.client.v2.model.TagIndexingRuleCreateData;
+import com.datadog.api.client.v2.model.TagIndexingRuleCreateRequest;
+import com.datadog.api.client.v2.model.TagIndexingRuleDynamicTags;
+import com.datadog.api.client.v2.model.TagIndexingRuleMetricMatch;
+import com.datadog.api.client.v2.model.TagIndexingRuleOptions;
+import com.datadog.api.client.v2.model.TagIndexingRuleOptionsData;
+import com.datadog.api.client.v2.model.TagIndexingRuleResponse;
+import com.datadog.api.client.v2.model.TagIndexingRuleType;
+import java.util.Arrays;
+import java.util.Collections;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    MetricsApi apiInstance = new MetricsApi(defaultClient);
+
+    TagIndexingRuleCreateRequest body =
+        new TagIndexingRuleCreateRequest()
+            .data(
+                new TagIndexingRuleCreateData()
+                    .attributes(
+                        new TagIndexingRuleCreateAttributes()
+                            .excludeTagsMode(false)
+                            .metricNameMatches(Collections.singletonList("dd.test.*"))
+                            .name("my-indexing-rule")
+                            .options(
+                                new TagIndexingRuleOptions()
+                                    .data(
+                                        new TagIndexingRuleOptionsData()
+                                            .dynamicTags(
+                                                new TagIndexingRuleDynamicTags()
+                                                    .queriedTagsWindowSeconds(3600L)
+                                                    .relatedAssetTags(false))
+                                            .managePreexistingMetrics(true)
+                                            .metricMatch(
+                                                new TagIndexingRuleMetricMatch()
+                                                    .queriedWindowSeconds(3600L))
+                                            .overridePreviousRules(false))
+                                    .version(1L))
+                            .tags(Arrays.asList("env", "service")))
+                    .type(TagIndexingRuleType.TAG_INDEXING_RULES));
+
+    try {
+      TagIndexingRuleResponse result = apiInstance.createTagIndexingRule(body);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling MetricsApi#createTagIndexingRule");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/metrics/CreateTagIndexingRuleExemption.java

@@ -0,0 +1,38 @@
+// Create a tag indexing rule exemption returns "Created" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.MetricsApi;
+import com.datadog.api.client.v2.model.TagIndexingRuleExemptionCreateAttributes;
+import com.datadog.api.client.v2.model.TagIndexingRuleExemptionCreateData;
+import com.datadog.api.client.v2.model.TagIndexingRuleExemptionCreateRequest;
+import com.datadog.api.client.v2.model.TagIndexingRuleExemptionResponse;
+import com.datadog.api.client.v2.model.TagIndexingRuleExemptionType;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    MetricsApi apiInstance = new MetricsApi(defaultClient);
+
+    TagIndexingRuleExemptionCreateRequest body =
+        new TagIndexingRuleExemptionCreateRequest()
+            .data(
+                new TagIndexingRuleExemptionCreateData()
+                    .attributes(
+                        new TagIndexingRuleExemptionCreateAttributes()
+                            .reason("This metric has a pre-existing tag configuration."))
+                    .type(TagIndexingRuleExemptionType.TAG_INDEXING_RULE_EXEMPTIONS));
+
+    try {
+      TagIndexingRuleExemptionResponse result =
+          apiInstance.createTagIndexingRuleExemption("dist.http.endpoint.request", body);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling MetricsApi#createTagIndexingRuleExemption");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/metrics/DeleteTagIndexingRule.java

@@ -0,0 +1,25 @@
+// Delete a tag indexing rule returns "No Content" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.MetricsApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    MetricsApi apiInstance = new MetricsApi(defaultClient);
+
+    // there is a valid "tag_indexing_rule" in the system
+    String TAG_INDEXING_RULE_DATA_ID = System.getenv("TAG_INDEXING_RULE_DATA_ID");
+
+    try {
+      apiInstance.deleteTagIndexingRule(TAG_INDEXING_RULE_DATA_ID);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling MetricsApi#deleteTagIndexingRule");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/metrics/DeleteTagIndexingRuleExemption.java

@@ -0,0 +1,22 @@
+// Delete a tag indexing rule exemption returns "No Content" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.MetricsApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    MetricsApi apiInstance = new MetricsApi(defaultClient);
+
+    try {
+      apiInstance.deleteTagIndexingRuleExemption("dist.http.endpoint.request");
+    } catch (ApiException e) {
+      System.err.println("Exception when calling MetricsApi#deleteTagIndexingRuleExemption");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/metrics/GetTagIndexingRule.java

@@ -0,0 +1,27 @@
+// Get a tag indexing rule returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.MetricsApi;
+import com.datadog.api.client.v2.model.TagIndexingRuleResponse;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    MetricsApi apiInstance = new MetricsApi(defaultClient);
+
+    // there is a valid "tag_indexing_rule" in the system
+    String TAG_INDEXING_RULE_DATA_ID = System.getenv("TAG_INDEXING_RULE_DATA_ID");
+
+    try {
+      TagIndexingRuleResponse result = apiInstance.getTagIndexingRule(TAG_INDEXING_RULE_DATA_ID);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling MetricsApi#getTagIndexingRule");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/metrics/GetTagIndexingRuleExemption.java

@@ -0,0 +1,25 @@
+// Get a tag indexing rule exemption returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.MetricsApi;
+import com.datadog.api.client.v2.model.TagIndexingRuleExemptionResponse;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    MetricsApi apiInstance = new MetricsApi(defaultClient);
+
+    try {
+      TagIndexingRuleExemptionResponse result =
+          apiInstance.getTagIndexingRuleExemption("dist.http.endpoint.request");
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling MetricsApi#getTagIndexingRuleExemption");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/metrics/ListTagIndexingRules.java

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

examples/v2/metrics/ListTagIndexingRulesForMetric.java

@@ -0,0 +1,24 @@
+// List tag indexing rules for a metric returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.MetricsApi;
+import com.datadog.api.client.v2.model.TagIndexingRulesResponse;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    MetricsApi apiInstance = new MetricsApi(defaultClient);
+
+    try {
+      TagIndexingRulesResponse result = apiInstance.listTagIndexingRulesForMetric("ExampleMetric");
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling MetricsApi#listTagIndexingRulesForMetric");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/metrics/ReorderTagIndexingRules.java

@@ -0,0 +1,39 @@
+// Reorder tag indexing rules returns "No Content" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.MetricsApi;
+import com.datadog.api.client.v2.model.TagIndexingRuleOrderAttributes;
+import com.datadog.api.client.v2.model.TagIndexingRuleOrderData;
+import com.datadog.api.client.v2.model.TagIndexingRuleOrderRequest;
+import com.datadog.api.client.v2.model.TagIndexingRuleType;
+import java.util.Collections;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    MetricsApi apiInstance = new MetricsApi(defaultClient);
+
+    // there is a valid "tag_indexing_rule" in the system
+    String TAG_INDEXING_RULE_DATA_ID = System.getenv("TAG_INDEXING_RULE_DATA_ID");
+
+    TagIndexingRuleOrderRequest body =
+        new TagIndexingRuleOrderRequest()
+            .data(
+                new TagIndexingRuleOrderData()
+                    .attributes(
+                        new TagIndexingRuleOrderAttributes()
+                            .ruleIds(Collections.singletonList(TAG_INDEXING_RULE_DATA_ID)))
+                    .type(TagIndexingRuleType.TAG_INDEXING_RULES));
+
+    try {
+      apiInstance.reorderTagIndexingRules(body);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling MetricsApi#reorderTagIndexingRules");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/metrics/UpdateTagIndexingRule.java

@@ -0,0 +1,64 @@
+// Update a tag indexing rule returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.MetricsApi;
+import com.datadog.api.client.v2.model.TagIndexingRuleDynamicTags;
+import com.datadog.api.client.v2.model.TagIndexingRuleMetricMatch;
+import com.datadog.api.client.v2.model.TagIndexingRuleOptions;
+import com.datadog.api.client.v2.model.TagIndexingRuleOptionsData;
+import com.datadog.api.client.v2.model.TagIndexingRuleResponse;
+import com.datadog.api.client.v2.model.TagIndexingRuleType;
+import com.datadog.api.client.v2.model.TagIndexingRuleUpdateAttributes;
+import com.datadog.api.client.v2.model.TagIndexingRuleUpdateData;
+import com.datadog.api.client.v2.model.TagIndexingRuleUpdateRequest;
+import java.util.Arrays;
+import java.util.Collections;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    MetricsApi apiInstance = new MetricsApi(defaultClient);
+
+    // there is a valid "tag_indexing_rule" in the system
+    String TAG_INDEXING_RULE_DATA_ID = System.getenv("TAG_INDEXING_RULE_DATA_ID");
+
+    TagIndexingRuleUpdateRequest body =
+        new TagIndexingRuleUpdateRequest()
+            .data(
+                new TagIndexingRuleUpdateData()
+                    .attributes(
+                        new TagIndexingRuleUpdateAttributes()
+                            .metricNameMatches(Collections.singletonList("dd.test.*"))
+                            .name("my-indexing-rule")
+                            .options(
+                                new TagIndexingRuleOptions()
+                                    .data(
+                                        new TagIndexingRuleOptionsData()
+                                            .dynamicTags(
+                                                new TagIndexingRuleDynamicTags()
+                                                    .queriedTagsWindowSeconds(3600L)
+                                                    .relatedAssetTags(false))
+                                            .managePreexistingMetrics(true)
+                                            .metricMatch(
+                                                new TagIndexingRuleMetricMatch()
+                                                    .queriedWindowSeconds(3600L))
+                                            .overridePreviousRules(false))
+                                    .version(1L))
+                            .ruleOrder(2L)
+                            .tags(Arrays.asList("env", "service")))
+                    .type(TagIndexingRuleType.TAG_INDEXING_RULES));
+
+    try {
+      TagIndexingRuleResponse result =
+          apiInstance.updateTagIndexingRule(TAG_INDEXING_RULE_DATA_ID, body);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling MetricsApi#updateTagIndexingRule");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}