datadog_api_client 2.54.0 → 2.55.0

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

@@ -33,6 +33,8 @@ module DatadogAPIClient::V2
 
     # Configure tags for multiple metrics.
     #
+    # **Note**: This endpoint is deprecated. Use [Tag Indexing Rules](/api/latest/metrics/#create-a-tag-indexing-rule) (`POST /api/v2/metrics/tag-indexing-rules`) instead.
+    #
     # Create and define a list of queryable tag keys for a set of existing count, gauge, rate, and distribution metrics.
     # Metrics are selected by passing a metric name prefix. Use the Delete method of this API path to remove tag configurations.
     # Results can be sent to a set of account email addresses, just like the same operation in the Datadog web app.
@@ -41,10 +43,13 @@ module DatadogAPIClient::V2
     # the same exclusion state, metric tag configurations do not support mixed inclusion and exclusion for tags on the same metric.
     # Can only be used with application keys of users with the `Manage Tags for Metrics` permission.
     #
+    # @deprecated This API is deprecated.
+    #
     # @param body [MetricBulkTagConfigCreateRequest] 
     # @param opts [Hash] the optional parameters
     # @return [Array<(MetricBulkTagConfigResponse, Integer, Hash)>] MetricBulkTagConfigResponse data, response status code and response headers
     def create_bulk_tags_metrics_configuration_with_http_info(body, opts = {})
