Update UA API docs to reflect deprecated values for estimated usage types (#2509)

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

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

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-07-08 19:08:06.298818",
-            "spec_repo_commit": "7b042e12"
+            "regenerated": "2025-07-09 16:47:17.991240",
+            "spec_repo_commit": "d0906173"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-07-08 19:08:06.315210",
-            "spec_repo_commit": "7b042e12"
+            "regenerated": "2025-07-09 16:47:18.007275",
+            "spec_repo_commit": "d0906173"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -4171,7 +4171,10 @@ components:
           type: array
       type: object
     HourlyUsageAttributionUsageType:
-      description: Supported products for hourly usage attribution requests.
+      description: 'Supported products for hourly usage attribution requests.
+
+        The following values have been **deprecated**: `estimated_indexed_spans_usage`,
+        `estimated_ingested_spans_usage`.'
       enum:
       - api_usage
       - apm_fargate_usage
@@ -8535,7 +8538,10 @@ components:
       - SCA_FARGATE_PERCENTAGE
       - ALL
     MonthlyUsageAttributionValues:
-      description: Fields in Usage Summary by tag(s).
+      description: 'Fields in Usage Summary by tag(s).
+
+        The following values have been **deprecated**: `estimated_indexed_spans_usage`,
+        `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`, `estimated_ingested_spans_percentage`.'
       properties:
         api_percentage:
           description: The percentage of synthetic API test usage by tag(s).
@@ -35406,7 +35412,9 @@ paths:
         schema:
           format: date-time
           type: string
-      - description: Usage type to retrieve.
+      - description: 'Usage type to retrieve. The following values have been **deprecated**:
+
+          `estimated_indexed_spans_usage`, `estimated_ingested_spans_usage`.'
         in: query
         name: usage_type
         required: true
@@ -35956,8 +35964,13 @@ paths:
         schema:
           format: date-time
           type: string
-      - description: Comma-separated list of usage types to return, or `*` for all
+      - description: 'Comma-separated list of usage types to return, or `*` for all
           usage types.
+
+          The following values have been **deprecated**:
+
+          `estimated_indexed_spans_usage`, `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`,
+          `estimated_ingested_spans_percentage`.'
         in: query
         name: fields
         required: true
@@ -35969,7 +35982,12 @@ paths:
         required: false
         schema:
           $ref: '#/components/schemas/UsageSortDirection'
-      - description: The field to sort by.
+      - description: 'The field to sort by.
+
+          The following values have been **deprecated**:
+
+          `estimated_indexed_spans_usage`, `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`,
+          `estimated_ingested_spans_percentage`.'
         in: query
         name: sort_name
         required: false

lib/datadog_api_client/v1/api/usage_metering_api.rb

@@ -131,7 +131,7 @@ def get_hourly_usage_attribution(start_hr, usage_type, opts = {})
     # ```
     #
     # @param start_hr [Time] Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]` for usage beginning at this hour.
-    # @param usage_type [HourlyUsageAttributionUsageType] Usage type to retrieve.
+    # @param usage_type [HourlyUsageAttributionUsageType] Usage type to retrieve. The following values have been **deprecated**: `estimated_indexed_spans_usage`, `estimated_ingested_spans_usage`.
     # @param opts [Hash] the optional parameters
     # @option opts [Time] :end_hr Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]` for usage ending **before** this hour.
     # @option opts [String] :next_record_id List following results with a next_record_id provided in the previous query.
@@ -455,11 +455,11 @@ def get_monthly_usage_attribution(start_month, fields, opts = {})
     # ```
     #
     # @param start_month [Time] Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for usage beginning in this month. Maximum of 15 months ago.
-    # @param fields [MonthlyUsageAttributionSupportedMetrics] Comma-separated list of usage types to return, or `*` for all usage types.
+    # @param fields [MonthlyUsageAttributionSupportedMetrics] Comma-separated list of usage types to return, or `*` for all usage types. The following values have been **deprecated**: `estimated_indexed_spans_usage`, `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`, `estimated_ingested_spans_percentage`.
     # @param opts [Hash] the optional parameters
     # @option opts [Time] :end_month Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for usage ending this month.
     # @option opts [UsageSortDirection] :sort_direction The direction to sort by: `[desc, asc]`.
-    # @option opts [MonthlyUsageAttributionSupportedMetrics] :sort_name The field to sort by.
+    # @option opts [MonthlyUsageAttributionSupportedMetrics] :sort_name The field to sort by. The following values have been **deprecated**: `estimated_indexed_spans_usage`, `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`, `estimated_ingested_spans_percentage`.
     # @option opts [String] :tag_breakdown_keys Comma separated list of tag keys used to group usage. If no value is provided the usage will not be broken down by tags.  To see which tags are available, look for the value of `tag_config_source` in the API response.
     # @option opts [String] :next_record_id List following results with a next_record_id provided in the previous query.
     # @option opts [Boolean] :include_descendants Include child org usage in the response. Defaults to `true`.

lib/datadog_api_client/v1/models/hourly_usage_attribution_body.rb

@@ -50,6 +50,7 @@ class HourlyUsageAttributionBody
     attr_accessor :updated_at
 
     # Supported products for hourly usage attribution requests.
+    # The following values have been **deprecated**: `estimated_indexed_spans_usage`, `estimated_ingested_spans_usage`.
     attr_accessor :usage_type
 
     attr_accessor :additional_properties

lib/datadog_api_client/v1/models/hourly_usage_attribution_usage_type.rb

@@ -18,6 +18,7 @@
 
 module DatadogAPIClient::V1
   # Supported products for hourly usage attribution requests.
+  # The following values have been **deprecated**: `estimated_indexed_spans_usage`, `estimated_ingested_spans_usage`.
   class HourlyUsageAttributionUsageType
     include BaseEnumModel
 

lib/datadog_api_client/v1/models/monthly_usage_attribution_body.rb

@@ -47,6 +47,7 @@ class MonthlyUsageAttributionBody
     attr_accessor :updated_at
 
     # Fields in Usage Summary by tag(s).
+    # The following values have been **deprecated**: `estimated_indexed_spans_usage`, `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`, `estimated_ingested_spans_percentage`.
     attr_accessor :values
 
     attr_accessor :additional_properties

lib/datadog_api_client/v1/models/monthly_usage_attribution_values.rb

@@ -18,6 +18,7 @@
 
 module DatadogAPIClient::V1
   # Fields in Usage Summary by tag(s).
+  # The following values have been **deprecated**: `estimated_indexed_spans_usage`, `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`, `estimated_ingested_spans_percentage`.
   class MonthlyUsageAttributionValues
     include BaseGenericModel