Regenerate client from commit d764cf5 of spec repo

Author: ci.datadog-api-spec

.generator/schemas/v1/openapi.yaml

@@ -2962,10 +2962,7 @@ components:
         data_source:
           $ref: '#/components/schemas/FormulaAndFunctionEventsDataSource'
         group_by:
-          description: Group by options.
-          items:
-            $ref: '#/components/schemas/FormulaAndFunctionEventQueryGroupBy'
-          type: array
+          $ref: '#/components/schemas/FormulaAndFunctionEventQueryGroupByConfig'
         indexes:
           description: An array of index names to query in the stream. Omit or use
             `[]` to query all indexes at once.
@@ -3037,6 +3034,39 @@ components:
       required:
       - facet
       type: object
+    FormulaAndFunctionEventQueryGroupByConfig:
+      description: Group by configuration for an events query. Can be a nested array
+        of facet objects or a flat object with a list of fields.
+      oneOf:
+      - $ref: '#/components/schemas/FormulaAndFunctionEventQueryGroupByList'
+      - $ref: '#/components/schemas/FormulaAndFunctionEventQueryGroupByFields'
+    FormulaAndFunctionEventQueryGroupByFields:
+      description: Flat group by using multiple event facets.
+      properties:
+        fields:
+          description: List of event facets to group by.
+          example:
+          - hostname
+          - service
+          items:
+            description: Event facet.
+            type: string
+          type: array
+        limit:
+          description: Number of groups to return.
+          example: 10
+          format: int64
+          type: integer
+        sort:
+          $ref: '#/components/schemas/FormulaAndFunctionEventQueryGroupBySort'
+      required:
+      - fields
+      type: object
+    FormulaAndFunctionEventQueryGroupByList:
+      description: Nested group by using a list of facet objects.
+      items:
+        $ref: '#/components/schemas/FormulaAndFunctionEventQueryGroupBy'
+      type: array
     FormulaAndFunctionEventQueryGroupBySort:
       description: Options for sorting group by results.
       properties:

docs/datadog_api_client.v1.model.rst

@@ -928,6 +928,20 @@ datadog\_api\_client.v1.model.formula\_and\_function\_event\_query\_group\_by mo
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v1.model.formula\_and\_function\_event\_query\_group\_by\_config module
+--------------------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v1.model.formula_and_function_event_query_group_by_config
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v1.model.formula\_and\_function\_event\_query\_group\_by\_fields module
+--------------------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v1.model.formula_and_function_event_query_group_by_fields
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v1.model.formula\_and\_function\_event\_query\_group\_by\_sort module
 ------------------------------------------------------------------------------------------
 

src/datadog_api_client/v1/model/distribution_widget_histogram_request_query.py

@@ -36,8 +36,8 @@ def __init__(self, **kwargs):
         :param compute: Compute options.
         :type compute: FormulaAndFunctionEventQueryDefinitionCompute
 
-        :param group_by: Group by options.
-        :type group_by: [FormulaAndFunctionEventQueryGroupBy], optional
+        :param group_by: Group by configuration for an events query. Can be a nested array of facet objects or a flat object with a list of fields.
+        :type group_by: FormulaAndFunctionEventQueryGroupByConfig, optional
 
         :param indexes: An array of index names to query in the stream. Omit or use `[]` to query all indexes at once.
         :type indexes: [str], optional

src/datadog_api_client/v1/model/formula_and_function_event_query_definition.py

@@ -18,12 +18,18 @@
         FormulaAndFunctionEventQueryDefinitionCompute,
     )
     from datadog_api_client.v1.model.formula_and_function_events_data_source import FormulaAndFunctionEventsDataSource
