Regenerate client from commit eb891a2 of spec repo

Author: ci.datadog-api-spec

.generator/schemas/v2/openapi.yaml

@@ -38523,6 +38523,8 @@ components:
       properties:
         id:
           $ref: '#/components/schemas/MetricName'
+        relationships:
+          $ref: '#/components/schemas/MetricRelationships'
         type:
           $ref: '#/components/schemas/MetricType'
       type: object
@@ -39298,6 +39300,12 @@ components:
           format: double
           type: number
       type: object
+    MetricRelationships:
+      description: Relationships to related metric objects.
+      properties:
+        metric_volumes:
+          $ref: '#/components/schemas/MetricVolumesRelationship'
+      type: object
     MetricResource:
       description: Metric resource.
       example:
@@ -39741,13 +39749,55 @@ components:
       oneOf:
       - $ref: '#/components/schemas/MetricDistinctVolume'
       - $ref: '#/components/schemas/MetricIngestedIndexedVolume'
+    MetricVolumesInclude:
+      description: Relationship data to include in the response.
+      enum:
+      - metric_volumes
+      type: string
+      x-enum-varnames:
+      - METRIC_VOLUMES
+    MetricVolumesRelationship:
+      description: Relationship to a metric's ingested and indexed volumes.
+      properties:
+        data:
+          $ref: '#/components/schemas/MetricVolumesRelationshipData'
+      type: object
+    MetricVolumesRelationshipData:
+      description: Relationship data for a metric's ingested and indexed volumes.
+      properties:
+        id:
+          $ref: '#/components/schemas/MetricName'
+        type:
+          $ref: '#/components/schemas/MetricIngestedIndexedVolumeType'
+      required:
+      - type
+      - id
+      type: object
     MetricVolumesResponse:
       description: Response object which includes a single metric's volume.
       properties:
         data:
           $ref: '#/components/schemas/MetricVolumes'
       readOnly: true
       type: object
+    MetricVolumesSort:
+      description: 'Sort metrics by ingested or indexed volume. Use `-` for descending
+        order.
+
+        Supported values: `metric_volumes.indexed_volume`, `-metric_volumes.indexed_volume`,
+
+        `metric_volumes.ingested_volume`, `-metric_volumes.ingested_volume`.'
+      enum:
+      - metric_volumes.indexed_volume
+      - -metric_volumes.indexed_volume
+      - metric_volumes.ingested_volume
+      - -metric_volumes.ingested_volume
+      type: string
+      x-enum-varnames:
+      - METRIC_VOLUMES_INDEXED_VOLUME
+      - NOT_METRIC_VOLUMES_INDEXED_VOLUME
+      - METRIC_VOLUMES_INGESTED_VOLUME
+      - NOT_METRIC_VOLUMES_INGESTED_VOLUME
     MetricsAggregator:
       default: avg
       description: The type of aggregation that can be performed on metrics-based
@@ -39787,6 +39837,12 @@ components:
           items:
             $ref: '#/components/schemas/MetricsAndMetricTagConfigurations'
           type: array
+        included:
+          description: Array of included metric volume objects. Only present when
+            `include=metric_volumes` is requested.
+          items:
+            $ref: '#/components/schemas/MetricIngestedIndexedVolume'
+          type: array
         links:
           $ref: '#/components/schemas/MetricsListResponseLinks'
         meta:
@@ -91450,7 +91506,10 @@ paths:
         `next_cursor` value from the response as the new `page[cursor]` value.
 
         Once the `meta.pagination.next_cursor` value is null, all pages have been
-        retrieved.'
+        retrieved.
+
+        Use `include=metric_volumes` to fetch indexed and ingested volume data for
+        each metric, and `sort` to order results by volume.'
       operationId: ListTagConfigurations
       parameters:
       - description: Filter custom metrics that have configured tags.
@@ -91532,6 +91591,28 @@ paths:
         required: false
         schema:
           type: boolean
+      - description: Relationship data to include in the response. Use `metric_volumes`
+          to include indexed and ingested volumes.
+        example: metric_volumes
+        in: query
+        name: include
+        required: false
+        schema:
+          $ref: '#/components/schemas/MetricVolumesInclude'
+      - description: 'Sort metrics by ingested or indexed volume. Use `-` for descending
+          order.
+
+          Supported values: `metric_volumes.indexed_volume`, `-metric_volumes.indexed_volume`,
+
+          `metric_volumes.ingested_volume`, `-metric_volumes.ingested_volume`.
+
+          Only supported when `include=metric_volumes` is provided.'
+        example: -metric_volumes.indexed_volume
+        in: query
+        name: sort
+        required: false
+        schema:
+          $ref: '#/components/schemas/MetricVolumesSort'
       - description: 'The number of seconds of look back (from now) to apply to a
           filter[tag] or filter[queried] query.
 

docs/datadog_api_client.v2.model.rst