+      warn "[DEPRECATION] `CreateBulkTagsMetricsConfiguration` is deprecated."
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: MetricsAPI.create_bulk_tags_metrics_configuration ...'
@@ -172,6 +177,148 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Create a tag indexing rule.
+    #
+    # @see #create_tag_indexing_rule_with_http_info
+    def create_tag_indexing_rule(body, opts = {})
+      data, _status_code, _headers = create_tag_indexing_rule_with_http_info(body, opts)
+      data
+    end
+
+    # Create a tag indexing rule.
+    #
+    # Create a tag indexing rule for the org. `rule_order` is assigned server-side as max+1
+    # among existing rules; use the reorder endpoint to change the evaluation order.
+    # Requires the `Manage Tags for Metrics` permission.
+    #
+    # @param body [TagIndexingRuleCreateRequest] 
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(TagIndexingRuleResponse, Integer, Hash)>] TagIndexingRuleResponse data, response status code and response headers
+    def create_tag_indexing_rule_with_http_info(body, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MetricsAPI.create_tag_indexing_rule ...'
+      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 MetricsAPI.create_tag_indexing_rule"
+      end
+      # resource path
+      local_var_path = '/api/v2/metrics/tag-indexing-rules'
+
+      # 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] || 'TagIndexingRuleResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :create_tag_indexing_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::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MetricsAPI#create_tag_indexing_rule\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Create a tag indexing rule exemption.
+    #
+    # @see #create_tag_indexing_rule_exemption_with_http_info
+    def create_tag_indexing_rule_exemption(metric_name, body, opts = {})
+      data, _status_code, _headers = create_tag_indexing_rule_exemption_with_http_info(metric_name, body, opts)
+      data
+    end
+
+    # Create a tag indexing rule exemption.
+    #
+    # Exempt a metric from all tag indexing rules. The response includes the created
+    # exemption resource. Requires the `Manage Tags for Metrics` permission.
+    #
+    # @param metric_name [String] The name of the metric.
+    # @param body [TagIndexingRuleExemptionCreateRequest] 
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(TagIndexingRuleExemptionResponse, Integer, Hash)>] TagIndexingRuleExemptionResponse data, response status code and response headers
+    def create_tag_indexing_rule_exemption_with_http_info(metric_name, body, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MetricsAPI.create_tag_indexing_rule_exemption ...'
+      end
+      # verify the required parameter 'metric_name' is set
+      if @api_client.config.client_side_validation && metric_name.nil?
+        fail ArgumentError, "Missing the required parameter 'metric_name' when calling MetricsAPI.create_tag_indexing_rule_exemption"
+      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 MetricsAPI.create_tag_indexing_rule_exemption"
+      end
+      # resource path
+      local_var_path = '/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptions'.sub('{metric_name}', CGI.escape(metric_name.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'])
+      # 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] || 'TagIndexingRuleExemptionResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :create_tag_indexing_rule_exemption,
+        :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: MetricsAPI#create_tag_indexing_rule_exemption\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Delete tags for multiple metrics.
     #
     # @see #delete_bulk_tags_metrics_configuration_with_http_info
@@ -182,15 +329,20 @@ module DatadogAPIClient::V2
 
     # Delete tags for multiple metrics.
     #
+    # **Note**: This endpoint is deprecated. Use [Tag Indexing Rules](/api/latest/metrics/#create-a-tag-indexing-rule) (`POST /api/v2/metrics/tag-indexing-rules`) instead.
+    #
     # Delete all custom lists of queryable tag keys for a set of existing count, gauge, rate, and distribution metrics.
     # Metrics are selected by passing a metric name prefix.
     # Results can be sent to a set of account email addresses, just like the same operation in the Datadog web app.
     # Can only be used with application keys of users with the `Manage Tags for Metrics` permission.
     #
+    # @deprecated This API is deprecated.
+    #
     # @param body [MetricBulkTagConfigDeleteRequest] 
     # @param opts [Hash] the optional parameters
     # @return [Array<(MetricBulkTagConfigResponse, Integer, Hash)>] MetricBulkTagConfigResponse data, response status code and response headers
     def delete_bulk_tags_metrics_configuration_with_http_info(body, opts = {})
+      warn "[DEPRECATION] `DeleteBulkTagsMetricsConfiguration` is deprecated."
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: MetricsAPI.delete_bulk_tags_metrics_configuration ...'
@@ -309,6 +461,140 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Delete a tag indexing rule.
+    #
+    # @see #delete_tag_indexing_rule_with_http_info
+    def delete_tag_indexing_rule(id, opts = {})
+      delete_tag_indexing_rule_with_http_info(id, opts)
+      nil
+    end
+
+    # Delete a tag indexing rule.
+    #
+    # Soft-delete a tag indexing rule. Idempotent: returns 204 whether the rule existed or was already deleted.
+    # Remaining rules in the org are automatically re-sequenced to keep `rule_order` dense and 1-based.
+    # Requires the `Manage Tags for Metrics` permission.
+    #
+    # @param id [String] ID of the tag indexing rule.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def delete_tag_indexing_rule_with_http_info(id, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MetricsAPI.delete_tag_indexing_rule ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling MetricsAPI.delete_tag_indexing_rule"
+      end
+      # resource path
+      local_var_path = '/api/v2/metrics/tag-indexing-rules/{id}'.sub('{id}', CGI.escape(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, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :delete_tag_indexing_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::Delete, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MetricsAPI#delete_tag_indexing_rule\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Delete a tag indexing rule exemption.
+    #
+    # @see #delete_tag_indexing_rule_exemption_with_http_info
+    def delete_tag_indexing_rule_exemption(metric_name, opts = {})
+      delete_tag_indexing_rule_exemption_with_http_info(metric_name, opts)
+      nil
+    end
+
+    # Delete a tag indexing rule exemption.
+    #
+    # Remove a metric's exemption from tag indexing rules. Idempotent: returns 204 whether or not
+    # an exemption existed. Any associated legacy tag configuration record is also removed.
+    # Requires the `Manage Tags for Metrics` permission.
+    #
+    # @param metric_name [String] The name of the metric.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def delete_tag_indexing_rule_exemption_with_http_info(metric_name, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MetricsAPI.delete_tag_indexing_rule_exemption ...'
+      end
+      # verify the required parameter 'metric_name' is set
+      if @api_client.config.client_side_validation && metric_name.nil?
+        fail ArgumentError, "Missing the required parameter 'metric_name' when calling MetricsAPI.delete_tag_indexing_rule_exemption"
+      end
+      # resource path
+      local_var_path = '/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptions'.sub('{metric_name}', CGI.escape(metric_name.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, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :delete_tag_indexing_rule_exemption,
+        :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: MetricsAPI#delete_tag_indexing_rule_exemption\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Tag Configuration Cardinality Estimator.
     #
     # @see #estimate_metrics_output_series_with_http_info
@@ -323,43 +609,173 @@ module DatadogAPIClient::V2
     #
     # @param metric_name [String] The name of the metric.
     # @param opts [Hash] the optional parameters
-    # @option opts [String] :filter_groups Comma-separated list of tag keys that the metric is configured to query with. For example: `filter[groups]=app,host`.
-    # @option opts [Integer] :filter_hours_ago The number of hours of look back (from now) to estimate cardinality with. If unspecified, it defaults to 0 hours.
-    # @option opts [Integer] :filter_num_aggregations Deprecated. Number of aggregations has no impact on volume.
-    # @option opts [Boolean] :filter_pct A boolean, for distribution metrics only, to estimate cardinality if the metric includes additional percentile aggregators.
-    # @option opts [Integer] :filter_timespan_h A window, in hours, from the look back to estimate cardinality with. The minimum and default is 1 hour.
-    # @return [Array<(MetricEstimateResponse, Integer, Hash)>] MetricEstimateResponse data, response status code and response headers
-    def estimate_metrics_output_series_with_http_info(metric_name, opts = {})
+    # @option opts [String] :filter_groups Comma-separated list of tag keys that the metric is configured to query with. For example: `filter[groups]=app,host`.
+    # @option opts [Integer] :filter_hours_ago The number of hours of look back (from now) to estimate cardinality with. If unspecified, it defaults to 0 hours.
+    # @option opts [Integer] :filter_num_aggregations Deprecated. Number of aggregations has no impact on volume.
+    # @option opts [Boolean] :filter_pct A boolean, for distribution metrics only, to estimate cardinality if the metric includes additional percentile aggregators.
+    # @option opts [Integer] :filter_timespan_h A window, in hours, from the look back to estimate cardinality with. The minimum and default is 1 hour.
+    # @return [Array<(MetricEstimateResponse, Integer, Hash)>] MetricEstimateResponse data, response status code and response headers
+    def estimate_metrics_output_series_with_http_info(metric_name, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MetricsAPI.estimate_metrics_output_series ...'
+      end
+      # verify the required parameter 'metric_name' is set
+      if @api_client.config.client_side_validation && metric_name.nil?
+        fail ArgumentError, "Missing the required parameter 'metric_name' when calling MetricsAPI.estimate_metrics_output_series"
+      end
+      if @api_client.config.client_side_validation && !opts[:'filter_hours_ago'].nil? && opts[:'filter_hours_ago'] > 2147483647
+        fail ArgumentError, 'invalid value for "opts[:"filter_hours_ago"]" when calling MetricsAPI.estimate_metrics_output_series, must be smaller than or equal to 2147483647.'
+      end
+      if @api_client.config.client_side_validation && !opts[:'filter_hours_ago'].nil? && opts[:'filter_hours_ago'] < 49
+        fail ArgumentError, 'invalid value for "opts[:"filter_hours_ago"]" when calling MetricsAPI.estimate_metrics_output_series, must be greater than or equal to 49.'
+      end
+      if @api_client.config.client_side_validation && !opts[:'filter_num_aggregations'].nil? && opts[:'filter_num_aggregations'] > 9
+        fail ArgumentError, 'invalid value for "opts[:"filter_num_aggregations"]" when calling MetricsAPI.estimate_metrics_output_series, must be smaller than or equal to 9.'
+      end
+      if @api_client.config.client_side_validation && !opts[:'filter_timespan_h'].nil? && opts[:'filter_timespan_h'] > 2147483647
+        fail ArgumentError, 'invalid value for "opts[:"filter_timespan_h"]" when calling MetricsAPI.estimate_metrics_output_series, must be smaller than or equal to 2147483647.'
+      end
+      # resource path
+      local_var_path = '/api/v2/metrics/{metric_name}/estimate'.sub('{metric_name}', CGI.escape(metric_name.to_s).gsub('%2F', '/'))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'filter[groups]'] = opts[:'filter_groups'] if !opts[:'filter_groups'].nil?
+      query_params[:'filter[hours_ago]'] = opts[:'filter_hours_ago'] if !opts[:'filter_hours_ago'].nil?
+      query_params[:'filter[num_aggregations]'] = opts[:'filter_num_aggregations'] if !opts[:'filter_num_aggregations'].nil?
+      query_params[:'filter[pct]'] = opts[:'filter_pct'] if !opts[:'filter_pct'].nil?
+      query_params[:'filter[timespan_h]'] = opts[:'filter_timespan_h'] if !opts[:'filter_timespan_h'].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] || 'MetricEstimateResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :estimate_metrics_output_series,
+        :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: MetricsAPI#estimate_metrics_output_series\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get tag key cardinality details.
+    #
+    # @see #get_metric_tag_cardinality_details_with_http_info
+    def get_metric_tag_cardinality_details(metric_name, opts = {})
+      data, _status_code, _headers = get_metric_tag_cardinality_details_with_http_info(metric_name, opts)
+      data
+    end
+
+    # Get tag key cardinality details.
+    #
+    # Returns the cardinality details of tags for a specific metric.
+    #
+    # @param metric_name [String] The name of the metric.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(MetricTagCardinalitiesResponse, Integer, Hash)>] MetricTagCardinalitiesResponse data, response status code and response headers
+    def get_metric_tag_cardinality_details_with_http_info(metric_name, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MetricsAPI.get_metric_tag_cardinality_details ...'
+      end
+      # verify the required parameter 'metric_name' is set
+      if @api_client.config.client_side_validation && metric_name.nil?
+        fail ArgumentError, "Missing the required parameter 'metric_name' when calling MetricsAPI.get_metric_tag_cardinality_details"
+      end
+      # resource path
+      local_var_path = '/api/v2/metrics/{metric_name}/tag-cardinalities'.sub('{metric_name}', CGI.escape(metric_name.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] || 'MetricTagCardinalitiesResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :get_metric_tag_cardinality_details,
+        :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: MetricsAPI#get_metric_tag_cardinality_details\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get a tag indexing rule.
+    #
+    # @see #get_tag_indexing_rule_with_http_info
+    def get_tag_indexing_rule(id, opts = {})
+      data, _status_code, _headers = get_tag_indexing_rule_with_http_info(id, opts)
+      data
+    end
+
+    # Get a tag indexing rule.
+    #
+    # Get a single tag indexing rule by its UUID.
+    #
+    # @param id [String] ID of the tag indexing rule.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(TagIndexingRuleResponse, Integer, Hash)>] TagIndexingRuleResponse data, response status code and response headers
+    def get_tag_indexing_rule_with_http_info(id, opts = {})
 
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: MetricsAPI.estimate_metrics_output_series ...'
-      end
-      # verify the required parameter 'metric_name' is set
-      if @api_client.config.client_side_validation && metric_name.nil?
-        fail ArgumentError, "Missing the required parameter 'metric_name' when calling MetricsAPI.estimate_metrics_output_series"
-      end
-      if @api_client.config.client_side_validation && !opts[:'filter_hours_ago'].nil? && opts[:'filter_hours_ago'] > 2147483647
-        fail ArgumentError, 'invalid value for "opts[:"filter_hours_ago"]" when calling MetricsAPI.estimate_metrics_output_series, must be smaller than or equal to 2147483647.'
-      end
-      if @api_client.config.client_side_validation && !opts[:'filter_hours_ago'].nil? && opts[:'filter_hours_ago'] < 49
-        fail ArgumentError, 'invalid value for "opts[:"filter_hours_ago"]" when calling MetricsAPI.estimate_metrics_output_series, must be greater than or equal to 49.'
-      end
-      if @api_client.config.client_side_validation && !opts[:'filter_num_aggregations'].nil? && opts[:'filter_num_aggregations'] > 9
-        fail ArgumentError, 'invalid value for "opts[:"filter_num_aggregations"]" when calling MetricsAPI.estimate_metrics_output_series, must be smaller than or equal to 9.'
+        @api_client.config.logger.debug 'Calling API: MetricsAPI.get_tag_indexing_rule ...'
       end
-      if @api_client.config.client_side_validation && !opts[:'filter_timespan_h'].nil? && opts[:'filter_timespan_h'] > 2147483647
-        fail ArgumentError, 'invalid value for "opts[:"filter_timespan_h"]" when calling MetricsAPI.estimate_metrics_output_series, must be smaller than or equal to 2147483647.'
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling MetricsAPI.get_tag_indexing_rule"
       end
       # resource path
-      local_var_path = '/api/v2/metrics/{metric_name}/estimate'.sub('{metric_name}', CGI.escape(metric_name.to_s).gsub('%2F', '/'))
+      local_var_path = '/api/v2/metrics/tag-indexing-rules/{id}'.sub('{id}', CGI.escape(id.to_s).gsub('%2F', '/'))
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'filter[groups]'] = opts[:'filter_groups'] if !opts[:'filter_groups'].nil?
-      query_params[:'filter[hours_ago]'] = opts[:'filter_hours_ago'] if !opts[:'filter_hours_ago'].nil?
-      query_params[:'filter[num_aggregations]'] = opts[:'filter_num_aggregations'] if !opts[:'filter_num_aggregations'].nil?
-      query_params[:'filter[pct]'] = opts[:'filter_pct'] if !opts[:'filter_pct'].nil?
-      query_params[:'filter[timespan_h]'] = opts[:'filter_timespan_h'] if !opts[:'filter_timespan_h'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -373,13 +789,13 @@ module DatadogAPIClient::V2
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'MetricEstimateResponse'
+      return_type = opts[:debug_return_type] || 'TagIndexingRuleResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
 
       new_options = opts.merge(
-        :operation => :estimate_metrics_output_series,
+        :operation => :get_tag_indexing_rule,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -391,37 +807,40 @@ 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: MetricsAPI#estimate_metrics_output_series\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: MetricsAPI#get_tag_indexing_rule\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Get tag key cardinality details.
+    # Get a tag indexing rule exemption.
     #
-    # @see #get_metric_tag_cardinality_details_with_http_info
-    def get_metric_tag_cardinality_details(metric_name, opts = {})
-      data, _status_code, _headers = get_metric_tag_cardinality_details_with_http_info(metric_name, opts)
+    # @see #get_tag_indexing_rule_exemption_with_http_info
+    def get_tag_indexing_rule_exemption(metric_name, opts = {})
+      data, _status_code, _headers = get_tag_indexing_rule_exemption_with_http_info(metric_name, opts)
       data
     end
 
-    # Get tag key cardinality details.
+    # Get a tag indexing rule exemption.
     #
-    # Returns the cardinality details of tags for a specific metric.
+    # Returns why a metric is excluded from tag indexing rules.
+    # Returns 200 with `kind=exemption` when an explicit exemption exists, 200 with
+    # `kind=legacy_tag_configuration` when the metric has a legacy tag configuration acting as an
+    # implicit exclusion, or 404 when neither applies.
     #
     # @param metric_name [String] The name of the metric.
     # @param opts [Hash] the optional parameters
-    # @return [Array<(MetricTagCardinalitiesResponse, Integer, Hash)>] MetricTagCardinalitiesResponse data, response status code and response headers
-    def get_metric_tag_cardinality_details_with_http_info(metric_name, opts = {})
+    # @return [Array<(TagIndexingRuleExemptionResponse, Integer, Hash)>] TagIndexingRuleExemptionResponse data, response status code and response headers
+    def get_tag_indexing_rule_exemption_with_http_info(metric_name, opts = {})
 
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: MetricsAPI.get_metric_tag_cardinality_details ...'
+        @api_client.config.logger.debug 'Calling API: MetricsAPI.get_tag_indexing_rule_exemption ...'
       end
       # verify the required parameter 'metric_name' is set
       if @api_client.config.client_side_validation && metric_name.nil?
-        fail ArgumentError, "Missing the required parameter 'metric_name' when calling MetricsAPI.get_metric_tag_cardinality_details"
+        fail ArgumentError, "Missing the required parameter 'metric_name' when calling MetricsAPI.get_tag_indexing_rule_exemption"
       end
       # resource path
-      local_var_path = '/api/v2/metrics/{metric_name}/tag-cardinalities'.sub('{metric_name}', CGI.escape(metric_name.to_s).gsub('%2F', '/'))
+      local_var_path = '/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptions'.sub('{metric_name}', CGI.escape(metric_name.to_s).gsub('%2F', '/'))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -438,13 +857,13 @@ module DatadogAPIClient::V2
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'MetricTagCardinalitiesResponse'
+      return_type = opts[:debug_return_type] || 'TagIndexingRuleExemptionResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
 
       new_options = opts.merge(
-        :operation => :get_metric_tag_cardinality_details,
+        :operation => :get_tag_indexing_rule_exemption,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -456,7 +875,7 @@ 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: MetricsAPI#get_metric_tag_cardinality_details\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: MetricsAPI#get_tag_indexing_rule_exemption\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
@@ -785,6 +1204,138 @@ module DatadogAPIClient::V2
         end
     end
 
+    # List tag indexing rules.
+    #
+    # @see #list_tag_indexing_rules_with_http_info
+    def list_tag_indexing_rules(opts = {})
+      data, _status_code, _headers = list_tag_indexing_rules_with_http_info(opts)
+      data
+    end
+
+    # List tag indexing rules.
+    #
+    # List tag indexing rules for an org, sorted by `rule_order`, with offset/limit pagination.
+    #
+    # @param opts [Hash] the optional parameters
+    # @option opts [Integer] :page_limit Page size (1–1000, default 100).
+    # @option opts [Integer] :page_offset Page offset from the start of the list (default 0).
+    # @option opts [String] :search Substring filter on rule name.
+    # @return [Array<(TagIndexingRulesResponse, Integer, Hash)>] TagIndexingRulesResponse data, response status code and response headers
+    def list_tag_indexing_rules_with_http_info(opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MetricsAPI.list_tag_indexing_rules ...'
+      end
+      # resource path
+      local_var_path = '/api/v2/metrics/tag-indexing-rules'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'page[limit]'] = opts[:'page_limit'] if !opts[:'page_limit'].nil?
+      query_params[:'page[offset]'] = opts[:'page_offset'] if !opts[:'page_offset'].nil?
+      query_params[:'search'] = opts[:'search'] if !opts[:'search'].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] || 'TagIndexingRulesResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :list_tag_indexing_rules,
+        :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: MetricsAPI#list_tag_indexing_rules\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List tag indexing rules for a metric.
+    #
+    # @see #list_tag_indexing_rules_for_metric_with_http_info
+    def list_tag_indexing_rules_for_metric(metric_name, opts = {})
+      data, _status_code, _headers = list_tag_indexing_rules_for_metric_with_http_info(metric_name, opts)
+      data
+    end
+
+    # List tag indexing rules for a metric.
+    #
+    # List the tag indexing rules that apply to a given metric, sorted by `rule_order`.
+    # Matching is performed server-side using each rule's `metric_name_matches` glob patterns.
+    #
+    # @param metric_name [String] The name of the metric.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(TagIndexingRulesResponse, Integer, Hash)>] TagIndexingRulesResponse data, response status code and response headers
+    def list_tag_indexing_rules_for_metric_with_http_info(metric_name, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MetricsAPI.list_tag_indexing_rules_for_metric ...'
+      end
+      # verify the required parameter 'metric_name' is set
+      if @api_client.config.client_side_validation && metric_name.nil?
+        fail ArgumentError, "Missing the required parameter 'metric_name' when calling MetricsAPI.list_tag_indexing_rules_for_metric"
+      end
+      # resource path
+      local_var_path = '/api/v2/metrics/{metric_name}/tag-indexing-rules'.sub('{metric_name}', CGI.escape(metric_name.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] || 'TagIndexingRulesResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :list_tag_indexing_rules_for_metric,
+        :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: MetricsAPI#list_tag_indexing_rules_for_metric\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # List tags by metric name.
     #
     # @see #list_tags_by_metric_name_with_http_info
@@ -879,9 +1430,9 @@ module DatadogAPIClient::V2
 
     # List distinct metric volumes by metric name.
     #
-    # View hourly average metric volumes for the given metric name over the look back period.
-    #
-    # Custom metrics generated in-app from other products will return `null` for ingested volumes.
+    # View hourly average cardinality for the given metric name over the look back period.
+    # For Metric Name Pricing customers, view total point volume for the given metric name
+    # over the look back period.
     #
     # @param metric_name [String] The name of the metric.
     # @param opts [Hash] the optional parameters
@@ -1075,6 +1626,75 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Reorder tag indexing rules.
+    #
+    # @see #reorder_tag_indexing_rules_with_http_info
+    def reorder_tag_indexing_rules(body, opts = {})
+      reorder_tag_indexing_rules_with_http_info(body, opts)
+      nil
+    end
+
+    # Reorder tag indexing rules.
+    #
+    # Atomically re-sequence the tag indexing rules for an org to match the supplied list of rule UUIDs.
+    # The server assigns `rule_order` 1, 2, … matching each rule UUID by position in the list.
+    # Requires the `Manage Tags for Metrics` permission.
+    #
+    # @param body [TagIndexingRuleOrderRequest] 
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def reorder_tag_indexing_rules_with_http_info(body, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MetricsAPI.reorder_tag_indexing_rules ...'
+      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 MetricsAPI.reorder_tag_indexing_rules"
+      end
+      # resource path
+      local_var_path = '/api/v2/metrics/tag-indexing-rules/order'
+
+      # 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 => :reorder_tag_indexing_rules,
+        :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: MetricsAPI#reorder_tag_indexing_rules\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Submit metrics.
     #
     # @see #submit_metrics_with_http_info
@@ -1234,5 +1854,79 @@ module DatadogAPIClient::V2
       end
       return data, status_code, headers
     end
+
+    # Update a tag indexing rule.
+    #
+    # @see #update_tag_indexing_rule_with_http_info
+    def update_tag_indexing_rule(id, body, opts = {})
+      data, _status_code, _headers = update_tag_indexing_rule_with_http_info(id, body, opts)
+      data
+    end
+
+    # Update a tag indexing rule.
+    #
+    # Partially update a tag indexing rule. Fields omitted from the request body are left unchanged.
+    # Setting `rule_order` to a value already used by another rule returns 409; use the
+    # reorder endpoint for atomic re-sequencing. Requires the `Manage Tags for Metrics` permission.
+    #
+    # @param id [String] ID of the tag indexing rule.
+    # @param body [TagIndexingRuleUpdateRequest] 
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(TagIndexingRuleResponse, Integer, Hash)>] TagIndexingRuleResponse data, response status code and response headers
+    def update_tag_indexing_rule_with_http_info(id, body, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MetricsAPI.update_tag_indexing_rule ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling MetricsAPI.update_tag_indexing_rule"
+      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 MetricsAPI.update_tag_indexing_rule"
+      end
+      # resource path
+      local_var_path = '/api/v2/metrics/tag-indexing-rules/{id}'.sub('{id}', CGI.escape(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'])
+      # 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] || 'TagIndexingRuleResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :update_tag_indexing_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::Put, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MetricsAPI#update_tag_indexing_rule\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
   end
 end