Update Metrics Query descriptions and scopes (#1540)

Co-authored-by: ci.datadog-api-spec <[email protected]> 8788749

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

datadog_api_client.v2.api.html

@@ -4803,7 +4803,7 @@ <h1 id="datadog-api-client-v2-api--page-root">datadog_api_client.v2.api<a class=
 <dt class="sig sig-object py" id="datadog_api_client.v2.api.metrics_api.MetricsApi.query_scalar_data">
 <span class="sig-name descname"><span class="pre">query_scalar_data</span></span><span class="sig-paren">(</span><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.scalar_formula_query_request.ScalarFormulaQueryRequest" title="datadog_api_client.v2.model.scalar_formula_query_request.ScalarFormulaQueryRequest"><span class="pre">ScalarFormulaQueryRequest</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.scalar_formula_query_response.ScalarFormulaQueryResponse" title="datadog_api_client.v2.model.scalar_formula_query_response.ScalarFormulaQueryResponse"><span class="pre">ScalarFormulaQueryResponse</span></a></span></span><a class="headerlink" href="#datadog_api_client.v2.api.metrics_api.MetricsApi.query_scalar_data" title="Permalink to this definition">¶</a></dt>
 <dd><p>Query scalar data across multiple products.</p>
-<p>Query scalar values (as seen on Query Value, Table and Toplist widgets).
+<p>Query scalar values (as seen on Query Value, Table, and Toplist widgets).
 Multiple data sources are supported with the ability to
 process the data using formulas and functions.</p>
 <dl class="field-list simple">

datadog_api_client.v2.model.html

@@ -17072,7 +17072,7 @@ <h1 id="datadog-api-client-v2-model--page-root">datadog_api_client.v2.model<a cl
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
 <li><p><strong>aggregation</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.events_aggregation.EventsAggregation" title="datadog_api_client.v2.model.events_aggregation.EventsAggregation"><em>EventsAggregation</em></a>) – The type of aggregation that can be performed on events-based queries.</p></li>
-<li><p><strong>metric</strong> (<em>str</em><em>, </em><em>optional</em>) – Metric whose calculated value should be used to define the sort order of a query’s results.</p></li>
+<li><p><strong>metric</strong> (<em>str</em><em>, </em><em>optional</em>) – The metric’s calculated value which should be used to define the sort order of a query’s results.</p></li>
 <li><p><strong>order</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.query_sort_order.QuerySortOrder" title="datadog_api_client.v2.model.query_sort_order.QuerySortOrder"><em>QuerySortOrder</em></a><em>, </em><em>optional</em>) – Direction of sort.</p></li>
 <li><p><strong>type</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.events_sort_type.EventsSortType" title="datadog_api_client.v2.model.events_sort_type.EventsSortType"><em>EventsSortType</em></a><em>, </em><em>optional</em>) – The type of sort to use on the calculated value.</p></li>
 </ul>
@@ -23722,7 +23722,7 @@ <h1 id="datadog-api-client-v2-model--page-root">datadog_api_client.v2.model<a cl
 <dt class="sig sig-object py" id="datadog_api_client.v2.model.metrics_aggregator.MetricsAggregator">
 <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">MetricsAggregator</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><a class="headerlink" href="#datadog_api_client.v2.model.metrics_aggregator.MetricsAggregator" title="Permalink to this definition">¶</a></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>
-<p>The type of aggregation that can be performed on metrics queries.</p>
+<p>The type of aggregation that can be performed on metrics-based queries.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
@@ -23812,7 +23812,7 @@ <h1 id="datadog-api-client-v2-model--page-root">datadog_api_client.v2.model<a cl
 <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>aggregator</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.metrics_aggregator.MetricsAggregator" title="datadog_api_client.v2.model.metrics_aggregator.MetricsAggregator"><em>MetricsAggregator</em></a>) – The type of aggregation that can be performed on metrics queries.</p></li>
+<li><p><strong>aggregator</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.metrics_aggregator.MetricsAggregator" title="datadog_api_client.v2.model.metrics_aggregator.MetricsAggregator"><em>MetricsAggregator</em></a>) – The type of aggregation that can be performed on metrics-based queries.</p></li>
 <li><p><strong>data_source</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.metrics_data_source.MetricsDataSource" title="datadog_api_client.v2.model.metrics_data_source.MetricsDataSource"><em>MetricsDataSource</em></a>) – A data source that is powered by the Metrics platform.</p></li>
 <li><p><strong>name</strong> (<em>str</em><em>, </em><em>optional</em>) – The variable name for use in formulas.</p></li>
 <li><p><strong>query</strong> (<em>str</em>) – A classic metrics query string.</p></li>
@@ -27087,7 +27087,7 @@ <h1 id="datadog-api-client-v2-model--page-root">datadog_api_client.v2.model<a cl
 <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>aggregator</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.metrics_aggregator.MetricsAggregator" title="datadog_api_client.v2.model.metrics_aggregator.MetricsAggregator"><em>MetricsAggregator</em></a>) – The type of aggregation that can be performed on metrics queries.</p></li>
+<li><p><strong>aggregator</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.metrics_aggregator.MetricsAggregator" title="datadog_api_client.v2.model.metrics_aggregator.MetricsAggregator"><em>MetricsAggregator</em></a>) – The type of aggregation that can be performed on metrics-based queries.</p></li>
 <li><p><strong>data_source</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.metrics_data_source.MetricsDataSource" title="datadog_api_client.v2.model.metrics_data_source.MetricsDataSource"><em>MetricsDataSource</em></a>) – A data source that is powered by the Metrics platform.</p></li>
 <li><p><strong>name</strong> (<em>str</em><em>, </em><em>optional</em>) – The variable name for use in formulas.</p></li>
 <li><p><strong>query</strong> (<em>str</em>) – A classic metrics query string.</p></li>