Regenerate client from commit b5e5ace of spec repo (#3055)

api-clients-generation-pipeline[bot] · ci.datadog-api-spec · web-flow · commit 8615871b9b73 · 2026-03-05T13:46:31.000-05:00
Co-authored-by: ci.datadog-api-spec &lt;packages@datadoghq.com&gt;
diff --git a/.generator/schemas/v1/openapi.yaml b/.generator/schemas/v1/openapi.yaml
@@ -4608,10 +4608,11 @@ components:
           type: array
       type: object
     HourlyUsageAttributionUsageType:
-      description: 'Supported products for hourly usage attribution requests.
+      description: 'Supported products for hourly usage attribution requests. Usage
+        types are in the format `<usage_type>_usage`.
 
-        The following values have been **deprecated**: `estimated_indexed_spans_usage`,
-        `estimated_ingested_spans_usage`.'
+        To obtain the complete list of valid usage types, make a request to the [Get
+        usage attribution types API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-attribution-types).'
       enum:
       - api_usage
       - apm_fargate_usage
@@ -9161,7 +9162,11 @@ components:
           type: array
       type: object
     MonthlyUsageAttributionSupportedMetrics:
-      description: Supported metrics for monthly usage attribution requests.
+      description: 'Supported metrics for monthly usage attribution requests. Usage
+        types are in the format `<usage_type>_usage`.
+
+        To obtain the complete list of valid usage types, make a request to the [Get
+        usage attribution types API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-attribution-types).'
       enum:
       - api_usage
       - api_percentage
@@ -9492,10 +9497,7 @@ components:
       - SCA_FARGATE_PERCENTAGE
       - ALL
     MonthlyUsageAttributionValues:
-      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`.'
+      description: Fields in Usage Summary by tag(s).
       properties:
         api_percentage:
           description: The percentage of synthetic API test usage by tag(s).
@@ -37493,10 +37495,7 @@ paths:
         code example:\n\n```\nresponse := GetHourlyUsageAttribution(start_month)\ncursor
         := response.metadata.pagination.next_record_id\nWHILE cursor != null BEGIN\n
         \ sleep(5 seconds)  # Avoid running into rate limit\n  response := GetHourlyUsageAttribution(start_month,
-        next_record_id=cursor)\n  cursor := response.metadata.pagination.next_record_id\nEND\n```\nThe
-        following values have been **deprecated**:\n    `estimated_indexed_spans_usage`,
-        `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`, `estimated_ingested_spans_percentage`,
-        `llm_observability_usage`, `llm_observability_percentage`."
+        next_record_id=cursor)\n  cursor := response.metadata.pagination.next_record_id\nEND\n```"
       operationId: GetHourlyUsageAttribution
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -37517,9 +37516,14 @@ paths:
         schema:
           format: date-time
           type: string
-      - description: 'Usage type to retrieve. The following values have been **deprecated**:
+      - description: 'Usage type to retrieve. Usage types are in the format `<usage_type>_usage`.
+
+          Example: `infra_host_usage`
 
-          `estimated_indexed_spans_usage`, `estimated_ingested_spans_usage`.'
+          To obtain the complete list of active usage types that can be used to replace
+
+          `<usage_type>` in the field names, make a request to the [Get usage attribution
+          types API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-attribution-types).'
         in: query
         name: usage_type
         required: true
@@ -38072,10 +38076,15 @@ paths:
       - description: 'Comma-separated list of usage types to return, or `*` for all
           usage types.
 
-          The following values have been **deprecated**:
+          Usage types are in the format `<usage_type>_usage` and `<usage_type>_percentage`.
+
+          Example: `infra_host_usage,infra_host_percentage`
 
-          `estimated_indexed_spans_usage`, `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`,
-          `estimated_ingested_spans_percentage`, `llm_observability_usage`, `llm_observability_percentage`.'
+          To obtain the complete list of usage attribution types that can be used
+          to replace
+
+          `<usage_type>` in the field names, make a request to the [Get usage attribution
+          types API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-attribution-types).'
         in: query
         name: fields
         required: true
