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

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com> 89297af

Author: api-clients-generation-pipeline[bot]

datadog_api_client.v2.api.html

@@ -6745,10 +6745,10 @@ <h2 id="submodules">Submodules<a class="headerlink" href="#submodules" title="Li
 <span class="sig-name descname"><span class="pre">create_tag_configuration</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">metric_name</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">body</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="datadog_api_client.v2.model.html#datadog_api_client.v2.model.metric_tag_configuration_create_request.MetricTagConfigurationCreateRequest" title="datadog_api_client.v2.model.metric_tag_configuration_create_request.MetricTagConfigurationCreateRequest"><span class="pre">MetricTagConfigurationCreateRequest</span></a></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">→</span> <span class="sig-return-typehint"><a class="reference internal" href="datadog_api_client.v2.model.html#datadog_api_client.v2.model.metric_tag_configuration_response.MetricTagConfigurationResponse" title="datadog_api_client.v2.model.metric_tag_configuration_response.MetricTagConfigurationResponse"><span class="pre">MetricTagConfigurationResponse</span></a></span></span><a class="headerlink" href="#datadog_api_client.v2.api.metrics_api.MetricsApi.create_tag_configuration" title="Link to this definition">¶</a></dt>
 <dd><p>Create a tag configuration.</p>
 <p>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 class="docutils literal notranslate"><span class="pre">exclude_tags_mode</span></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 class="docutils literal notranslate"><span class="pre">Manage</span> <span class="pre">Tags</span> <span class="pre">for</span> <span class="pre">Metrics</span></code> permission.</p>
+Optionally, include percentile aggregations on any distribution metric. By setting <code class="docutils literal notranslate"><span class="pre">exclude_tags_mode</span></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 class="docutils literal notranslate"><span class="pre">Manage</span> <span class="pre">Tags</span> <span class="pre">for</span> <span class="pre">Metrics</span></code>
+permission.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><p><strong>metric_name</strong> (<em>str</em>) – The name of the metric.</p>
@@ -6798,7 +6798,7 @@ <h2 id="submodules">Submodules<a class="headerlink" href="#submodules" title="Li
 <li><p><strong>metric_name</strong> (<em>str</em>) – The name of the metric.</p></li>
 <li><p><strong>filter_groups</strong> (<em>str</em><em>, </em><em>optional</em>) – Filtered tag keys that the metric is configured to query with.</p></li>
 <li><p><strong>filter_hours_ago</strong> (<em>int</em><em>, </em><em>optional</em>) – The number of hours of look back (from now) to estimate cardinality with. If unspecified, it defaults to 0 hours.</p></li>
-<li><p><strong>filter_num_aggregations</strong> (<em>int</em><em>, </em><em>optional</em>) – The number of aggregations that a <code class="docutils literal notranslate"><span class="pre">count</span></code> , <code class="docutils literal notranslate"><span class="pre">rate</span></code> , or <code class="docutils literal notranslate"><span class="pre">gauge</span></code> metric is configured to use. Max number of aggregation combos is 9.</p></li>
+<li><p><strong>filter_num_aggregations</strong> (<em>int</em><em>, </em><em>optional</em>) – Deprecated. Number of aggregations has no impact on volume.</p></li>
 <li><p><strong>filter_pct</strong> (<em>bool</em><em>, </em><em>optional</em>) – A boolean, for distribution metrics only, to estimate cardinality if the metric includes additional percentile aggregators.</p></li>
 <li><p><strong>filter_timespan_h</strong> (<em>int</em><em>, </em><em>optional</em>) – A window, in hours, from the look back to estimate cardinality with. The minimum and default is 1 hour.</p></li>
 </ul>

datadog_api_client.v2.model.html

@@ -45968,24 +45968,7 @@ <h2 id="submodules">Submodules<a class="headerlink" href="#submodules" title="Li
 <dt class="sig sig-object py">
 <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">MetricCustomAggregations</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span></dt>
 <dd><p>Bases: <a class="reference internal" href="datadog_api_client.html#datadog_api_client.model_utils.ModelSimple" title="datadog_api_client.model_utils.ModelSimple"><code class="xref py py-class docutils literal notranslate"><span class="pre">ModelSimple</span></code></a></p>
