Regenerate client from commit 6003aae of spec repo

Author: ci.datadog-api-spec

.generator/schemas/v2/openapi.yaml

@@ -31063,9 +31063,17 @@ components:
           type: string
         values:
           description: |-
-            Column values in row order. The element type matches the column's `type`;
-            for example a `VARCHAR` column carries strings, a `TIMESTAMP` column carries
-            Unix-millisecond integers. `null` is allowed for missing values.
+            Column values in row order, one entry per result row. The element type
+            follows the column's `type`. The following serialization rules should be
+            taken into account:
+
+            - `BIGINT` values are encoded as JSON numbers in the signed 64-bit integer range.
+            - `DECIMAL` values are encoded as JSON numbers with 64-bit double precision.
+            - `TIMESTAMP` and `DATE` values are encoded as Unix-millisecond integers; a
+              `DATE` resolves to midnight UTC.
+            - `JSON` values are returned as a JSON-encoded string.
+
+            `null` is allowed for any column type where a value is missing.
           example:
             - web-store
             - checkout
@@ -44858,6 +44866,66 @@ components:
         type:
           $ref: "#/components/schemas/HistoricalJobDataType"
       type: object
+    HistoricalMetricsConfigurationAttributes:
+      description: Attributes of a historical metrics configuration.
+      properties:
+        created_at:
+          description: Timestamp when historical metrics ingestion was enabled for the metric.
+          example: "2024-01-15T12:00:00.000Z"
+          format: date-time
+          readOnly: true
+          type: string
+      type: object
+    HistoricalMetricsConfigurationCreateData:
+      description: Data object for enabling historical metrics ingestion for a metric.
+      properties:
+        id:
+          description: The metric name, used as the resource ID.
+          example: dd.test.metric
+          type: string
+        type:
+          $ref: "#/components/schemas/HistoricalMetricsConfigurationType"
+      required:
+        - id
+        - type
+      type: object
+    HistoricalMetricsConfigurationCreateRequest:
+      description: Request body for enabling historical metrics ingestion for a metric.
+      properties:
+        data:
+          $ref: "#/components/schemas/HistoricalMetricsConfigurationCreateData"
+      required:
+        - data
+      type: object
+    HistoricalMetricsConfigurationData:
+      description: >-
+        A historical metrics configuration resource object. Existence of this resource means historical metrics ingestion is enabled for the metric; there is no separate enabled attribute.
+      properties:
+        attributes:
+          $ref: "#/components/schemas/HistoricalMetricsConfigurationAttributes"
+        id:
+          description: The metric name, used as the resource ID.
+          example: dd.test.metric
+          type: string
+        type:
+          $ref: "#/components/schemas/HistoricalMetricsConfigurationType"
+      type: object
+    HistoricalMetricsConfigurationResponse:
+      description: Response containing a historical metrics configuration.
+      properties:
+        data:
+          $ref: "#/components/schemas/HistoricalMetricsConfigurationData"
+      readOnly: true
+      type: object
+    HistoricalMetricsConfigurationType:
+      default: historical_metrics_configurations
+      description: The historical metrics configuration resource type.
+      enum:
+        - historical_metrics_configurations
+      example: historical_metrics_configurations
+      type: string
+      x-enum-varnames:
+        - HISTORICAL_METRICS_CONFIGURATIONS
     HourlyUsage:
       description: Hourly usage for a product family for an org.
       properties:
@@ -135602,9 +135670,6 @@ paths:
       summary: Execute a tabular DDSQL query
       tags:
         - DDSQL
-      x-unstable: |-
-        **Note**: This endpoint is in preview and is subject to change.
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
   /api/v2/ddsql/query/tabular/fetch:
     post:
       description: |-
@@ -135713,9 +135778,6 @@ paths:
       summary: Fetch the result of a DDSQL query
       tags:
         - DDSQL
-      x-unstable: |-
-        **Note**: This endpoint is in preview and is subject to change.
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
   /api/v2/deletion/data/{product}:
     post:
       description: Creates a data deletion request by providing a query and a timeframe targeting the proper data.
@@ -159550,6 +159612,178 @@ paths:
         permissions:
           - metric_tags_write
       x-sunset: "2027-01-01"