@@ -38087,12 +38096,15 @@ paths:
         required: false
         schema:
           $ref: '#/components/schemas/UsageSortDirection'
-      - description: 'The field to sort by.
+      - description: 'The field to sort by. Sort fields are in the format `<usage_type>_usage`.
+
+          Example: `infra_host_usage`
 
-          The following values have been **deprecated**:
+          To obtain the complete list of usage attribution types that can be used
+          to replace
 
-          `estimated_indexed_spans_usage`, `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`,
-          `estimated_ingested_spans_percentage`.'
+          `<usage_type>` in the field names, make a request to the [Get usage attribution
+          types API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-attribution-types).'
         in: query
         name: sort_name
         required: false
diff --git a/.generator/schemas/v2/openapi.yaml b/.generator/schemas/v2/openapi.yaml
@@ -70690,6 +70690,42 @@ components:
         usage_type:
           $ref: '#/components/schemas/HourlyUsageType'
       type: object
+    UsageAttributionTypesAttributes:
+      description: List of usage attribution types.
+      properties:
+        values:
+          description: List of usage attribution types.
+          items:
+            description: A given usage type in a list.
+            example: infra_host
+            type: string
+          type: array
+      type: object
+    UsageAttributionTypesBody:
+      description: Usage attribution types data.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/UsageAttributionTypesAttributes'
+        id:
+          description: Unique ID of the response.
+          type: string
+        type:
+          $ref: '#/components/schemas/UsageAttributionTypesType'
+      type: object
+    UsageAttributionTypesResponse:
+      description: Usage attribution types response.
+      properties:
+        data:
+          $ref: '#/components/schemas/UsageAttributionTypesBody'
+      type: object
+    UsageAttributionTypesType:
+      default: usage_attribution_types
+      description: Type of usage attribution types data.
+      enum:
+      - usage_attribution_types
+      type: string
+      x-enum-varnames:
+      - USAGE_ATTRIBUTION_TYPES
     UsageDataObject:
       description: Usage data.
       properties:
@@ -109764,6 +109800,41 @@ paths:
         permissions:
         - usage_read
         - billing_read
+  /api/v2/usage/usage-attribution-types:
+    get:
+      description: Get usage attribution types.
+      operationId: GetUsageAttributionTypes
+      responses:
+        '200':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/UsageAttributionTypesResponse'
+          description: OK
+        '403':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden - User is not authorized
+        '429':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Too many requests
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - usage_read
+      summary: Get usage attribution types
+      tags:
+      - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v2/user_invitations:
     post:
       description: Sends emails to one or more users inviting them to join the organization.
diff --git a/examples/v2/usage-metering/GetUsageAttributionTypes.rb b/examples/v2/usage-metering/GetUsageAttributionTypes.rb
@@ -0,0 +1,5 @@
+# Get usage attribution types returns "OK" response
+
+require "datadog_api_client"
+api_instance = DatadogAPIClient::V2::UsageMeteringAPI.new
+p api_instance.get_usage_attribution_types()
diff --git a/features/v2/undo.json b/features/v2/undo.json
@@ -6104,6 +6104,12 @@
       "type": "safe"
     }
   },