-<dl>
-<dt>A list of queryable aggregation combinations for a count, rate, or gauge metric.</dt><dd><p>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:</p>
-<ul class="simple">
-<li><p>time: avg, space: avg</p></li>
-<li><p>time: avg, space: max</p></li>
-<li><p>time: avg, space: min</p></li>
-<li><p>time: avg, space: sum</p></li>
-<li><p>time: count, space: sum</p></li>
-<li><p>time: max, space: max</p></li>
-<li><p>time: min, space: min</p></li>
-<li><p>time: sum, space: avg</p></li>
-<li><p>time: sum, space: sum</p></li>
-</ul>
-<p>Can only be applied to non_distribution metrics that have a <code class="docutils literal notranslate"><span class="pre">metric_type</span></code> of <code class="docutils literal notranslate"><span class="pre">count</span></code> , <code class="docutils literal notranslate"><span class="pre">rate</span></code> , or <code class="docutils literal notranslate"><span class="pre">gauge</span></code>.</p>
-</dd>
-</dl>
+<p>Deprecated. You no longer need to configure specific time and space aggregations for Metrics Without Limits.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
@@ -46930,23 +46913,7 @@ <h2 id="submodules">Submodules<a class="headerlink" href="#submodules" title="Li
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
-<li><p><strong>aggregations</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.metric_custom_aggregations.MetricCustomAggregations" title="datadog_api_client.v2.model.metric_custom_aggregations.MetricCustomAggregations"><em>MetricCustomAggregations</em></a><em>, </em><em>optional</em>) – <p>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:</p>
-<ul>
-<li><p>time: avg, space: avg</p></li>
-<li><p>time: avg, space: max</p></li>
-<li><p>time: avg, space: min</p></li>
-<li><p>time: avg, space: sum</p></li>
-<li><p>time: count, space: sum</p></li>
-<li><p>time: max, space: max</p></li>
-<li><p>time: min, space: min</p></li>
-<li><p>time: sum, space: avg</p></li>
-<li><p>time: sum, space: sum</p></li>
-</ul>
-<p>Can only be applied to non_distribution metrics that have a <code class="docutils literal notranslate"><span class="pre">metric_type</span></code> of <code class="docutils literal notranslate"><span class="pre">count</span></code> , <code class="docutils literal notranslate"><span class="pre">rate</span></code> , or <code class="docutils literal notranslate"><span class="pre">gauge</span></code>.</p>
-</p></li>
+<li><p><strong>aggregations</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.metric_custom_aggregations.MetricCustomAggregations" title="datadog_api_client.v2.model.metric_custom_aggregations.MetricCustomAggregations"><em>MetricCustomAggregations</em></a><em>, </em><em>optional</em>) – Deprecated. You no longer need to configure specific time and space aggregations for Metrics Without Limits.</p></li>
 <li><p><strong>created_at</strong> (<em>datetime</em><em>, </em><em>optional</em>) – Timestamp when the tag configuration was created.</p></li>
 <li><p><strong>exclude_tags_mode</strong> (<em>bool</em><em>, </em><em>optional</em>) – When set to true, the configuration will exclude the configured tags and include any other submitted tags.
 When set to false, the configuration will include the configured tags and exclude any other submitted tags.
@@ -46975,23 +46942,7 @@ <h2 id="submodules">Submodules<a class="headerlink" href="#submodules" title="Li
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
-<li><p><strong>aggregations</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.metric_custom_aggregations.MetricCustomAggregations" title="datadog_api_client.v2.model.metric_custom_aggregations.MetricCustomAggregations"><em>MetricCustomAggregations</em></a><em>, </em><em>optional</em>) – <p>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:</p>
-<ul>
-<li><p>time: avg, space: avg</p></li>
-<li><p>time: avg, space: max</p></li>
-<li><p>time: avg, space: min</p></li>
-<li><p>time: avg, space: sum</p></li>
-<li><p>time: count, space: sum</p></li>
-<li><p>time: max, space: max</p></li>
-<li><p>time: min, space: min</p></li>
-<li><p>time: sum, space: avg</p></li>
-<li><p>time: sum, space: sum</p></li>
-</ul>
-<p>Can only be applied to non_distribution metrics that have a <code class="docutils literal notranslate"><span class="pre">metric_type</span></code> of <code class="docutils literal notranslate"><span class="pre">count</span></code> , <code class="docutils literal notranslate"><span class="pre">rate</span></code> , or <code class="docutils literal notranslate"><span class="pre">gauge</span></code>.</p>
-</p></li>
+<li><p><strong>aggregations</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.metric_custom_aggregations.MetricCustomAggregations" title="datadog_api_client.v2.model.metric_custom_aggregations.MetricCustomAggregations"><em>MetricCustomAggregations</em></a><em>, </em><em>optional</em>) – Deprecated. You no longer need to configure specific time and space aggregations for Metrics Without Limits.</p></li>
 <li><p><strong>exclude_tags_mode</strong> (<em>bool</em><em>, </em><em>optional</em>) – When set to true, the configuration will exclude the configured tags and include any other submitted tags.
 When set to false, the configuration will include the configured tags and exclude any other submitted tags.
 Defaults to false. Requires <code class="docutils literal notranslate"><span class="pre">tags</span></code> property.</p></li>
@@ -47169,23 +47120,7 @@ <h2 id="submodules">Submodules<a class="headerlink" href="#submodules" title="Li
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
-<li><p><strong>aggregations</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.metric_custom_aggregations.MetricCustomAggregations" title="datadog_api_client.v2.model.metric_custom_aggregations.MetricCustomAggregations"><em>MetricCustomAggregations</em></a><em>, </em><em>optional</em>) – <p>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:</p>
-<ul>
-<li><p>time: avg, space: avg</p></li>
-<li><p>time: avg, space: max</p></li>
-<li><p>time: avg, space: min</p></li>
-<li><p>time: avg, space: sum</p></li>
-<li><p>time: count, space: sum</p></li>
-<li><p>time: max, space: max</p></li>
-<li><p>time: min, space: min</p></li>
-<li><p>time: sum, space: avg</p></li>
-<li><p>time: sum, space: sum</p></li>
-</ul>
-<p>Can only be applied to non_distribution metrics that have a <code class="docutils literal notranslate"><span class="pre">metric_type</span></code> of <code class="docutils literal notranslate"><span class="pre">count</span></code> , <code class="docutils literal notranslate"><span class="pre">rate</span></code> , or <code class="docutils literal notranslate"><span class="pre">gauge</span></code>.</p>
-</p></li>
+<li><p><strong>aggregations</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.metric_custom_aggregations.MetricCustomAggregations" title="datadog_api_client.v2.model.metric_custom_aggregations.MetricCustomAggregations"><em>MetricCustomAggregations</em></a><em>, </em><em>optional</em>) – Deprecated. You no longer need to configure specific time and space aggregations for Metrics Without Limits.</p></li>
 <li><p><strong>exclude_tags_mode</strong> (<em>bool</em><em>, </em><em>optional</em>) – When set to true, the configuration will exclude the configured tags and include any other submitted tags.
 When set to false, the configuration will include the configured tags and exclude any other submitted tags.
 Defaults to false. Requires <code class="docutils literal notranslate"><span class="pre">tags</span></code> property.</p></li>