Mark legacy non-FnF query fields and WidgetEvent as deprecated in dashboard spec + update Distribuition docs

src/datadog_api_client/v1/model/bar_chart_widget_request.py

@@ -159,7 +159,7 @@ def __init__(
         :param profile_metrics_query: The log query.
         :type profile_metrics_query: LogQueryDefinition, optional
 
-        :param q: Widget query.
+        :param q: Widget query. Deprecated - Use ``queries`` and ``formulas`` instead. **Deprecated**.
         :type q: str, optional
 
         :param queries: List of queries that can be returned directly or used in formulas.

src/datadog_api_client/v1/model/change_widget_request.py

@@ -176,7 +176,7 @@ def __init__(
         :param profile_metrics_query: The log query.
         :type profile_metrics_query: LogQueryDefinition, optional
 
-        :param q: Query definition.
+        :param q: Query definition. Deprecated - Use ``queries`` and ``formulas`` instead. **Deprecated**.
         :type q: str, optional
 
         :param queries: List of queries that can be returned directly or used in formulas.

src/datadog_api_client/v1/model/distribution_widget_request.py

@@ -168,7 +168,7 @@ def __init__(
         :param profile_metrics_query: The log query.
         :type profile_metrics_query: LogQueryDefinition, optional
 
-        :param q: Widget query.
+        :param q: Widget query. Deprecated - Use ``queries`` and ``formulas`` instead. **Deprecated**.
         :type q: str, optional
 
         :param queries: List of queries that can be returned directly or used in formulas.
@@ -177,7 +177,7 @@ def __init__(
         :param query: Query definition for Distribution Widget Histogram Request
         :type query: DistributionWidgetHistogramRequestQuery, optional
 
-        :param request_type: Request type for the histogram request.
+        :param request_type: Request type for distribution of point values for distribution metrics. Query space aggregator must be ``histogram:<metric name>`` for points distributions.
         :type request_type: WidgetHistogramRequestType, optional
 
         :param response_format: Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets.

src/datadog_api_client/v1/model/geomap_widget_request.py

@@ -139,7 +139,7 @@ def __init__(
         :param log_query: The log query.
         :type log_query: LogQueryDefinition, optional
 
-        :param q: The widget metrics query.
+        :param q: The widget metrics query. Deprecated - Use ``queries`` and ``formulas`` instead. **Deprecated**.
         :type q: str, optional
 
         :param queries: List of queries that can be returned directly or used in formulas.

src/datadog_api_client/v1/model/heat_map_widget_definition.py

@@ -103,7 +103,7 @@ def __init__(
         :param custom_links: List of custom links.
         :type custom_links: [WidgetCustomLink], optional
 
-        :param events: List of widget events.
+        :param events: List of widget events. Deprecated - Use ``overlay`` request type instead. **Deprecated**.
         :type events: [WidgetEvent], optional
 
         :param legend_size: Available legend sizes for a widget. Should be one of "0", "2", "4", "8", "16", or "auto".

src/datadog_api_client/v1/model/heat_map_widget_request.py

@@ -156,7 +156,7 @@ def __init__(
         :param profile_metrics_query: The log query.
         :type profile_metrics_query: LogQueryDefinition, optional
 
-        :param q: Widget query.
+        :param q: Widget query. Deprecated - Use ``queries`` and ``formulas`` instead. **Deprecated**.
         :type q: str, optional
 
         :param queries: List of queries that can be returned directly or used in formulas.
@@ -165,7 +165,7 @@ def __init__(
         :param query: A formula and functions metrics query.
         :type query: FormulaAndFunctionMetricQueryDefinition, optional
 
-        :param request_type: Request type for the histogram request.
+        :param request_type: Request type for distribution of point values for distribution metrics. Query space aggregator must be ``histogram:<metric name>`` for points distributions.
         :type request_type: WidgetHistogramRequestType, optional
 
         :param response_format: Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets.

src/datadog_api_client/v1/model/query_value_widget_request.py

@@ -157,7 +157,7 @@ def __init__(
         :param profile_metrics_query: The log query.
         :type profile_metrics_query: LogQueryDefinition, optional
 
-        :param q: TODO.
+        :param q: Widget query. Deprecated - Use ``queries`` and ``formulas`` instead. **Deprecated**.
         :type q: str, optional
 
         :param queries: List of queries that can be returned directly or used in formulas.

src/datadog_api_client/v1/model/split_graph_source_widget_definition.py

@@ -75,7 +75,7 @@ def __init__(self, **kwargs):
         :param has_search_bar: Controls the display of the search bar.
         :type has_search_bar: TableWidgetHasSearchBar, optional
 
-        :param events: List of widget events.
+        :param events: List of widget events. Deprecated - Use `overlay` request type instead.
         :type events: [WidgetEvent], optional
 
         :param legend_columns: Columns displayed in the legend.

src/datadog_api_client/v1/model/sunburst_widget_request.py

@@ -146,7 +146,7 @@ def __init__(
         :param profile_metrics_query: The log query.
         :type profile_metrics_query: LogQueryDefinition, optional
 
-        :param q: Widget query.
+        :param q: Widget query. Deprecated - Use ``queries`` and ``formulas`` instead. **Deprecated**.
         :type q: str, optional
 
         :param queries: List of queries that can be returned directly or used in formulas.

src/datadog_api_client/v1/model/table_widget_request.py

@@ -197,7 +197,7 @@ def __init__(
         :param profile_metrics_query: The log query.
         :type profile_metrics_query: LogQueryDefinition, optional
 
-        :param q: Query definition.
+        :param q: Query definition. Deprecated - Use ``queries`` and ``formulas`` instead. **Deprecated**.
         :type q: str, optional
 
         :param queries: List of queries that can be returned directly or used in formulas.

src/datadog_api_client/v1/model/timeseries_widget_definition.py

@@ -110,7 +110,7 @@ def __init__(
         :param custom_links: List of custom links.
         :type custom_links: [WidgetCustomLink], optional
 
-        :param events: List of widget events.
+        :param events: List of widget events. Deprecated - Use ``overlay`` request type instead. **Deprecated**.
         :type events: [WidgetEvent], optional
 
         :param legend_columns: Columns displayed in the legend.

src/datadog_api_client/v1/model/timeseries_widget_request.py

@@ -168,7 +168,7 @@ def __init__(
         :param profile_metrics_query: The log query.
         :type profile_metrics_query: LogQueryDefinition, optional
 
-        :param q: Widget query.
+        :param q: Widget query. Deprecated - Use ``queries`` and ``formulas`` instead. **Deprecated**.
         :type q: str, optional
 
         :param queries: List of queries that can be returned directly or used in formulas.

src/datadog_api_client/v1/model/toplist_widget_request.py

@@ -165,7 +165,7 @@ def __init__(
         :param profile_metrics_query: The log query.
         :type profile_metrics_query: LogQueryDefinition, optional
 
-        :param q: Widget query.
+        :param q: Widget query. Deprecated - Use ``queries`` and ``formulas`` instead. **Deprecated**.
         :type q: str, optional
 
         :param queries: List of queries that can be returned directly or used in formulas.

src/datadog_api_client/v1/model/tree_map_widget_request.py

@@ -89,7 +89,7 @@ def __init__(
         :param formulas: List of formulas that operate on queries.
         :type formulas: [WidgetFormula], optional
 
-        :param q: The widget metrics query.
+        :param q: The widget metrics query. Deprecated - Use ``queries`` and ``formulas`` instead. **Deprecated**.
         :type q: str, optional
 
         :param queries: List of queries that can be returned directly or used in formulas.

src/datadog_api_client/v1/model/widget_definition.py

@@ -120,7 +120,7 @@ def __init__(self, **kwargs):
         :param widgets: List of widget groups.
         :type widgets: [Widget]
 
-        :param events: List of widget events.
+        :param events: List of widget events. Deprecated - Use `overlay` request type instead.
         :type events: [WidgetEvent], optional
 
         :param no_group_hosts: Whether to show the hosts that don’t fit in a group.

src/datadog_api_client/v1/model/widget_histogram_request_type.py

@@ -14,7 +14,7 @@
 
 class WidgetHistogramRequestType(ModelSimple):
     """
-    Request type for the histogram request.
+    Request type for distribution of point values for distribution metrics. Query space aggregator must be `histogram:<metric name>` for points distributions.
 
     :param value: If omitted defaults to "histogram". Must be one of ["histogram"].
     :type value: str