+  "GetUsageAttributionTypes": {
+    "tag": "Usage Metering",
+    "undo": {
+      "type": "safe"
+    }
+  },
   "SendInvitations": {
     "tag": "Users",
     "undo": {
diff --git a/features/v2/usage_metering.feature b/features/v2/usage_metering.feature
@@ -197,6 +197,12 @@ Feature: Usage Metering
     When the request is sent
     Then the response status is 200 OK
 
+  @generated @skip @team:DataDog/revenue-query
+  Scenario: Get usage attribution types returns "OK" response
+    Given new "GetUsageAttributionTypes" request
+    When the request is sent
+    Then the response status is 200 OK
+
   @team:DataDog/revenue-query
   Scenario: GetEstimatedCostByOrg with both start_month and start_date returns "Bad Request" response
     Given new "GetEstimatedCostByOrg" request
diff --git a/lib/datadog_api_client/inflector.rb b/lib/datadog_api_client/inflector.rb
@@ -5398,6 +5398,10 @@ def overrides
           "v2.url_param_update" => "UrlParamUpdate",
           "v2.usage_application_security_monitoring_response" => "UsageApplicationSecurityMonitoringResponse",
           "v2.usage_attributes_object" => "UsageAttributesObject",
+          "v2.usage_attribution_types_attributes" => "UsageAttributionTypesAttributes",
+          "v2.usage_attribution_types_body" => "UsageAttributionTypesBody",
+          "v2.usage_attribution_types_response" => "UsageAttributionTypesResponse",
+          "v2.usage_attribution_types_type" => "UsageAttributionTypesType",
           "v2.usage_data_object" => "UsageDataObject",
           "v2.usage_lambda_traced_invocations_response" => "UsageLambdaTracedInvocationsResponse",
           "v2.usage_observability_pipelines_response" => "UsageObservabilityPipelinesResponse",
diff --git a/lib/datadog_api_client/v1/api/usage_metering_api.rb b/lib/datadog_api_client/v1/api/usage_metering_api.rb
@@ -129,11 +129,9 @@ def get_hourly_usage_attribution(start_hr, usage_type, opts = {})
     #   cursor := response.metadata.pagination.next_record_id
     # END
     # ```
-    # The following values have been **deprecated**:
-    #     `estimated_indexed_spans_usage`, `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`, `estimated_ingested_spans_percentage`, `llm_observability_usage`, `llm_observability_percentage`.
     #
     # @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. The following values have been **deprecated**: `estimated_indexed_spans_usage`, `estimated_ingested_spans_usage`.
+    # @param usage_type [HourlyUsageAttributionUsageType] Usage type to retrieve. Usage types are in the format `<usage_type>_usage`. Example: `infra_host_usage` To obtain the complete list of active usage types that can be used to replace `<usage_type>` in the field names, make a request to the [Get usage attribution types API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-attribution-types).
     # @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.
@@ -457,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. The following values have been **deprecated**: `estimated_indexed_spans_usage`, `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`, `estimated_ingested_spans_percentage`, `llm_observability_usage`, `llm_observability_percentage`.
+    # @param fields [MonthlyUsageAttributionSupportedMetrics] Comma-separated list of usage types to return, or `*` for all usage types. Usage types are in the format `<usage_type>_usage` and `<usage_type>_percentage`. Example: `infra_host_usage,infra_host_percentage` To obtain the complete list of usage attribution types that can be used to replace `<usage_type>` in the field names, make a request to the [Get usage attribution types API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-attribution-types).
     # @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. The following values have been **deprecated**: `estimated_indexed_spans_usage`, `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`, `estimated_ingested_spans_percentage`.
+    # @option opts [MonthlyUsageAttributionSupportedMetrics] :sort_name The field to sort by. Sort fields are in the format `<usage_type>_usage`. Example: `infra_host_usage` To obtain the complete list of usage attribution types that can be used to replace `<usage_type>` in the field names, make a request to the [Get usage attribution types API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-attribution-types).
     # @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`.
diff --git a/lib/datadog_api_client/v1/models/hourly_usage_attribution_body.rb b/lib/datadog_api_client/v1/models/hourly_usage_attribution_body.rb
@@ -49,8 +49,8 @@ class HourlyUsageAttributionBody
     # Shows the most recent hour in the current month for all organizations where usages are calculated.
     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`.
+    # Supported products for hourly usage attribution requests. Usage types are in the format `<usage_type>_usage`.
+    # To obtain the complete list of valid usage types, make a request to the [Get usage attribution types API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-attribution-types).
     attr_accessor :usage_type
 
     attr_accessor :additional_properties
diff --git a/lib/datadog_api_client/v1/models/hourly_usage_attribution_usage_type.rb b/lib/datadog_api_client/v1/models/hourly_usage_attribution_usage_type.rb
@@ -17,8 +17,8 @@
 require 'time'
 
 module DatadogAPIClient::V1
-  # Supported products for hourly usage attribution requests.
-  # The following values have been **deprecated**: `estimated_indexed_spans_usage`, `estimated_ingested_spans_usage`.
+  # Supported products for hourly usage attribution requests. Usage types are in the format `<usage_type>_usage`.
+  # To obtain the complete list of valid usage types, make a request to the [Get usage attribution types API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-attribution-types).
   class HourlyUsageAttributionUsageType
     include BaseEnumModel
 
diff --git a/lib/datadog_api_client/v1/models/monthly_usage_attribution_body.rb b/lib/datadog_api_client/v1/models/monthly_usage_attribution_body.rb
@@ -47,7 +47,6 @@ 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
diff --git a/lib/datadog_api_client/v1/models/monthly_usage_attribution_supported_metrics.rb b/lib/datadog_api_client/v1/models/monthly_usage_attribution_supported_metrics.rb
@@ -17,7 +17,8 @@
 require 'time'
 
 module DatadogAPIClient::V1
-  # Supported metrics for monthly usage attribution requests.
+  # Supported metrics for monthly usage attribution requests. Usage types are in the format `<usage_type>_usage`.
+  # To obtain the complete list of valid usage types, make a request to the [Get usage attribution types API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-attribution-types).
   class MonthlyUsageAttributionSupportedMetrics
     include BaseEnumModel
 
diff --git a/lib/datadog_api_client/v1/models/monthly_usage_attribution_values.rb b/lib/datadog_api_client/v1/models/monthly_usage_attribution_values.rb
@@ -18,7 +18,6 @@
 
 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
 
diff --git a/lib/datadog_api_client/v2/api/usage_metering_api.rb b/lib/datadog_api_client/v2/api/usage_metering_api.rb
@@ -713,6 +713,66 @@ def get_usage_application_security_monitoring_with_http_info(start_hr, opts = {}
       return data, status_code, headers
     end
 
+    # Get usage attribution types.
+    #
+    # @see #get_usage_attribution_types_with_http_info
+    def get_usage_attribution_types(opts = {})
+      data, _status_code, _headers = get_usage_attribution_types_with_http_info(opts)
+      data
+    end
+
+    # Get usage attribution types.
+    #
+    # Get usage attribution types.
+    #
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(UsageAttributionTypesResponse, Integer, Hash)>] UsageAttributionTypesResponse data, response status code and response headers
+    def get_usage_attribution_types_with_http_info(opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: UsageMeteringAPI.get_usage_attribution_types ...'
+      end
+      # resource path
+      local_var_path = '/api/v2/usage/usage-attribution-types'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json;datetime-format=rfc3339'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'UsageAttributionTypesResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :get_usage_attribution_types,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: UsageMeteringAPI#get_usage_attribution_types\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Get hourly usage for Lambda traced invocations.
     #
     # @see #get_usage_lambda_traced_invocations_with_http_info
diff --git a/lib/datadog_api_client/v2/models/usage_attribution_types_attributes.rb b/lib/datadog_api_client/v2/models/usage_attribution_types_attributes.rb
diff --git a/lib/datadog_api_client/v2/models/usage_attribution_types_body.rb b/lib/datadog_api_client/v2/models/usage_attribution_types_body.rb
diff --git a/lib/datadog_api_client/v2/models/usage_attribution_types_response.rb b/lib/datadog_api_client/v2/models/usage_attribution_types_response.rb
diff --git a/lib/datadog_api_client/v2/models/usage_attribution_types_type.rb b/lib/datadog_api_client/v2/models/usage_attribution_types_type.rb