+  /api/v2/metrics/historical-metrics-configurations:
+    post:
+      description: |-
+        Enable historical metrics ingestion (late data ingestion) for a metric. Idempotent:
+        enabling an already-enabled metric returns 200 instead of 201. Not supported for
+        distribution metrics, metrics with an existing tag configuration, or most standard
+        (non-custom) metrics.
+      operationId: CreateHistoricalMetricsConfiguration
+      requestBody:
+        content:
+          application/json:
+            examples:
+              default:
+                value:
+                  data:
+                    id: dd.test.metric
+                    type: historical_metrics_configurations
+            schema:
+              $ref: "#/components/schemas/HistoricalMetricsConfigurationCreateRequest"
+        required: true
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                default:
+                  value:
+                    data:
+                      attributes:
+                        created_at: "2024-01-15T12:00:00.000Z"
+                      id: dd.test.metric
+                      type: historical_metrics_configurations
+              schema:
+                $ref: "#/components/schemas/HistoricalMetricsConfigurationResponse"
+          description: OK
+        "201":
+          content:
+            application/json:
+              examples:
+                default:
+                  value:
+                    data:
+                      attributes:
+                        created_at: "2024-01-15T12:00:00.000Z"
+                      id: dd.test.metric
+                      type: historical_metrics_configurations
+              schema:
+                $ref: "#/components/schemas/HistoricalMetricsConfigurationResponse"
+          description: Created
+        "400":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Bad Request
+        "404":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Not Found
+        "422":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Unprocessable Entity
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+      security:
+        - apiKeyAuth: []
+          appKeyAuth: []
+        - AuthZ:
+            - late_metrics_config_write
+      summary: Enable historical metrics ingestion
+      tags:
+        - Metrics
+      x-codegen-request-body-name: body
+      "x-permission":
+        operator: OR
+        permissions:
+          - late_metrics_config_write
+      x-unstable: |-
+        **Note**: This endpoint is in preview and is subject to change.
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
+  /api/v2/metrics/historical-metrics-configurations/{metric_name}:
+    delete:
+      description: |-
+        Disable historical metrics ingestion for a metric. Idempotent: always returns 204,
+        whether or not the configuration existed or the metric itself still exists, so that
+        Terraform destroy succeeds for a metric removed out-of-band.
+      operationId: DeleteHistoricalMetricsConfiguration
+      parameters:
+        - $ref: "#/components/parameters/MetricName"
+      responses:
+        "204":
+          description: No Content
+        "400":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Bad Request
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+      security:
+        - apiKeyAuth: []
+          appKeyAuth: []
+        - AuthZ:
+            - late_metrics_config_write
+      summary: Delete a historical metrics configuration
+      tags:
+        - Metrics
+      "x-permission":
+        operator: OR
+        permissions:
+          - late_metrics_config_write
+      x-unstable: |-
+        **Note**: This endpoint is in preview and is subject to change.
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
+    get:
+      description: |-
+        Get the historical metrics ingestion configuration for a metric. Existence of the
+        resource means historical metrics ingestion is enabled; returns 404 when it is not
+        enabled for the metric.
+      operationId: GetHistoricalMetricsConfiguration
+      parameters:
+        - $ref: "#/components/parameters/MetricName"
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                default:
+                  value:
+                    data:
+                      attributes:
+                        created_at: "2024-01-15T12:00:00.000Z"
+                      id: dd.test.metric
+                      type: historical_metrics_configurations
+              schema:
+                $ref: "#/components/schemas/HistoricalMetricsConfigurationResponse"
+          description: OK
+        "400":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Bad Request
+        "404":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Not Found
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+      security:
+        - apiKeyAuth: []
+          appKeyAuth: []
+        - AuthZ:
+            - metrics_read
+      summary: Get a historical metrics configuration
+      tags:
+        - Metrics
+      "x-permission":
+        operator: OR
+        permissions:
+          - metrics_read
+      x-unstable: |-
+        **Note**: This endpoint is in preview and is subject to change.
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
   /api/v2/metrics/tag-indexing-rules:
     get:
       description: List tag indexing rules for an org, sorted by `rule_order`, with offset/limit pagination.

docs/datadog_api_client.v2.model.rst

@@ -17952,6 +17952,48 @@ datadog\_api\_client.v2.model.historical\_job\_response\_data module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.historical\_metrics\_configuration\_attributes module
+-----------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.historical_metrics_configuration_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.historical\_metrics\_configuration\_create\_data module
+-------------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.historical_metrics_configuration_create_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.historical\_metrics\_configuration\_create\_request module
+----------------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.historical_metrics_configuration_create_request
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.historical\_metrics\_configuration\_data module
+-----------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.historical_metrics_configuration_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.historical\_metrics\_configuration\_response module
+---------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.historical_metrics_configuration_response
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.historical\_metrics\_configuration\_type module
+-----------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.historical_metrics_configuration_type
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.hourly\_usage module
 --------------------------------------------------
 

examples/v2/metrics/CreateHistoricalMetricsConfiguration.py

@@ -0,0 +1,28 @@
+"""
+Enable historical metrics ingestion returns "OK" response
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.metrics_api import MetricsApi
+from datadog_api_client.v2.model.historical_metrics_configuration_create_data import (
+    HistoricalMetricsConfigurationCreateData,
+)
+from datadog_api_client.v2.model.historical_metrics_configuration_create_request import (
+    HistoricalMetricsConfigurationCreateRequest,
+)
+from datadog_api_client.v2.model.historical_metrics_configuration_type import HistoricalMetricsConfigurationType
+
+body = HistoricalMetricsConfigurationCreateRequest(
+    data=HistoricalMetricsConfigurationCreateData(
+        id="dd.test.metric",
+        type=HistoricalMetricsConfigurationType.HISTORICAL_METRICS_CONFIGURATIONS,
+    ),
+)
+
+configuration = Configuration()
+configuration.unstable_operations["create_historical_metrics_configuration"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = MetricsApi(api_client)
+    response = api_instance.create_historical_metrics_configuration(body=body)
+
+    print(response)

examples/v2/metrics/DeleteHistoricalMetricsConfiguration.py

@@ -0,0 +1,14 @@
+"""
+Delete a historical metrics configuration returns "No Content" response
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.metrics_api import MetricsApi
+
+configuration = Configuration()
+configuration.unstable_operations["delete_historical_metrics_configuration"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = MetricsApi(api_client)
+    api_instance.delete_historical_metrics_configuration(
+        metric_name="metric_name",
+    )

examples/v2/metrics/GetHistoricalMetricsConfiguration.py

@@ -0,0 +1,16 @@
+"""
+Get a historical metrics configuration returns "OK" response
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.metrics_api import MetricsApi
+
+configuration = Configuration()
+configuration.unstable_operations["get_historical_metrics_configuration"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = MetricsApi(api_client)
+    response = api_instance.get_historical_metrics_configuration(
+        metric_name="metric_name",
+    )
+
+    print(response)