Regenerate client from commit 49255f5b of spec repo

Author: ci.datadog-api-spec

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-05-07 17:07:25.236674",
-            "spec_repo_commit": "a1235a0d"
+            "regenerated": "2025-05-07 20:12:24.175174",
+            "spec_repo_commit": "49255f5b"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-05-07 17:07:25.253013",
-            "spec_repo_commit": "a1235a0d"
+            "regenerated": "2025-05-07 20:12:24.191123",
+            "spec_repo_commit": "49255f5b"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -20918,6 +20918,7 @@ components:
       - ZSTD1
       - GZIP
     MetricCustomAggregation:
+      deprecated: true
       description: A time and space aggregation combination for use in query.
       example:
         space: sum
@@ -20932,6 +20933,7 @@ components:
       - space
       type: object
     MetricCustomAggregations:
+      deprecated: true
       description: 'A list of queryable aggregation combinations for a count, rate,
         or gauge metric.
 
@@ -20964,13 +20966,9 @@ components:
 
         Can only be applied to non_distribution metrics that have a `metric_type`
         of `count`, `rate`, or `gauge`.'
-      example:
-      - space: sum
-        time: sum
-      - space: sum
-        time: count
       items:
         $ref: '#/components/schemas/MetricCustomAggregation'
+        deprecated: true
       type: array
     MetricCustomSpaceAggregation:
       description: A space aggregation for use in query.
@@ -21436,6 +21434,7 @@ components:
         time: count
       items:
         $ref: '#/components/schemas/MetricCustomAggregation'
+        deprecated: true
       type: array
     MetricSuggestedTagsAndAggregations:
       description: Object for a single metric's actively queried tags and aggregations.
@@ -21461,6 +21460,7 @@ components:
       properties:
         active_aggregations:
           $ref: '#/components/schemas/MetricSuggestedAggregations'
+          deprecated: true
         active_tags:
           description: List of tag keys that have been actively queried.
           example:
@@ -21500,6 +21500,7 @@ components:
       properties:
         aggregations:
           $ref: '#/components/schemas/MetricCustomAggregations'
+          deprecated: true
         created_at:
           description: Timestamp when the tag configuration was created.
           example: '2020-03-25T09:48:37.463835Z'
@@ -21544,6 +21545,7 @@ components:
       properties:
         aggregations:
           $ref: '#/components/schemas/MetricCustomAggregations'
+          deprecated: true
         exclude_tags_mode:
           description: 'When set to true, the configuration will exclude the configured
             tags and include any other submitted tags.
@@ -21655,6 +21657,7 @@ components:
       properties:
         aggregations:
           $ref: '#/components/schemas/MetricCustomAggregations'
+          deprecated: true
         exclude_tags_mode:
           description: 'When set to true, the configuration will exclude the configured
             tags and include any other submitted tags.
@@ -50068,9 +50071,8 @@ paths:
       - Metrics
   /api/v2/metrics/{metric_name}/estimate:
     get:
-      description: Returns the estimated cardinality for a metric with a given tag,
-        percentile and number of aggregations configuration using Metrics without
-        Limits™.
+      description: Returns the estimated cardinality for a metric with a given tag
+        and percentile configuration using Metrics without Limits™.
       operationId: EstimateMetricsOutputSeries
       parameters:
       - $ref: '#/components/parameters/MetricName'
@@ -50092,8 +50094,9 @@ 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.
+      - deprecated: true
+        description: This argument has no effect as all time and space combinations
+          are now available with no impact on customer bills.
         example: 1
         in: query
         name: filter[num_aggregations]
@@ -61234,15 +61237,31 @@ tags:
     description: Find out more at
     url: https://docs.datadoghq.com/logs/logs_to_metrics/
   name: Logs Metrics