-    from datadog_api_client.v1.model.formula_and_function_event_query_group_by import (
-        FormulaAndFunctionEventQueryGroupBy,
+    from datadog_api_client.v1.model.formula_and_function_event_query_group_by_config import (
+        FormulaAndFunctionEventQueryGroupByConfig,
     )
     from datadog_api_client.v1.model.formula_and_function_event_query_definition_search import (
         FormulaAndFunctionEventQueryDefinitionSearch,
     )
+    from datadog_api_client.v1.model.formula_and_function_event_query_group_by import (
+        FormulaAndFunctionEventQueryGroupBy,
+    )
+    from datadog_api_client.v1.model.formula_and_function_event_query_group_by_fields import (
+        FormulaAndFunctionEventQueryGroupByFields,
+    )
 
 
 class FormulaAndFunctionEventQueryDefinition(ModelNormal):
@@ -41,8 +47,8 @@ def openapi_types(_):
         from datadog_api_client.v1.model.formula_and_function_events_data_source import (
             FormulaAndFunctionEventsDataSource,
         )
-        from datadog_api_client.v1.model.formula_and_function_event_query_group_by import (
-            FormulaAndFunctionEventQueryGroupBy,
+        from datadog_api_client.v1.model.formula_and_function_event_query_group_by_config import (
+            FormulaAndFunctionEventQueryGroupByConfig,
         )
         from datadog_api_client.v1.model.formula_and_function_event_query_definition_search import (
             FormulaAndFunctionEventQueryDefinitionSearch,
@@ -52,7 +58,7 @@ def openapi_types(_):
             "compute": (FormulaAndFunctionEventQueryDefinitionCompute,),
             "cross_org_uuids": ([str],),
             "data_source": (FormulaAndFunctionEventsDataSource,),
-            "group_by": ([FormulaAndFunctionEventQueryGroupBy],),
+            "group_by": (FormulaAndFunctionEventQueryGroupByConfig,),
             "indexes": ([str],),
             "name": (str,),
             "search": (FormulaAndFunctionEventQueryDefinitionSearch,),
@@ -76,7 +82,12 @@ def __init__(
         data_source: FormulaAndFunctionEventsDataSource,
         name: str,
         cross_org_uuids: Union[List[str], UnsetType] = unset,
-        group_by: Union[List[FormulaAndFunctionEventQueryGroupBy], UnsetType] = unset,
+        group_by: Union[
+            FormulaAndFunctionEventQueryGroupByConfig,
+            List[FormulaAndFunctionEventQueryGroupBy],
+            FormulaAndFunctionEventQueryGroupByFields,
+            UnsetType,
+        ] = unset,
         indexes: Union[List[str], UnsetType] = unset,
         search: Union[FormulaAndFunctionEventQueryDefinitionSearch, UnsetType] = unset,
         storage: Union[str, UnsetType] = unset,
@@ -94,8 +105,8 @@ def __init__(
         :param data_source: Data source for event platform-based queries.
         :type data_source: FormulaAndFunctionEventsDataSource
 
-        :param group_by: Group by options.
-        :type group_by: [FormulaAndFunctionEventQueryGroupBy], optional
+        :param group_by: Group by configuration for an events query. Can be a nested array of facet objects or a flat object with a list of fields.
+        :type group_by: FormulaAndFunctionEventQueryGroupByConfig, optional
 
         :param indexes: An array of index names to query in the stream. Omit or use ``[]`` to query all indexes at once.
         :type indexes: [str], optional

src/datadog_api_client/v1/model/formula_and_function_event_query_group_by_config.py

@@ -0,0 +1,50 @@
+# Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+# This product includes software developed at Datadog (https://www.datadoghq.com/).
+# Copyright 2019-Present Datadog, Inc.
+from __future__ import annotations
+
+
+from datadog_api_client.model_utils import (
+    ModelComposed,
+    cached_property,
+)
+
+
+class FormulaAndFunctionEventQueryGroupByConfig(ModelComposed):
+    def __init__(self, **kwargs):
+        """
+        Group by configuration for an events query. Can be a nested array of facet objects or a flat object with a list of fields.
+
+        :param fields: List of event facets to group by.
+        :type fields: [str]
+
+        :param limit: Number of groups to return.
+        :type limit: int, optional
+
+        :param sort: Options for sorting group by results.
+        :type sort: FormulaAndFunctionEventQueryGroupBySort, optional
+        """
+        super().__init__(kwargs)
+
+    @cached_property
+    def _composed_schemas(_):
+        # we need this here to make our import statements work
+        # we must store _composed_schemas in here so the code is only run
+        # when we invoke this method. If we kept this at the class
+        # level we would get an error because the class level
+        # code would be run when this module is imported, and these composed
+        # classes don't exist yet because their module has not finished
+        # loading
+        from datadog_api_client.v1.model.formula_and_function_event_query_group_by import (
+            FormulaAndFunctionEventQueryGroupBy,
+        )
+        from datadog_api_client.v1.model.formula_and_function_event_query_group_by_fields import (
+            FormulaAndFunctionEventQueryGroupByFields,
+        )
+
+        return {
+            "oneOf": [
+                [FormulaAndFunctionEventQueryGroupBy],
+                FormulaAndFunctionEventQueryGroupByFields,
+            ],
+        }

src/datadog_api_client/v1/model/formula_and_function_event_query_group_by_fields.py

@@ -0,0 +1,66 @@
+# Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+# This product includes software developed at Datadog (https://www.datadoghq.com/).
+# Copyright 2019-Present Datadog, Inc.
+from __future__ import annotations
+
+from typing import List, Union, TYPE_CHECKING
+
+from datadog_api_client.model_utils import (
+    ModelNormal,
+    cached_property,
+    unset,
+    UnsetType,
+)
+
+
+if TYPE_CHECKING:
+    from datadog_api_client.v1.model.formula_and_function_event_query_group_by_sort import (
+        FormulaAndFunctionEventQueryGroupBySort,
+    )
+
+
+class FormulaAndFunctionEventQueryGroupByFields(ModelNormal):
+    @cached_property
+    def openapi_types(_):
+        from datadog_api_client.v1.model.formula_and_function_event_query_group_by_sort import (
+            FormulaAndFunctionEventQueryGroupBySort,
+        )
+
+        return {
+            "fields": ([str],),
+            "limit": (int,),
+            "sort": (FormulaAndFunctionEventQueryGroupBySort,),
+        }
+
+    attribute_map = {
+        "fields": "fields",
+        "limit": "limit",
+        "sort": "sort",
+    }
+
+    def __init__(
+        self_,
+        fields: List[str],
+        limit: Union[int, UnsetType] = unset,
+        sort: Union[FormulaAndFunctionEventQueryGroupBySort, UnsetType] = unset,
+        **kwargs,
+    ):
+        """
+        Flat group by using multiple event facets.
+
+        :param fields: List of event facets to group by.
+        :type fields: [str]
+
+        :param limit: Number of groups to return.
+        :type limit: int, optional
+
+        :param sort: Options for sorting group by results.
+        :type sort: FormulaAndFunctionEventQueryGroupBySort, optional
+        """
+        if limit is not unset:
+            kwargs["limit"] = limit
+        if sort is not unset:
+            kwargs["sort"] = sort
+        super().__init__(kwargs)
+
+        self_.fields = fields

src/datadog_api_client/v1/model/formula_and_function_query_definition.py

@@ -36,8 +36,8 @@ def __init__(self, **kwargs):
         :param compute: Compute options.
         :type compute: FormulaAndFunctionEventQueryDefinitionCompute
 
-        :param group_by: Group by options.
-        :type group_by: [FormulaAndFunctionEventQueryGroupBy], optional
+        :param group_by: Group by configuration for an events query. Can be a nested array of facet objects or a flat object with a list of fields.
+        :type group_by: FormulaAndFunctionEventQueryGroupByConfig, optional
 
         :param indexes: An array of index names to query in the stream. Omit or use `[]` to query all indexes at once.
         :type indexes: [str], optional

src/datadog_api_client/v1/models/__init__.py

@@ -154,6 +154,12 @@
     FormulaAndFunctionEventQueryDefinitionSearch,
 )
 from datadog_api_client.v1.model.formula_and_function_event_query_group_by import FormulaAndFunctionEventQueryGroupBy
+from datadog_api_client.v1.model.formula_and_function_event_query_group_by_config import (
+    FormulaAndFunctionEventQueryGroupByConfig,
+)
+from datadog_api_client.v1.model.formula_and_function_event_query_group_by_fields import (
+    FormulaAndFunctionEventQueryGroupByFields,
+)
 from datadog_api_client.v1.model.formula_and_function_event_query_group_by_sort import (
     FormulaAndFunctionEventQueryGroupBySort,
 )
@@ -1283,6 +1289,8 @@
     "FormulaAndFunctionEventQueryDefinitionCompute",
     "FormulaAndFunctionEventQueryDefinitionSearch",
     "FormulaAndFunctionEventQueryGroupBy",
+    "FormulaAndFunctionEventQueryGroupByConfig",
+    "FormulaAndFunctionEventQueryGroupByFields",
     "FormulaAndFunctionEventQueryGroupBySort",
     "FormulaAndFunctionEventsDataSource",
     "FormulaAndFunctionMetricAggregation",