@@ -17126,6 +17126,13 @@ datadog\_api\_client.v2.model.metric\_point module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.metric\_relationships module
+----------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.metric_relationships
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.metric\_resource module
 -----------------------------------------------------
 
@@ -17308,13 +17315,41 @@ datadog\_api\_client.v2.model.metric\_volumes module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.metric\_volumes\_include module
+-------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.metric_volumes_include
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.metric\_volumes\_relationship module
+------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.metric_volumes_relationship
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.metric\_volumes\_relationship\_data module
+------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.metric_volumes_relationship_data
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.metric\_volumes\_response module
 --------------------------------------------------------------
 
 .. automodule:: datadog_api_client.v2.model.metric_volumes_response
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.metric\_volumes\_sort module
+----------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.metric_volumes_sort
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.metrics\_aggregator module
 --------------------------------------------------------
 

src/datadog_api_client/v2/api/metrics_api.py

@@ -20,6 +20,8 @@
 from datadog_api_client.v2.model.metric_tag_configuration_metric_type_category import (
     MetricTagConfigurationMetricTypeCategory,
 )
+from datadog_api_client.v2.model.metric_volumes_include import MetricVolumesInclude
+from datadog_api_client.v2.model.metric_volumes_sort import MetricVolumesSort
 from datadog_api_client.v2.model.metrics_and_metric_tag_configurations import MetricsAndMetricTagConfigurations
 from datadog_api_client.v2.model.metric_bulk_tag_config_response import MetricBulkTagConfigResponse
 from datadog_api_client.v2.model.metric_bulk_tag_config_delete_request import MetricBulkTagConfigDeleteRequest
@@ -366,6 +368,16 @@ def __init__(self, api_client=None):
                     "attribute": "filter[related_assets]",
                     "location": "query",
                 },