-- description: "The metrics endpoint allows you to:\n\n- Post metrics data so it can
-    be graphed on Datadog\u2019s dashboards\n- Query metrics from any time period
-    (timeseries and scalar)\n- Modify tag configurations for metrics\n- View tags
-    and volumes for metrics\n\n**Note**: A graph can only contain a set number of
-    points\nand as the timeframe over which a metric is viewed increases,\naggregation
-    between points occurs to stay below that set number.\n\nThe Post, Patch, and Delete
-    `manage_tags` API methods can only be performed by\na user who has the `Manage
-    Tags for Metrics` permission.\n\nSee the [Metrics page](https://docs.datadoghq.com/metrics/)
-    for more information."
+- description: 'The metrics endpoint allows you to:
+
+
+    - Post metrics data so it can be graphed on Datadog dashboards
+
+    - Query metrics from any time period (timeseries and scalar)
+
+    - Modify tag configurations for metrics
+
+    - View tags and volumes for metrics
+
+
+    **Note**: A graph can only contain a set number of points
+
+    and as the timeframe over which a metric is viewed increases,
+
+    aggregation between points occurs to stay below that set number.
+
+
+    The Post, Patch, and Delete `manage_tags` API methods can only be performed by
+
+    a user who has the `Manage Tags for Metrics` permission.
+
+
+    See the [Metrics page](https://docs.datadoghq.com/metrics/) for more information.'
   name: Metrics
 - description: 'Configure your [Datadog Microsoft Teams integration](https://docs.datadoghq.com/integrations/microsoft_teams/)
 

examples/v2/metrics/EstimateMetricsOutputSeries.java

@@ -15,9 +15,7 @@ public static void main(String[] args) {
       MetricEstimateResponse result =
           apiInstance.estimateMetricsOutputSeries(
               "system.cpu.idle",
-              new EstimateMetricsOutputSeriesOptionalParameters()
-                  .filterGroups("app,host")
-                  .filterNumAggregations(4));
+              new EstimateMetricsOutputSeriesOptionalParameters().filterGroups("app,host"));
       System.out.println(result);
     } catch (ApiException e) {
       System.err.println("Exception when calling MetricsApi#estimateMetricsOutputSeries");

src/main/java/com/datadog/api/client/v2/api/MetricsApi.java

@@ -697,9 +697,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 This argument has no effect as all time and space combinations
+     *     are now available with no impact on customer bills. (optional)
      * @return EstimateMetricsOutputSeriesOptionalParameters
      */
     public EstimateMetricsOutputSeriesOptionalParameters filterNumAggregations(
@@ -801,8 +800,8 @@ public CompletableFuture<MetricEstimateResponse> estimateMetricsOutputSeriesAsyn
   }
 
   /**
-   * Returns the estimated cardinality for a metric with a given tag, percentile and number of
-   * aggregations configuration using Metrics without Limits&trade;.
+   * Returns the estimated cardinality for a metric with a given tag and percentile configuration
+   * using Metrics without Limits&trade;.
    *
    * @param metricName The name of the metric. (required)
    * @param parameters Optional parameters for the request.

src/main/java/com/datadog/api/client/v2/model/MetricCustomAggregation.java

@@ -17,7 +17,12 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** A time and space aggregation combination for use in query. */
+/**
+ * A time and space aggregation combination for use in query.
+ *
+ * @deprecated
+ */
+@Deprecated
 @JsonPropertyOrder({
   MetricCustomAggregation.JSON_PROPERTY_SPACE,
   MetricCustomAggregation.JSON_PROPERTY_TIME

src/main/java/com/datadog/api/client/v2/model/MetricTagConfigurationAttributes.java

@@ -94,14 +94,17 @@ public MetricTagConfigurationAttributes addAggregationsItem(
    * <code>count</code>, <code>rate</code>, or <code>gauge</code>.
    *
    * @return aggregations
+   * @deprecated
    */
+  @Deprecated
   @jakarta.annotation.Nullable
   @JsonProperty(JSON_PROPERTY_AGGREGATIONS)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
   public List<MetricCustomAggregation> getAggregations() {
     return aggregations;
   }
 
+  @Deprecated
   public void setAggregations(List<MetricCustomAggregation> aggregations) {
     this.aggregations = aggregations;
   }

src/main/java/com/datadog/api/client/v2/model/MetricTagConfigurationCreateAttributes.java

@@ -99,14 +99,17 @@ public MetricTagConfigurationCreateAttributes addAggregationsItem(
    * <code>count</code>, <code>rate</code>, or <code>gauge</code>.
    *
    * @return aggregations
+   * @deprecated
    */
+  @Deprecated
   @jakarta.annotation.Nullable
   @JsonProperty(JSON_PROPERTY_AGGREGATIONS)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
   public List<MetricCustomAggregation> getAggregations() {
     return aggregations;
   }
 
+  @Deprecated
   public void setAggregations(List<MetricCustomAggregation> aggregations) {
     this.aggregations = aggregations;
   }

src/main/java/com/datadog/api/client/v2/model/MetricTagConfigurationUpdateAttributes.java

@@ -82,14 +82,17 @@ public MetricTagConfigurationUpdateAttributes addAggregationsItem(
    * <code>count</code>, <code>rate</code>, or <code>gauge</code>.
    *
    * @return aggregations
+   * @deprecated
    */
+  @Deprecated
   @jakarta.annotation.Nullable
   @JsonProperty(JSON_PROPERTY_AGGREGATIONS)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
   public List<MetricCustomAggregation> getAggregations() {
     return aggregations;
   }
 
+  @Deprecated
   public void setAggregations(List<MetricCustomAggregation> aggregations) {
     this.aggregations = aggregations;
   }

src/test/resources/com/datadog/api/client/v2/api/metrics.feature

@@ -1,7 +1,7 @@
 @endpoint(metrics) @endpoint(metrics-v2)
 Feature: Metrics
   The metrics endpoint allows you to:  - Post metrics data so it can be
-  graphed on Datadog’s dashboards - Query metrics from any time period
+  graphed on Datadog dashboards - Query metrics from any time period
   (timeseries and scalar) - Modify tag configurations for metrics - View
   tags and volumes for metrics  **Note**: A graph can only contain a set
   number of points and as the timeframe over which a metric is viewed
@@ -370,7 +370,6 @@ Feature: Metrics
     Given new "EstimateMetricsOutputSeries" request
     And request contains "metric_name" parameter with value "system.cpu.idle"
     And request contains "filter[groups]" parameter with value "app,host"
-    And request contains "filter[num_aggregations]" parameter with value 4
     When the request is sent
     Then the response status is 200 Success