Mark aggregations arguments as deprecated since they're no longer needed (#2853)

api-clients-generation-pipeline[bot] · ci.datadog-api-spec · web-flow · commit 5f88599e1e0a · 2025-05-14T17:01:36.000Z
Co-authored-by: ci.datadog-api-spec &lt;packages@datadoghq.com&gt;
diff --git a/.apigentools-info b/.apigentools-info
@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-05-14 14:49:55.594978",
-            "spec_repo_commit": "90c6252d"
+            "regenerated": "2025-05-14 15:44:18.459381",
+            "spec_repo_commit": "64f5e7ee"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-05-14 14:49:55.613273",
-            "spec_repo_commit": "90c6252d"
+            "regenerated": "2025-05-14 15:44:18.474808",
+            "spec_repo_commit": "64f5e7ee"
         }
     }
 }
diff --git a/.generator/schemas/v2/openapi.yaml b/.generator/schemas/v2/openapi.yaml
@@ -21171,38 +21171,8 @@ components:
       - space
       type: object
     MetricCustomAggregations:
-      description: 'A list of queryable aggregation combinations for a count, rate,
-        or gauge metric.
-
-        By default, count and rate metrics require the (time: sum, space: sum) aggregation
-        and
-
-        Gauge metrics require the (time: avg, space: avg) aggregation.
-
-        Additional time & space combinations are also available:
-
-
-        - time: avg, space: avg
-
-        - time: avg, space: max
-
-        - time: avg, space: min
-
-        - time: avg, space: sum
-
-        - time: count, space: sum
-
-        - time: max, space: max
-
-        - time: min, space: min
-
-        - time: sum, space: avg
-
-        - time: sum, space: sum
-
-
-        Can only be applied to non_distribution metrics that have a `metric_type`
-        of `count`, `rate`, or `gauge`.'
+      description: Deprecated. You no longer need to configure specific time and space
+        aggregations for Metrics Without Limits.
       example:
       - space: sum
         time: sum
@@ -50186,8 +50156,7 @@ paths:
           maximum: 2147483647
           minimum: 49
           type: integer
-      - description: The number of aggregations that a `count`, `rate`, or `gauge`
-          metric is configured to use. Max number of aggregation combos is 9.
+      - description: Deprecated. Number of aggregations has no impact on volume.
         example: 1
         in: query
         name: filter[num_aggregations]
@@ -50395,17 +50364,16 @@ paths:
       description: 'Create and define a list of queryable tag keys for an existing
         count/gauge/rate/distribution metric.
 
-        Optionally, include percentile aggregations on any distribution metric or
-        configure custom aggregations
+        Optionally, include percentile aggregations on any distribution metric. By
+        setting `exclude_tags_mode`
 
-        on any count, rate, or gauge metric. By setting `exclude_tags_mode` to true
-        the behavior is changed
+        to true, the behavior is changed from an allow-list to a deny-list, and tags
+        in the defined list are
 
-        from an allow-list to a deny-list, and tags in the defined list will not be
-        queryable.
+        not queryable. Can only be used with application keys of users with the `Manage
+        Tags for Metrics`
 
-        Can only be used with application keys of users with the `Manage Tags for
-        Metrics` permission.'
+        permission.'
       operationId: CreateTagConfiguration
       parameters:
       - $ref: '#/components/parameters/MetricName'