+                "include": {
+                    "openapi_types": (MetricVolumesInclude,),
+                    "attribute": "include",
+                    "location": "query",
+                },
+                "sort": {
+                    "openapi_types": (MetricVolumesSort,),
+                    "attribute": "sort",
+                    "location": "query",
+                },
                 "window_seconds": {
                     "openapi_types": (int,),
                     "attribute": "window[seconds]",
@@ -782,6 +794,8 @@ def list_tag_configurations(
         filter_queried_window_seconds: Union[int, UnsetType] = unset,
         filter_tags: Union[str, UnsetType] = unset,
         filter_related_assets: Union[bool, UnsetType] = unset,
+        include: Union[MetricVolumesInclude, UnsetType] = unset,
+        sort: Union[MetricVolumesSort, UnsetType] = unset,
         window_seconds: Union[int, UnsetType] = unset,
         page_size: Union[int, UnsetType] = unset,
         page_cursor: Union[str, UnsetType] = unset,
@@ -792,6 +806,7 @@ def list_tag_configurations(
         Optionally, paginate by using the ``page[cursor]`` and/or ``page[size]`` query parameters.
         To fetch the first page, pass in a query parameter with either a valid ``page[size]`` or an empty cursor like ``page[cursor]=``. To fetch the next page, pass in the ``next_cursor`` value from the response as the new ``page[cursor]`` value.
         Once the ``meta.pagination.next_cursor`` value is null, all pages have been retrieved.
+        Use ``include=metric_volumes`` to fetch indexed and ingested volume data for each metric, and ``sort`` to order results by volume.
 
         :param filter_configured: Filter custom metrics that have configured tags.
         :type filter_configured: bool, optional
@@ -816,6 +831,13 @@ def list_tag_configurations(
         :type filter_tags: str, optional
         :param filter_related_assets: (Preview) Filter metrics that are used in dashboards, monitors, notebooks, SLOs.
         :type filter_related_assets: bool, optional
+        :param include: Relationship data to include in the response. Use ``metric_volumes`` to include indexed and ingested volumes.
+        :type include: MetricVolumesInclude, optional
+        :param sort: Sort metrics by ingested or indexed volume. Use ``-`` for descending order.
+            Supported values: ``metric_volumes.indexed_volume`` , ``-metric_volumes.indexed_volume`` ,
+            ``metric_volumes.ingested_volume`` , ``-metric_volumes.ingested_volume``.
+            Only supported when ``include=metric_volumes`` is provided.
+        :type sort: MetricVolumesSort, optional
         :param window_seconds: The number of seconds of look back (from now) to apply to a filter[tag] or filter[queried] query.
             Default value is 3600 (1 hour), maximum value is 5,184,000 (60 days).
         :type window_seconds: int, optional
@@ -852,6 +874,12 @@ def list_tag_configurations(
         if filter_related_assets is not unset:
             kwargs["filter_related_assets"] = filter_related_assets
 
+        if include is not unset:
+            kwargs["include"] = include
+
+        if sort is not unset:
+            kwargs["sort"] = sort
+
         if window_seconds is not unset:
             kwargs["window_seconds"] = window_seconds
 
@@ -874,6 +902,8 @@ def list_tag_configurations_with_pagination(
         filter_queried_window_seconds: Union[int, UnsetType] = unset,
         filter_tags: Union[str, UnsetType] = unset,
         filter_related_assets: Union[bool, UnsetType] = unset,
+        include: Union[MetricVolumesInclude, UnsetType] = unset,
+        sort: Union[MetricVolumesSort, UnsetType] = unset,
         window_seconds: Union[int, UnsetType] = unset,
         page_size: Union[int, UnsetType] = unset,
         page_cursor: Union[str, UnsetType] = unset,
@@ -905,6 +935,13 @@ def list_tag_configurations_with_pagination(
         :type filter_tags: str, optional
         :param filter_related_assets: (Preview) Filter metrics that are used in dashboards, monitors, notebooks, SLOs.
         :type filter_related_assets: bool, optional
+        :param include: Relationship data to include in the response. Use ``metric_volumes`` to include indexed and ingested volumes.
+        :type include: MetricVolumesInclude, optional
+        :param sort: Sort metrics by ingested or indexed volume. Use ``-`` for descending order.
+            Supported values: ``metric_volumes.indexed_volume`` , ``-metric_volumes.indexed_volume`` ,
+            ``metric_volumes.ingested_volume`` , ``-metric_volumes.ingested_volume``.
+            Only supported when ``include=metric_volumes`` is provided.
+        :type sort: MetricVolumesSort, optional
         :param window_seconds: The number of seconds of look back (from now) to apply to a filter[tag] or filter[queried] query.
             Default value is 3600 (1 hour), maximum value is 5,184,000 (60 days).
         :type window_seconds: int, optional
@@ -943,6 +980,12 @@ def list_tag_configurations_with_pagination(
         if filter_related_assets is not unset:
             kwargs["filter_related_assets"] = filter_related_assets
 
+        if include is not unset:
+            kwargs["include"] = include
+
+        if sort is not unset:
+            kwargs["sort"] = sort
+
         if window_seconds is not unset:
             kwargs["window_seconds"] = window_seconds
 

src/datadog_api_client/v2/model/metric.py

@@ -14,36 +14,51 @@
 
 
 if TYPE_CHECKING:
+    from datadog_api_client.v2.model.metric_relationships import MetricRelationships
     from datadog_api_client.v2.model.metric_type import MetricType
 
 
 class Metric(ModelNormal):
     @cached_property
     def openapi_types(_):
+        from datadog_api_client.v2.model.metric_relationships import MetricRelationships
         from datadog_api_client.v2.model.metric_type import MetricType
 
         return {
             "id": (str,),
+            "relationships": (MetricRelationships,),
             "type": (MetricType,),
         }
 
     attribute_map = {
         "id": "id",
+        "relationships": "relationships",
         "type": "type",
     }
 
-    def __init__(self_, id: Union[str, UnsetType] = unset, type: Union[MetricType, UnsetType] = unset, **kwargs):
+    def __init__(
+        self_,
+        id: Union[str, UnsetType] = unset,
+        relationships: Union[MetricRelationships, UnsetType] = unset,
+        type: Union[MetricType, UnsetType] = unset,
+        **kwargs,
+    ):
         """
         Object for a single metric tag configuration.
 
         :param id: The metric name for this resource.
         :type id: str, optional
 
+        :param relationships: Relationships to related metric objects.
+        :type relationships: MetricRelationships, optional
+
         :param type: The metric resource type.
         :type type: MetricType, optional
         """
         if id is not unset:
             kwargs["id"] = id
+        if relationships is not unset:
+            kwargs["relationships"] = relationships
         if type is not unset:
             kwargs["type"] = type
         super().__init__(kwargs)

src/datadog_api_client/v2/model/metric_relationships.py

@@ -0,0 +1,42 @@
+# 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 Union, TYPE_CHECKING
+
+from datadog_api_client.model_utils import (
+    ModelNormal,
+    cached_property,
+    unset,
+    UnsetType,
+)
+
+
+if TYPE_CHECKING:
+    from datadog_api_client.v2.model.metric_volumes_relationship import MetricVolumesRelationship
+
+
+class MetricRelationships(ModelNormal):
+    @cached_property
+    def openapi_types(_):
+        from datadog_api_client.v2.model.metric_volumes_relationship import MetricVolumesRelationship
+
+        return {
+            "metric_volumes": (MetricVolumesRelationship,),
+        }
+
+    attribute_map = {
+        "metric_volumes": "metric_volumes",
+    }
+
+    def __init__(self_, metric_volumes: Union[MetricVolumesRelationship, UnsetType] = unset, **kwargs):
+        """
+        Relationships to related metric objects.
+
+        :param metric_volumes: Relationship to a metric's ingested and indexed volumes.
+        :type metric_volumes: MetricVolumesRelationship, optional
+        """
+        if metric_volumes is not unset:
+            kwargs["metric_volumes"] = metric_volumes
+        super().__init__(kwargs)