datadog_api_client 2.54.0 → 2.56.0

data/lib/datadog_api_client/v2/api/cloud_cost_management_api.rb

@@ -630,6 +630,73 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Delete a Cloud Cost Management tag description.
+    #
+    # @see #delete_cost_tag_description_by_key_with_http_info
+    def delete_cost_tag_description_by_key(tag_key, opts = {})
+      delete_cost_tag_description_by_key_with_http_info(tag_key, opts)
+      nil
+    end
+
+    # Delete a Cloud Cost Management tag description.
+    #
+    # Delete a Cloud Cost Management tag key description. When `cloud` is omitted, deletes every description for the tag key, falling back to Datadog's global default when available. When `cloud` is provided, deletes only the description scoped to that cloud provider.
+    #
+    # @param tag_key [String] The tag key whose description is being deleted.
+    # @param opts [Hash] the optional parameters
+    # @option opts [String] :cloud Cloud provider to scope the deletion to (for example, `aws`). Omit to delete every description for the tag key.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def delete_cost_tag_description_by_key_with_http_info(tag_key, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.delete_cost_tag_description_by_key ...'
+      end
+      # verify the required parameter 'tag_key' is set
+      if @api_client.config.client_side_validation && tag_key.nil?
+        fail ArgumentError, "Missing the required parameter 'tag_key' when calling CloudCostManagementAPI.delete_cost_tag_description_by_key"
+      end
+      # resource path
+      local_var_path = '/api/v2/cost/tag_descriptions/{tag_key}'.sub('{tag_key}', CGI.escape(tag_key.to_s).gsub('%2F', '/'))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'cloud'] = opts[:'cloud'] if !opts[:'cloud'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['*/*'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :delete_cost_tag_description_by_key,
+        :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::Delete, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CloudCostManagementAPI#delete_cost_tag_description_by_key\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Delete custom allocation rule.
     #
     # @see #delete_custom_allocation_rule_with_http_info
@@ -760,6 +827,77 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Delete a budget's custom forecast.
+    #
+    # @see #delete_custom_forecast_with_http_info
+    def delete_custom_forecast(budget_id, opts = {})
+      delete_custom_forecast_with_http_info(budget_id, opts)
+      nil
+    end
+
+    # Delete a budget's custom forecast.
+    #
+    # Delete the custom forecast for a budget.
+    #
+    # @param budget_id [String] Budget id.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def delete_custom_forecast_with_http_info(budget_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.delete_custom_forecast".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.delete_custom_forecast")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.delete_custom_forecast"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.delete_custom_forecast ...'
+      end
+      # verify the required parameter 'budget_id' is set
+      if @api_client.config.client_side_validation && budget_id.nil?
+        fail ArgumentError, "Missing the required parameter 'budget_id' when calling CloudCostManagementAPI.delete_custom_forecast"
+      end
+      # resource path
+      local_var_path = '/api/v2/cost/budget/{budget_id}/custom-forecast'.sub('{budget_id}', CGI.escape(budget_id.to_s).gsub('%2F', '/'))
+
+      # 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(['*/*'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :delete_custom_forecast,
+        :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::Delete, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CloudCostManagementAPI#delete_custom_forecast\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Delete tag pipeline ruleset.
     #
     # @see #delete_tag_pipelines_ruleset_with_http_info
@@ -825,6 +963,71 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Generate a Cloud Cost Management tag description.
+    #
+    # @see #generate_cost_tag_description_by_key_with_http_info
+    def generate_cost_tag_description_by_key(tag_key, opts = {})
+      data, _status_code, _headers = generate_cost_tag_description_by_key_with_http_info(tag_key, opts)
+      data
+    end
+
+    # Generate a Cloud Cost Management tag description.
+    #
+    # Use AI to draft a Cloud Cost Management tag key description based on associated cost data. The generated description is returned in the response and is not persisted by this endpoint; follow up with `UpsertCostTagDescriptionByKey` to save it.
+    #
+    # @param tag_key [String] The tag key to generate an AI description for.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(GenerateCostTagDescriptionResponse, Integer, Hash)>] GenerateCostTagDescriptionResponse data, response status code and response headers
+    def generate_cost_tag_description_by_key_with_http_info(tag_key, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.generate_cost_tag_description_by_key ...'
+      end
+      # verify the required parameter 'tag_key' is set
+      if @api_client.config.client_side_validation && tag_key.nil?
+        fail ArgumentError, "Missing the required parameter 'tag_key' when calling CloudCostManagementAPI.generate_cost_tag_description_by_key"
+      end
+      # resource path
+      local_var_path = '/api/v2/cost/tag_descriptions/{tag_key}/generate'.sub('{tag_key}', CGI.escape(tag_key.to_s).gsub('%2F', '/'))
+
+      # 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'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GenerateCostTagDescriptionResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :generate_cost_tag_description_by_key,
+        :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: CloudCostManagementAPI#generate_cost_tag_description_by_key\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Get budget.
     #
     # @see #get_budget_with_http_info
@@ -835,10 +1038,14 @@ module DatadogAPIClient::V2
 
     # Get budget.
     #
-    # Get a budget
+    # Get a budget by ID. Pass `actual=true` or `forecast=true` to include cost data in the response. Use `start` and `end` (millisecond epochs, both required) to set the cost window. When `forecast=true`, each entry also includes `ootb_forecast` (the ML forecast before overrides) and `custom_forecast` (`null` if no override is set, a number if one is).
     #
     # @param budget_id [String] Budget id.
     # @param opts [Hash] the optional parameters
+    # @option opts [Boolean] :actual When `true`, includes actual cost data in the response.
+    # @option opts [Boolean] :forecast When `true`, includes forecast cost data in the response, including `ootb_forecast` and `custom_forecast` per entry.
+    # @option opts [Integer] :start Start of the cost window in milliseconds since epoch. Must be used together with `end`.
+    # @option opts [Integer] :_end End of the cost window in milliseconds since epoch. Must be used together with `start`.
     # @return [Array<(BudgetWithEntries, Integer, Hash)>] BudgetWithEntries data, response status code and response headers
     def get_budget_with_http_info(budget_id, opts = {})
 
@@ -854,6 +1061,10 @@ module DatadogAPIClient::V2
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'actual'] = opts[:'actual'] if !opts[:'actual'].nil?
+      query_params[:'forecast'] = opts[:'forecast'] if !opts[:'forecast'].nil?
+      query_params[:'start'] = opts[:'start'] if !opts[:'start'].nil?
+      query_params[:'end'] = opts[:'_end'] if !opts[:'_end'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -1950,42 +2161,37 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
-    # Get a Cloud Cost Management tag key.
+    # Get a Cloud Cost Management tag description.
     #
-    # @see #get_cost_tag_key_with_http_info
-    def get_cost_tag_key(tag_key, opts = {})
-      data, _status_code, _headers = get_cost_tag_key_with_http_info(tag_key, opts)
+    # @see #get_cost_tag_description_by_key_with_http_info
+    def get_cost_tag_description_by_key(tag_key, opts = {})
+      data, _status_code, _headers = get_cost_tag_description_by_key_with_http_info(tag_key, opts)
       data
     end
 
-    # Get a Cloud Cost Management tag key.
+    # Get a Cloud Cost Management tag description.
     #
-    # Get details for a specific Cloud Cost Management tag key, including example tag values and description.
+    # Get the Cloud Cost Management description for a single tag key. Use `filter[cloud]` to scope the lookup to a specific cloud provider; when omitted, the response resolves the description in fallback order (cloud-specific organization override, then cloudless organization default, then Datadog's global default).
     #
-    # @param tag_key [String] The Cloud Cost Management tag key. Tag keys can contain forward slashes (for example, `kubernetes/instance`).
+    # @param tag_key [String] The tag key whose description is being fetched.
     # @param opts [Hash] the optional parameters
-    # @option opts [String] :filter_metric The Cloud Cost Management metric to scope the tag key details to. When omitted, returns details across all metrics.
-    # @option opts [Integer] :page_size Controls the size of the internal tag value search scope. This does **not** restrict the number of example tag values returned in the response. Defaults to 50, maximum 10000.
-    # @return [Array<(CostTagKeyResponse, Integer, Hash)>] CostTagKeyResponse data, response status code and response headers
-    def get_cost_tag_key_with_http_info(tag_key, opts = {})
+    # @option opts [String] :filter_cloud Cloud provider to scope the lookup to (for example, `aws`). Omit to use the resolved fallback.
+    # @return [Array<(CostTagDescriptionResponse, Integer, Hash)>] CostTagDescriptionResponse data, response status code and response headers
+    def get_cost_tag_description_by_key_with_http_info(tag_key, opts = {})
 
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.get_cost_tag_key ...'
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.get_cost_tag_description_by_key ...'
       end
       # verify the required parameter 'tag_key' is set
       if @api_client.config.client_side_validation && tag_key.nil?
-        fail ArgumentError, "Missing the required parameter 'tag_key' when calling CloudCostManagementAPI.get_cost_tag_key"
-      end
-      if @api_client.config.client_side_validation && !opts[:'page_size'].nil? && opts[:'page_size'] > 10000
-        fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling CloudCostManagementAPI.get_cost_tag_key, must be smaller than or equal to 10000.'
+        fail ArgumentError, "Missing the required parameter 'tag_key' when calling CloudCostManagementAPI.get_cost_tag_description_by_key"
       end
       # resource path
-      local_var_path = '/api/v2/cost/tag_keys/{tag_key}'.sub('{tag_key}', CGI.escape(tag_key.to_s).gsub('%2F', '/'))
+      local_var_path = '/api/v2/cost/tag_descriptions/{tag_key}'.sub('{tag_key}', CGI.escape(tag_key.to_s).gsub('%2F', '/'))
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'filter[metric]'] = opts[:'filter_metric'] if !opts[:'filter_metric'].nil?
-      query_params[:'page[size]'] = opts[:'page_size'] if !opts[:'page_size'].nil?
+      query_params[:'filter[cloud]'] = opts[:'filter_cloud'] if !opts[:'filter_cloud'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -1999,13 +2205,13 @@ module DatadogAPIClient::V2
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'CostTagKeyResponse'
+      return_type = opts[:debug_return_type] || 'CostTagDescriptionResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
 
       new_options = opts.merge(
-        :operation => :get_cost_tag_key,
+        :operation => :get_cost_tag_description_by_key,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -2017,40 +2223,47 @@ module DatadogAPIClient::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: CloudCostManagementAPI#get_cost_tag_key\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: CloudCostManagementAPI#get_cost_tag_description_by_key\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Get custom allocation rule.
+    # Get a Cloud Cost Management tag key.
     #
-    # @see #get_custom_allocation_rule_with_http_info
-    def get_custom_allocation_rule(rule_id, opts = {})
-      data, _status_code, _headers = get_custom_allocation_rule_with_http_info(rule_id, opts)
+    # @see #get_cost_tag_key_with_http_info
+    def get_cost_tag_key(tag_key, opts = {})
+      data, _status_code, _headers = get_cost_tag_key_with_http_info(tag_key, opts)
       data
     end
 
-    # Get custom allocation rule.
+    # Get a Cloud Cost Management tag key.
     #
-    # Get a specific custom allocation rule - Retrieve a specific custom allocation rule by its ID
+    # Get details for a specific Cloud Cost Management tag key, including example tag values and description.
     #
-    # @param rule_id [Integer] The unique identifier of the custom allocation rule
+    # @param tag_key [String] The Cloud Cost Management tag key. Tag keys can contain forward slashes (for example, `kubernetes/instance`).
     # @param opts [Hash] the optional parameters
-    # @return [Array<(ArbitraryRuleResponse, Integer, Hash)>] ArbitraryRuleResponse data, response status code and response headers
-    def get_custom_allocation_rule_with_http_info(rule_id, opts = {})
+    # @option opts [String] :filter_metric The Cloud Cost Management metric to scope the tag key details to. When omitted, returns details across all metrics.
+    # @option opts [Integer] :page_size Controls the size of the internal tag value search scope. This does **not** restrict the number of example tag values returned in the response. Defaults to 50, maximum 10000.
+    # @return [Array<(CostTagKeyResponse, Integer, Hash)>] CostTagKeyResponse data, response status code and response headers
+    def get_cost_tag_key_with_http_info(tag_key, opts = {})
 
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.get_custom_allocation_rule ...'
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.get_cost_tag_key ...'
       end
-      # verify the required parameter 'rule_id' is set
-      if @api_client.config.client_side_validation && rule_id.nil?
-        fail ArgumentError, "Missing the required parameter 'rule_id' when calling CloudCostManagementAPI.get_custom_allocation_rule"
+      # verify the required parameter 'tag_key' is set
+      if @api_client.config.client_side_validation && tag_key.nil?
+        fail ArgumentError, "Missing the required parameter 'tag_key' when calling CloudCostManagementAPI.get_cost_tag_key"
+      end
+      if @api_client.config.client_side_validation && !opts[:'page_size'].nil? && opts[:'page_size'] > 10000
+        fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling CloudCostManagementAPI.get_cost_tag_key, must be smaller than or equal to 10000.'
       end
       # resource path
-      local_var_path = '/api/v2/cost/arbitrary_rule/{rule_id}'.sub('{rule_id}', CGI.escape(rule_id.to_s).gsub('%2F', '/'))
+      local_var_path = '/api/v2/cost/tag_keys/{tag_key}'.sub('{tag_key}', CGI.escape(tag_key.to_s).gsub('%2F', '/'))
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'filter[metric]'] = opts[:'filter_metric'] if !opts[:'filter_metric'].nil?
+      query_params[:'page[size]'] = opts[:'page_size'] if !opts[:'page_size'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -2064,13 +2277,13 @@ module DatadogAPIClient::V2
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'ArbitraryRuleResponse'
+      return_type = opts[:debug_return_type] || 'CostTagKeyResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
 
       new_options = opts.merge(
-        :operation => :get_custom_allocation_rule,
+        :operation => :get_cost_tag_key,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -2082,40 +2295,49 @@ module DatadogAPIClient::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: CloudCostManagementAPI#get_custom_allocation_rule\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: CloudCostManagementAPI#get_cost_tag_key\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Get Custom Costs file.
+    # Get the Cloud Cost Management billing currency.
     #
-    # @see #get_custom_costs_file_with_http_info
-    def get_custom_costs_file(file_id, opts = {})
-      data, _status_code, _headers = get_custom_costs_file_with_http_info(file_id, opts)
+    # @see #get_cost_tag_metadata_currency_with_http_info
+    def get_cost_tag_metadata_currency(filter_month, opts = {})
+      data, _status_code, _headers = get_cost_tag_metadata_currency_with_http_info(filter_month, opts)
       data
     end
 
-    # Get Custom Costs file.
+    # Get the Cloud Cost Management billing currency.
     #
-    # Fetch the specified Custom Costs file.
+    # Get the dominant billing currency observed in Cloud Cost Management data for the requested period. The response wraps the currency in a JSON:API `data` array containing at most one entry; the array is empty when no currency data is available.
     #
-    # @param file_id [String] File ID.
+    # @param filter_month [String] The month to scope the query to, in `YYYY-MM` format.
     # @param opts [Hash] the optional parameters
-    # @return [Array<(CustomCostsFileGetResponse, Integer, Hash)>] CustomCostsFileGetResponse data, response status code and response headers
-    def get_custom_costs_file_with_http_info(file_id, opts = {})
+    # @option opts [String] :filter_provider Filter results to a specific provider. Common cloud values are `aws`, `azure`, `gcp`, `Oracle` (OCI), and `custom`. SaaS billing integrations (for example, `Snowflake`, `MongoDB`, `Databricks`) are also accepted using their display-name string. Values are case-sensitive.
+    # @return [Array<(CostCurrencyResponse, Integer, Hash)>] CostCurrencyResponse data, response status code and response headers
+    def get_cost_tag_metadata_currency_with_http_info(filter_month, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.get_cost_tag_metadata_currency".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.get_cost_tag_metadata_currency")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.get_cost_tag_metadata_currency"))
+      end
 
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.get_custom_costs_file ...'
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.get_cost_tag_metadata_currency ...'
       end
-      # verify the required parameter 'file_id' is set
-      if @api_client.config.client_side_validation && file_id.nil?
-        fail ArgumentError, "Missing the required parameter 'file_id' when calling CloudCostManagementAPI.get_custom_costs_file"
+      # verify the required parameter 'filter_month' is set
+      if @api_client.config.client_side_validation && filter_month.nil?
+        fail ArgumentError, "Missing the required parameter 'filter_month' when calling CloudCostManagementAPI.get_cost_tag_metadata_currency"
       end
       # resource path
-      local_var_path = '/api/v2/cost/custom_costs/{file_id}'.sub('{file_id}', CGI.escape(file_id.to_s).gsub('%2F', '/'))
+      local_var_path = '/api/v2/cost/tag_metadata/currency'
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'filter[month]'] = filter_month
+      query_params[:'filter[provider]'] = opts[:'filter_provider'] if !opts[:'filter_provider'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -2129,13 +2351,13 @@ module DatadogAPIClient::V2
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'CustomCostsFileGetResponse'
+      return_type = opts[:debug_return_type] || 'CostCurrencyResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
 
       new_options = opts.merge(
-        :operation => :get_custom_costs_file,
+        :operation => :get_cost_tag_metadata_currency,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -2147,22 +2369,152 @@ module DatadogAPIClient::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: CloudCostManagementAPI#get_custom_costs_file\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: CloudCostManagementAPI#get_cost_tag_metadata_currency\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Get a tag pipeline ruleset.
+    # Get custom allocation rule.
     #
-    # @see #get_tag_pipelines_ruleset_with_http_info
-    def get_tag_pipelines_ruleset(ruleset_id, opts = {})
-      data, _status_code, _headers = get_tag_pipelines_ruleset_with_http_info(ruleset_id, opts)
+    # @see #get_custom_allocation_rule_with_http_info
+    def get_custom_allocation_rule(rule_id, opts = {})
+      data, _status_code, _headers = get_custom_allocation_rule_with_http_info(rule_id, opts)
       data
     end
 
-    # Get a tag pipeline ruleset.
+    # Get custom allocation rule.
     #
-    # Get a specific tag pipeline ruleset - Retrieve a specific tag pipeline ruleset by its ID
+    # Get a specific custom allocation rule - Retrieve a specific custom allocation rule by its ID
+    #
+    # @param rule_id [Integer] The unique identifier of the custom allocation rule
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(ArbitraryRuleResponse, Integer, Hash)>] ArbitraryRuleResponse data, response status code and response headers
+    def get_custom_allocation_rule_with_http_info(rule_id, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.get_custom_allocation_rule ...'
+      end
+      # verify the required parameter 'rule_id' is set
+      if @api_client.config.client_side_validation && rule_id.nil?
+        fail ArgumentError, "Missing the required parameter 'rule_id' when calling CloudCostManagementAPI.get_custom_allocation_rule"
+      end
+      # resource path
+      local_var_path = '/api/v2/cost/arbitrary_rule/{rule_id}'.sub('{rule_id}', CGI.escape(rule_id.to_s).gsub('%2F', '/'))
+
+      # 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'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ArbitraryRuleResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :get_custom_allocation_rule,
+        :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: CloudCostManagementAPI#get_custom_allocation_rule\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get Custom Costs file.
+    #
+    # @see #get_custom_costs_file_with_http_info
+    def get_custom_costs_file(file_id, opts = {})
+      data, _status_code, _headers = get_custom_costs_file_with_http_info(file_id, opts)
+      data
+    end
+
+    # Get Custom Costs file.
+    #
+    # Fetch the specified Custom Costs file.
+    #
+    # @param file_id [String] File ID.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(CustomCostsFileGetResponse, Integer, Hash)>] CustomCostsFileGetResponse data, response status code and response headers
+    def get_custom_costs_file_with_http_info(file_id, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.get_custom_costs_file ...'
+      end
+      # verify the required parameter 'file_id' is set
+      if @api_client.config.client_side_validation && file_id.nil?
+        fail ArgumentError, "Missing the required parameter 'file_id' when calling CloudCostManagementAPI.get_custom_costs_file"
+      end
+      # resource path
+      local_var_path = '/api/v2/cost/custom_costs/{file_id}'.sub('{file_id}', CGI.escape(file_id.to_s).gsub('%2F', '/'))
+
+      # 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'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CustomCostsFileGetResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :get_custom_costs_file,
+        :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: CloudCostManagementAPI#get_custom_costs_file\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get a tag pipeline ruleset.
+    #
+    # @see #get_tag_pipelines_ruleset_with_http_info
+    def get_tag_pipelines_ruleset(ruleset_id, opts = {})
+      data, _status_code, _headers = get_tag_pipelines_ruleset_with_http_info(ruleset_id, opts)
+      data
+    end
+
+    # Get a tag pipeline ruleset.
+    #
+    # Get a specific tag pipeline ruleset - Retrieve a specific tag pipeline ruleset by its ID
     #
     # @param ruleset_id [String] The unique identifier of the ruleset
     # @param opts [Hash] the optional parameters
@@ -2443,13 +2795,336 @@ module DatadogAPIClient::V2
     def list_cost_azure_uc_configs_with_http_info(opts = {})
 
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.list_cost_azure_uc_configs ...'
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.list_cost_azure_uc_configs ...'
+      end
+      # resource path
+      local_var_path = '/api/v2/cost/azure_uc_config'
+
+      # 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'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AzureUCConfigsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :list_cost_azure_uc_configs,
+        :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: CloudCostManagementAPI#list_cost_azure_uc_configs\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List Google Cloud Usage Cost configs.
+    #
+    # @see #list_cost_gcp_usage_cost_configs_with_http_info
+    def list_cost_gcp_usage_cost_configs(opts = {})
+      data, _status_code, _headers = list_cost_gcp_usage_cost_configs_with_http_info(opts)
+      data
+    end
+
+    # List Google Cloud Usage Cost configs.
+    #
+    # List the Google Cloud Usage Cost configs.
+    #
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(GCPUsageCostConfigsResponse, Integer, Hash)>] GCPUsageCostConfigsResponse data, response status code and response headers
+    def list_cost_gcp_usage_cost_configs_with_http_info(opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.list_cost_gcp_usage_cost_configs ...'
+      end
+      # resource path
+      local_var_path = '/api/v2/cost/gcp_uc_config'
+
+      # 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'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GCPUsageCostConfigsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :list_cost_gcp_usage_cost_configs,
+        :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: CloudCostManagementAPI#list_cost_gcp_usage_cost_configs\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List Cloud Cost Management OCI configs.
+    #
+    # @see #list_cost_oci_configs_with_http_info
+    def list_cost_oci_configs(opts = {})
+      data, _status_code, _headers = list_cost_oci_configs_with_http_info(opts)
+      data
+    end
+
+    # List Cloud Cost Management OCI configs.
+    #
+    # List the OCI configs.
+    #
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(OCIConfigsResponse, Integer, Hash)>] OCIConfigsResponse data, response status code and response headers
+    def list_cost_oci_configs_with_http_info(opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.list_cost_oci_configs ...'
+      end
+      # resource path
+      local_var_path = '/api/v2/cost/oci_config'
+
+      # 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'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'OCIConfigsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :list_cost_oci_configs,
+        :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: CloudCostManagementAPI#list_cost_oci_configs\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List Cloud Cost Management tag descriptions.
+    #
+    # @see #list_cost_tag_descriptions_with_http_info
+    def list_cost_tag_descriptions(opts = {})
+      data, _status_code, _headers = list_cost_tag_descriptions_with_http_info(opts)
+      data
+    end
+
+    # List Cloud Cost Management tag descriptions.
+    #
+    # List Cloud Cost Management tag key descriptions for the organization. Use `filter[cloud]` to scope the result to a single cloud provider; when omitted, both cross-cloud defaults and cloud-specific descriptions are returned.
+    #
+    # @param opts [Hash] the optional parameters
+    # @option opts [String] :filter_cloud Filter descriptions to a specific cloud provider (for example, `aws`). Omit to return descriptions across all clouds.
+    # @return [Array<(CostTagDescriptionsResponse, Integer, Hash)>] CostTagDescriptionsResponse data, response status code and response headers
+    def list_cost_tag_descriptions_with_http_info(opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.list_cost_tag_descriptions ...'
+      end
+      # resource path
+      local_var_path = '/api/v2/cost/tag_descriptions'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'filter[cloud]'] = opts[:'filter_cloud'] if !opts[:'filter_cloud'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CostTagDescriptionsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :list_cost_tag_descriptions,
+        :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: CloudCostManagementAPI#list_cost_tag_descriptions\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List Cloud Cost Management tag keys.
+    #
+    # @see #list_cost_tag_keys_with_http_info
+    def list_cost_tag_keys(opts = {})
+      data, _status_code, _headers = list_cost_tag_keys_with_http_info(opts)
+      data
+    end
+
+    # List Cloud Cost Management tag keys.
+    #
+    # List Cloud Cost Management tag keys.
+    #
+    # @param opts [Hash] the optional parameters
+    # @option opts [String] :filter_metric The Cloud Cost Management metric to scope the tag keys to. When omitted, returns tag keys across all metrics.
+    # @option opts [Array<String>] :filter_tags Filter to return only tag keys that appear with the given `key:value` tag values. For example, `filter[tags]=providername:aws` returns tag keys found on the same cost data, such as `is_aws_ec2_compute` and `aws_instance_type`.
+    # @return [Array<(CostTagKeysResponse, Integer, Hash)>] CostTagKeysResponse data, response status code and response headers
+    def list_cost_tag_keys_with_http_info(opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.list_cost_tag_keys ...'
+      end
+      # resource path
+      local_var_path = '/api/v2/cost/tag_keys'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'filter[metric]'] = opts[:'filter_metric'] if !opts[:'filter_metric'].nil?
+      query_params[:'filter[tags]'] = @api_client.build_collection_param(opts[:'filter_tags'], :multi) if !opts[:'filter_tags'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CostTagKeysResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :list_cost_tag_keys,
+        :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"
+      )
+      new_options[:query_string_normalizer] = HTTParty::Request::NON_RAILS_QUERY_STRING_NORMALIZER
+
+      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: CloudCostManagementAPI#list_cost_tag_keys\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List Cloud Cost Management tag sources.
+    #
+    # @see #list_cost_tag_key_sources_with_http_info
+    def list_cost_tag_key_sources(filter_month, opts = {})
+      data, _status_code, _headers = list_cost_tag_key_sources_with_http_info(filter_month, opts)
+      data
+    end
+
+    # List Cloud Cost Management tag sources.
+    #
+    # List Cloud Cost Management tag keys observed for the requested period, along with the origin sources that produced them (for example, `aws-user-defined`, `custom`).
+    #
+    # @param filter_month [String] The month to scope the query to, in `YYYY-MM` format.
+    # @param opts [Hash] the optional parameters
+    # @option opts [String] :filter_provider Filter results to a specific provider. Common cloud values are `aws`, `azure`, `gcp`, `Oracle` (OCI), and `custom`. SaaS billing integrations (for example, `Snowflake`, `MongoDB`, `Databricks`) are also accepted using their display-name string. Values are case-sensitive.
+    # @option opts [String] :filter_metric Filter results to tag keys that have data for a specific Cloud Cost Management metric (for example, `aws.cost.net.amortized`). When omitted, all tag keys for the requested period are returned.
+    # @return [Array<(CostTagKeySourcesResponse, Integer, Hash)>] CostTagKeySourcesResponse data, response status code and response headers
+    def list_cost_tag_key_sources_with_http_info(filter_month, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_cost_tag_key_sources".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_cost_tag_key_sources")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_cost_tag_key_sources"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.list_cost_tag_key_sources ...'
+      end
+      # verify the required parameter 'filter_month' is set
+      if @api_client.config.client_side_validation && filter_month.nil?
+        fail ArgumentError, "Missing the required parameter 'filter_month' when calling CloudCostManagementAPI.list_cost_tag_key_sources"
       end
       # resource path
-      local_var_path = '/api/v2/cost/azure_uc_config'
+      local_var_path = '/api/v2/cost/tag_metadata/tag_sources'
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'filter[month]'] = filter_month
+      query_params[:'filter[provider]'] = opts[:'filter_provider'] if !opts[:'filter_provider'].nil?
+      query_params[:'filter[metric]'] = opts[:'filter_metric'] if !opts[:'filter_metric'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -2463,13 +3138,13 @@ module DatadogAPIClient::V2
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'AzureUCConfigsResponse'
+      return_type = opts[:debug_return_type] || 'CostTagKeySourcesResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
 
       new_options = opts.merge(
-        :operation => :list_cost_azure_uc_configs,
+        :operation => :list_cost_tag_key_sources,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -2481,35 +3156,59 @@ module DatadogAPIClient::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: CloudCostManagementAPI#list_cost_azure_uc_configs\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: CloudCostManagementAPI#list_cost_tag_key_sources\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # List Google Cloud Usage Cost configs.
+    # List Cloud Cost Management tag key metadata.
     #
-    # @see #list_cost_gcp_usage_cost_configs_with_http_info
-    def list_cost_gcp_usage_cost_configs(opts = {})
-      data, _status_code, _headers = list_cost_gcp_usage_cost_configs_with_http_info(opts)
+    # @see #list_cost_tag_metadata_with_http_info
+    def list_cost_tag_metadata(filter_month, opts = {})
+      data, _status_code, _headers = list_cost_tag_metadata_with_http_info(filter_month, opts)
       data
     end
 
-    # List Google Cloud Usage Cost configs.
+    # List Cloud Cost Management tag key metadata.
     #
-    # List the Google Cloud Usage Cost configs.
+    # List Cloud Cost Management tag key metadata, including row counts, cost covered, cardinality, and a sample of top tag values per cloud account. Use `filter[daily]=true` to return daily rows instead of the default monthly roll-up.
     #
+    # @param filter_month [String] The month to scope the query to, in `YYYY-MM` format.
     # @param opts [Hash] the optional parameters
-    # @return [Array<(GCPUsageCostConfigsResponse, Integer, Hash)>] GCPUsageCostConfigsResponse data, response status code and response headers
-    def list_cost_gcp_usage_cost_configs_with_http_info(opts = {})
+    # @option opts [String] :filter_provider Filter results to a specific provider. Common cloud values are `aws`, `azure`, `gcp`, `Oracle` (OCI), and `custom`. SaaS billing integrations (for example, `Snowflake`, `MongoDB`, `Databricks`) are also accepted using their display-name string. Values are case-sensitive.
+    # @option opts [String] :filter_metric Filter results to a specific Cloud Cost Management metric (for example, `aws.cost.net.amortized`). When omitted, every available metric for the requested period is returned.
+    # @option opts [String] :filter_tag_key Restrict results to a single tag key.
+    # @option opts [CostTagMetadataDailyFilter] :filter_daily When `true`, return one row per day with the day in the `date` attribute. Defaults to the monthly roll-up when omitted.
+    # @return [Array<(CostTagKeyMetadataResponse, Integer, Hash)>] CostTagKeyMetadataResponse data, response status code and response headers
+    def list_cost_tag_metadata_with_http_info(filter_month, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_cost_tag_metadata".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_cost_tag_metadata")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_cost_tag_metadata"))
+      end
 
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.list_cost_gcp_usage_cost_configs ...'
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.list_cost_tag_metadata ...'
+      end
+      # verify the required parameter 'filter_month' is set
+      if @api_client.config.client_side_validation && filter_month.nil?
+        fail ArgumentError, "Missing the required parameter 'filter_month' when calling CloudCostManagementAPI.list_cost_tag_metadata"
+      end
+      allowable_values = ['true', 'false']
+      if @api_client.config.client_side_validation && opts[:'filter_daily'] && !allowable_values.include?(opts[:'filter_daily'])
+        fail ArgumentError, "invalid value for \"filter_daily\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/v2/cost/gcp_uc_config'
+      local_var_path = '/api/v2/cost/tag_metadata'
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'filter[month]'] = filter_month
+      query_params[:'filter[provider]'] = opts[:'filter_provider'] if !opts[:'filter_provider'].nil?
+      query_params[:'filter[metric]'] = opts[:'filter_metric'] if !opts[:'filter_metric'].nil?
+      query_params[:'filter[tag_key]'] = opts[:'filter_tag_key'] if !opts[:'filter_tag_key'].nil?
+      query_params[:'filter[daily]'] = opts[:'filter_daily'] if !opts[:'filter_daily'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -2523,13 +3222,13 @@ module DatadogAPIClient::V2
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'GCPUsageCostConfigsResponse'
+      return_type = opts[:debug_return_type] || 'CostTagKeyMetadataResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
 
       new_options = opts.merge(
-        :operation => :list_cost_gcp_usage_cost_configs,
+        :operation => :list_cost_tag_metadata,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -2541,35 +3240,49 @@ module DatadogAPIClient::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: CloudCostManagementAPI#list_cost_gcp_usage_cost_configs\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: CloudCostManagementAPI#list_cost_tag_metadata\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # List Cloud Cost Management OCI configs.
+    # List available Cloud Cost Management metrics.
     #
-    # @see #list_cost_oci_configs_with_http_info
-    def list_cost_oci_configs(opts = {})
-      data, _status_code, _headers = list_cost_oci_configs_with_http_info(opts)
+    # @see #list_cost_tag_metadata_metrics_with_http_info
+    def list_cost_tag_metadata_metrics(filter_month, opts = {})
+      data, _status_code, _headers = list_cost_tag_metadata_metrics_with_http_info(filter_month, opts)
       data
     end
 
-    # List Cloud Cost Management OCI configs.
+    # List available Cloud Cost Management metrics.
     #
-    # List the OCI configs.
+    # List Cloud Cost Management metrics that have data for the requested period.
     #
+    # @param filter_month [String] The month to scope the query to, in `YYYY-MM` format.
     # @param opts [Hash] the optional parameters
-    # @return [Array<(OCIConfigsResponse, Integer, Hash)>] OCIConfigsResponse data, response status code and response headers
-    def list_cost_oci_configs_with_http_info(opts = {})
+    # @option opts [String] :filter_provider Filter results to a specific provider. Common cloud values are `aws`, `azure`, `gcp`, `Oracle` (OCI), and `custom`. SaaS billing integrations (for example, `Snowflake`, `MongoDB`, `Databricks`) are also accepted using their display-name string. Values are case-sensitive.
+    # @return [Array<(CostMetricsResponse, Integer, Hash)>] CostMetricsResponse data, response status code and response headers
+    def list_cost_tag_metadata_metrics_with_http_info(filter_month, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_cost_tag_metadata_metrics".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_cost_tag_metadata_metrics")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_cost_tag_metadata_metrics"))
+      end
 
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.list_cost_oci_configs ...'
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.list_cost_tag_metadata_metrics ...'
+      end
+      # verify the required parameter 'filter_month' is set
+      if @api_client.config.client_side_validation && filter_month.nil?
+        fail ArgumentError, "Missing the required parameter 'filter_month' when calling CloudCostManagementAPI.list_cost_tag_metadata_metrics"
       end
       # resource path
-      local_var_path = '/api/v2/cost/oci_config'
+      local_var_path = '/api/v2/cost/tag_metadata/metrics'
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'filter[month]'] = filter_month
+      query_params[:'filter[provider]'] = opts[:'filter_provider'] if !opts[:'filter_provider'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -2583,13 +3296,13 @@ module DatadogAPIClient::V2
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'OCIConfigsResponse'
+      return_type = opts[:debug_return_type] || 'CostMetricsResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
 
       new_options = opts.merge(
-        :operation => :list_cost_oci_configs,
+        :operation => :list_cost_tag_metadata_metrics,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -2601,37 +3314,48 @@ module DatadogAPIClient::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: CloudCostManagementAPI#list_cost_oci_configs\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: CloudCostManagementAPI#list_cost_tag_metadata_metrics\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # List Cloud Cost Management tag descriptions.
+    # List Cloud Cost Management tag metadata months.
     #
-    # @see #list_cost_tag_descriptions_with_http_info
-    def list_cost_tag_descriptions(opts = {})
-      data, _status_code, _headers = list_cost_tag_descriptions_with_http_info(opts)
+    # @see #list_cost_tag_metadata_months_with_http_info
+    def list_cost_tag_metadata_months(filter_provider, opts = {})
+      data, _status_code, _headers = list_cost_tag_metadata_months_with_http_info(filter_provider, opts)
       data
     end
 
-    # List Cloud Cost Management tag descriptions.
+    # List Cloud Cost Management tag metadata months.
     #
-    # List Cloud Cost Management tag key descriptions for the organization. Use `filter[cloud]` to scope the result to a single cloud provider; when omitted, both cross-cloud defaults and cloud-specific descriptions are returned.
+    # List months that have Cloud Cost Management tag metadata for a given provider,
+    # ordered most-recent first. The response is capped at 36 months.
     #
+    # @param filter_provider [String] Provider to scope the query to. Use the value of the `providername` tag in CCM (for example, `aws`, `azure`, `gcp`, `Oracle`, `Confluent Cloud`, `Snowflake`). For costs uploaded through the Custom Costs API, use `custom`. Values are case-sensitive.
     # @param opts [Hash] the optional parameters
-    # @option opts [String] :filter_cloud Filter descriptions to a specific cloud provider (for example, `aws`). Omit to return descriptions across all clouds.
-    # @return [Array<(CostTagDescriptionsResponse, Integer, Hash)>] CostTagDescriptionsResponse data, response status code and response headers
-    def list_cost_tag_descriptions_with_http_info(opts = {})
+    # @return [Array<(CostTagMetadataMonthsResponse, Integer, Hash)>] CostTagMetadataMonthsResponse data, response status code and response headers
+    def list_cost_tag_metadata_months_with_http_info(filter_provider, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_cost_tag_metadata_months".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_cost_tag_metadata_months")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_cost_tag_metadata_months"))
+      end
 
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.list_cost_tag_descriptions ...'
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.list_cost_tag_metadata_months ...'
+      end
+      # verify the required parameter 'filter_provider' is set
+      if @api_client.config.client_side_validation && filter_provider.nil?
+        fail ArgumentError, "Missing the required parameter 'filter_provider' when calling CloudCostManagementAPI.list_cost_tag_metadata_months"
       end
       # resource path
-      local_var_path = '/api/v2/cost/tag_descriptions'
+      local_var_path = '/api/v2/cost/tag_metadata/months'
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'filter[cloud]'] = opts[:'filter_cloud'] if !opts[:'filter_cloud'].nil?
+      query_params[:'filter[provider]'] = filter_provider
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -2645,13 +3369,13 @@ module DatadogAPIClient::V2
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'CostTagDescriptionsResponse'
+      return_type = opts[:debug_return_type] || 'CostTagMetadataMonthsResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
 
       new_options = opts.merge(
-        :operation => :list_cost_tag_descriptions,
+        :operation => :list_cost_tag_metadata_months,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -2663,39 +3387,49 @@ module DatadogAPIClient::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: CloudCostManagementAPI#list_cost_tag_descriptions\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: CloudCostManagementAPI#list_cost_tag_metadata_months\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # List Cloud Cost Management tag keys.
+    # List Cloud Cost Management orchestrators.
     #
-    # @see #list_cost_tag_keys_with_http_info
-    def list_cost_tag_keys(opts = {})
-      data, _status_code, _headers = list_cost_tag_keys_with_http_info(opts)
+    # @see #list_cost_tag_metadata_orchestrators_with_http_info
+    def list_cost_tag_metadata_orchestrators(filter_month, opts = {})
+      data, _status_code, _headers = list_cost_tag_metadata_orchestrators_with_http_info(filter_month, opts)
       data
     end
 
-    # List Cloud Cost Management tag keys.
+    # List Cloud Cost Management orchestrators.
     #
-    # List Cloud Cost Management tag keys.
+    # List container orchestrators (for example, `kubernetes`, `ecs`) detected in Cloud Cost Management data for the requested period.
     #
+    # @param filter_month [String] The month to scope the query to, in `YYYY-MM` format.
     # @param opts [Hash] the optional parameters
-    # @option opts [String] :filter_metric The Cloud Cost Management metric to scope the tag keys to. When omitted, returns tag keys across all metrics.
-    # @option opts [Array<String>] :filter_tags Filter to return only tag keys that appear with the given `key:value` tag values. For example, `filter[tags]=providername:aws` returns tag keys found on the same cost data, such as `is_aws_ec2_compute` and `aws_instance_type`.
-    # @return [Array<(CostTagKeysResponse, Integer, Hash)>] CostTagKeysResponse data, response status code and response headers
-    def list_cost_tag_keys_with_http_info(opts = {})
+    # @option opts [String] :filter_provider Filter results to a specific provider. Common cloud values are `aws`, `azure`, `gcp`, `Oracle` (OCI), and `custom`. SaaS billing integrations (for example, `Snowflake`, `MongoDB`, `Databricks`) are also accepted using their display-name string. Values are case-sensitive.
+    # @return [Array<(CostOrchestratorsResponse, Integer, Hash)>] CostOrchestratorsResponse data, response status code and response headers
+    def list_cost_tag_metadata_orchestrators_with_http_info(filter_month, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_cost_tag_metadata_orchestrators".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_cost_tag_metadata_orchestrators")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_cost_tag_metadata_orchestrators"))
+      end
 
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.list_cost_tag_keys ...'
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.list_cost_tag_metadata_orchestrators ...'
+      end
+      # verify the required parameter 'filter_month' is set
+      if @api_client.config.client_side_validation && filter_month.nil?
+        fail ArgumentError, "Missing the required parameter 'filter_month' when calling CloudCostManagementAPI.list_cost_tag_metadata_orchestrators"
       end
       # resource path
-      local_var_path = '/api/v2/cost/tag_keys'
+      local_var_path = '/api/v2/cost/tag_metadata/orchestrators'
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'filter[metric]'] = opts[:'filter_metric'] if !opts[:'filter_metric'].nil?
-      query_params[:'filter[tags]'] = @api_client.build_collection_param(opts[:'filter_tags'], :multi) if !opts[:'filter_tags'].nil?
+      query_params[:'filter[month]'] = filter_month
+      query_params[:'filter[provider]'] = opts[:'filter_provider'] if !opts[:'filter_provider'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -2709,13 +3443,13 @@ module DatadogAPIClient::V2
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'CostTagKeysResponse'
+      return_type = opts[:debug_return_type] || 'CostOrchestratorsResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
 
       new_options = opts.merge(
-        :operation => :list_cost_tag_keys,
+        :operation => :list_cost_tag_metadata_orchestrators,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -2724,11 +3458,10 @@ module DatadogAPIClient::V2
         :return_type => return_type,
         :api_version => "V2"
       )
-      new_options[:query_string_normalizer] = HTTParty::Request::NON_RAILS_QUERY_STRING_NORMALIZER
 
       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: CloudCostManagementAPI#list_cost_tag_keys\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: CloudCostManagementAPI#list_cost_tag_metadata_orchestrators\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
@@ -3260,6 +3993,83 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Search cost recommendations.
+    #
+    # @see #search_cost_recommendations_with_http_info
+    def search_cost_recommendations(body, opts = {})
+      data, _status_code, _headers = search_cost_recommendations_with_http_info(body, opts)
+      data
+    end
+
+    # Search cost recommendations.
+    #
+    # List cost recommendations matching a filter, with pagination and sorting.
+    #
+    # @param body [RecommendationsFilterRequest] 
+    # @param opts [Hash] the optional parameters
+    # @option opts [String] :page_size Number of results per page (1–10000).
+    # @option opts [String] :page_token Pagination token from a previous response.
+    # @return [Array<(CostRecommendationArray, Integer, Hash)>] CostRecommendationArray data, response status code and response headers
+    def search_cost_recommendations_with_http_info(body, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.search_cost_recommendations".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.search_cost_recommendations")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.search_cost_recommendations"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.search_cost_recommendations ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling CloudCostManagementAPI.search_cost_recommendations"
+      end
+      # resource path
+      local_var_path = '/api/v2/cost/recommendations'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'page[size]'] = opts[:'page_size'] if !opts[:'page_size'].nil?
+      query_params[:'page[token]'] = opts[:'page_token'] if !opts[:'page_token'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CostRecommendationArray'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :search_cost_recommendations,
+        :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::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CloudCostManagementAPI#search_cost_recommendations\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Update Cloud Cost Management AWS CUR config.
     #
     # @see #update_cost_awscur_config_with_http_info
@@ -3767,6 +4577,152 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Upsert a Cloud Cost Management tag description.
+    #
+    # @see #upsert_cost_tag_description_by_key_with_http_info
+    def upsert_cost_tag_description_by_key(tag_key, body, opts = {})
+      upsert_cost_tag_description_by_key_with_http_info(tag_key, body, opts)
+      nil
+    end
+
+    # Upsert a Cloud Cost Management tag description.
+    #
+    # Create or update a Cloud Cost Management tag key description. The new description and optional cloud scoping are supplied in the request body. Omit `cloud` to set a cross-cloud default for the tag key.
+    #
+    # @param tag_key [String] The tag key whose description is being upserted.
+    # @param body [CostTagDescriptionUpsertRequest] 
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def upsert_cost_tag_description_by_key_with_http_info(tag_key, body, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.upsert_cost_tag_description_by_key ...'
+      end
+      # verify the required parameter 'tag_key' is set
+      if @api_client.config.client_side_validation && tag_key.nil?
+        fail ArgumentError, "Missing the required parameter 'tag_key' when calling CloudCostManagementAPI.upsert_cost_tag_description_by_key"
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling CloudCostManagementAPI.upsert_cost_tag_description_by_key"
+      end
+      # resource path
+      local_var_path = '/api/v2/cost/tag_descriptions/{tag_key}'.sub('{tag_key}', CGI.escape(tag_key.to_s).gsub('%2F', '/'))
+
+      # 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(['*/*'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :upsert_cost_tag_description_by_key,
+        :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::Put, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CloudCostManagementAPI#upsert_cost_tag_description_by_key\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Create or replace a budget's custom forecast.
+    #
+    # @see #upsert_custom_forecast_with_http_info
+    def upsert_custom_forecast(body, opts = {})
+      data, _status_code, _headers = upsert_custom_forecast_with_http_info(body, opts)
+      data
+    end
+
+    # Create or replace a budget's custom forecast.
+    #
+    # Create or replace the custom forecast for an existing budget.
+    # Pass an empty `entries` list to delete the custom forecast for the budget.
+    #
+    # @param body [CustomForecastUpsertRequest] 
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(CustomForecastResponse, Integer, Hash)>] CustomForecastResponse data, response status code and response headers
+    def upsert_custom_forecast_with_http_info(body, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.upsert_custom_forecast".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.upsert_custom_forecast")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.upsert_custom_forecast"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.upsert_custom_forecast ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling CloudCostManagementAPI.upsert_custom_forecast"
+      end
+      # resource path
+      local_var_path = '/api/v2/cost/budget/custom-forecast'
+
+      # 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'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CustomForecastResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :upsert_custom_forecast,
+        :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::Put, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CloudCostManagementAPI#upsert_custom_forecast\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Validate budget.
     #
     # @see #validate_budget_with_http_info