diff --git a/src/main/java/com/datadog/api/client/v2/api/MetricsApi.java b/src/main/java/com/datadog/api/client/v2/api/MetricsApi.java
@@ -248,11 +248,10 @@ public CompletableFuture<MetricTagConfigurationResponse> createTagConfigurationA
 
   /**
    * Create and define a list of queryable tag keys for an existing count/gauge/rate/distribution
-   * metric. Optionally, include percentile aggregations on any distribution metric or configure
-   * custom aggregations on any count, rate, or gauge metric. By setting <code>exclude_tags_mode
-   * </code> to true the behavior is changed from an allow-list to a deny-list, and tags in the
-   * defined list will not be queryable. Can only be used with application keys of users with the
-   * <code>Manage Tags for Metrics</code> permission.
+   * metric. Optionally, include percentile aggregations on any distribution metric. By setting
+   * <code>exclude_tags_mode</code> to true, the behavior is changed from an allow-list to a
+   * deny-list, and tags in the defined list are not queryable. Can only be used with application
+   * keys of users with the <code>Manage Tags for Metrics</code> permission.
    *
    * @param metricName The name of the metric. (required)
    * @param body (required)
@@ -697,9 +696,8 @@ public EstimateMetricsOutputSeriesOptionalParameters filterHoursAgo(Integer filt
     /**
      * Set filterNumAggregations.
      *
-     * @param filterNumAggregations The number of aggregations that a <code>count</code>, <code>rate
-     *     </code>, or <code>gauge</code> metric is configured to use. Max number of aggregation
-     *     combos is 9. (optional)
+     * @param filterNumAggregations Deprecated. Number of aggregations has no impact on volume.
+     *     (optional)
      * @return EstimateMetricsOutputSeriesOptionalParameters
      */
     public EstimateMetricsOutputSeriesOptionalParameters filterNumAggregations(
diff --git a/src/main/java/com/datadog/api/client/v2/model/MetricTagConfigurationAttributes.java b/src/main/java/com/datadog/api/client/v2/model/MetricTagConfigurationAttributes.java
@@ -73,25 +73,8 @@ public MetricTagConfigurationAttributes addAggregationsItem(
   }
 
   /**
-   * A list of queryable aggregation combinations for a count, rate, or gauge metric. By default,
-   * count and rate metrics require the (time: sum, space: sum) aggregation and Gauge metrics
-   * require the (time: avg, space: avg) aggregation. Additional time &amp; space combinations are
-   * also available:
-   *
-   * <ul>
-   *   <li>time: avg, space: avg
-   *   <li>time: avg, space: max
-   *   <li>time: avg, space: min
-   *   <li>time: avg, space: sum
-   *   <li>time: count, space: sum
-   *   <li>time: max, space: max
-   *   <li>time: min, space: min
-   *   <li>time: sum, space: avg
-   *   <li>time: sum, space: sum
-   * </ul>
-   *
-   * <p>Can only be applied to non_distribution metrics that have a <code>metric_type</code> of
-   * <code>count</code>, <code>rate</code>, or <code>gauge</code>.
+   * Deprecated. You no longer need to configure specific time and space aggregations for Metrics
+   * Without Limits.
    *
    * @return aggregations
    */
diff --git a/src/main/java/com/datadog/api/client/v2/model/MetricTagConfigurationCreateAttributes.java b/src/main/java/com/datadog/api/client/v2/model/MetricTagConfigurationCreateAttributes.java
@@ -78,25 +78,8 @@ public MetricTagConfigurationCreateAttributes addAggregationsItem(
   }
 
   /**
-   * A list of queryable aggregation combinations for a count, rate, or gauge metric. By default,
-   * count and rate metrics require the (time: sum, space: sum) aggregation and Gauge metrics
-   * require the (time: avg, space: avg) aggregation. Additional time &amp; space combinations are
-   * also available:
-   *
-   * <ul>
-   *   <li>time: avg, space: avg
-   *   <li>time: avg, space: max
-   *   <li>time: avg, space: min
-   *   <li>time: avg, space: sum
-   *   <li>time: count, space: sum
-   *   <li>time: max, space: max
-   *   <li>time: min, space: min
-   *   <li>time: sum, space: avg
-   *   <li>time: sum, space: sum
-   * </ul>
-   *
-   * <p>Can only be applied to non_distribution metrics that have a <code>metric_type</code> of
-   * <code>count</code>, <code>rate</code>, or <code>gauge</code>.
+   * Deprecated. You no longer need to configure specific time and space aggregations for Metrics
+   * Without Limits.
    *
    * @return aggregations
    */
diff --git a/src/main/java/com/datadog/api/client/v2/model/MetricTagConfigurationUpdateAttributes.java b/src/main/java/com/datadog/api/client/v2/model/MetricTagConfigurationUpdateAttributes.java
@@ -61,25 +61,8 @@ public MetricTagConfigurationUpdateAttributes addAggregationsItem(
   }
 
   /**
-   * A list of queryable aggregation combinations for a count, rate, or gauge metric. By default,
-   * count and rate metrics require the (time: sum, space: sum) aggregation and Gauge metrics
-   * require the (time: avg, space: avg) aggregation. Additional time &amp; space combinations are
-   * also available:
-   *
-   * <ul>
-   *   <li>time: avg, space: avg
-   *   <li>time: avg, space: max
-   *   <li>time: avg, space: min
-   *   <li>time: avg, space: sum
-   *   <li>time: count, space: sum
-   *   <li>time: max, space: max
-   *   <li>time: min, space: min
-   *   <li>time: sum, space: avg
-   *   <li>time: sum, space: sum
-   * </ul>
-   *
-   * <p>Can only be applied to non_distribution metrics that have a <code>metric_type</code> of
-   * <code>count</code>, <code>rate</code>, or <code>gauge</code>.
+   * Deprecated. You no longer need to configure specific time and space aggregations for Metrics
+   * Without Limits.
    *
    * @return aggregations
    */

Original file line number	Diff line number	Diff line change
`@@ -4,13 +4,13 @@`
`4`	`4`	`"spec_versions": {`
`5`	`5`	`"v1": {`
`6`	`6`	`"apigentools_version": "1.6.6",`
`7`		`- "regenerated": "2025-05-14 14:49:55.594978",`
`8`		`- "spec_repo_commit": "90c6252d"`
	`7`	`+ "regenerated": "2025-05-14 15:44:18.459381",`
	`8`	`+ "spec_repo_commit": "64f5e7ee"`
`9`	`9`	`},`
`10`	`10`	`"v2": {`
`11`	`11`	`"apigentools_version": "1.6.6",`
`12`		`- "regenerated": "2025-05-14 14:49:55.613273",`
`13`		`- "spec_repo_commit": "90c6252d"`
	`12`	`+ "regenerated": "2025-05-14 15:44:18.474808",`
	`13`	`+ "spec_repo_commit": "64f5e7ee"`
`14`	`14`	`}`
`15`	`15`	`}`
`16`	`16`	`}`