datadog_api_client 2.55.0 → 2.57.0

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

@@ -101,6 +101,82 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Enable historical metrics ingestion.
+    #
+    # @see #create_historical_metrics_configuration_with_http_info
+    def create_historical_metrics_configuration(body, opts = {})
+      data, _status_code, _headers = create_historical_metrics_configuration_with_http_info(body, opts)
+      data
+    end
+
+    # Enable historical metrics ingestion.
+    #
+    # Enable historical metrics ingestion (late data ingestion) for a metric. Idempotent:
+    # enabling an already-enabled metric returns 200 instead of 201. Not supported for
+    # distribution metrics, metrics with an existing tag configuration, or most standard
+    # (non-custom) metrics.
+    #
+    # @param body [HistoricalMetricsConfigurationCreateRequest] 
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(HistoricalMetricsConfigurationResponse, Integer, Hash)>] HistoricalMetricsConfigurationResponse data, response status code and response headers
+    def create_historical_metrics_configuration_with_http_info(body, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.create_historical_metrics_configuration".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.create_historical_metrics_configuration")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.create_historical_metrics_configuration"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MetricsAPI.create_historical_metrics_configuration ...'
+      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_historical_metrics_configuration"
+      end
+      # resource path
+      local_var_path = '/api/v2/metrics/historical-metrics-configurations'
+
+      # 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] || 'HistoricalMetricsConfigurationResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :create_historical_metrics_configuration,
+        :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_historical_metrics_configuration\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Create a tag configuration.
     #
     # @see #create_tag_configuration_with_http_info
@@ -195,6 +271,12 @@ module DatadogAPIClient::V2
     # @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 = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.create_tag_indexing_rule".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.create_tag_indexing_rule")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.create_tag_indexing_rule"))
+      end
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: MetricsAPI.create_tag_indexing_rule ...'
@@ -264,6 +346,12 @@ module DatadogAPIClient::V2
     # @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 = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.create_tag_indexing_rule_exemption".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.create_tag_indexing_rule_exemption")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.create_tag_indexing_rule_exemption"))
+      end
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: MetricsAPI.create_tag_indexing_rule_exemption ...'
@@ -394,6 +482,79 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Delete a historical metrics configuration.
+    #
+    # @see #delete_historical_metrics_configuration_with_http_info
+    def delete_historical_metrics_configuration(metric_name, opts = {})
+      delete_historical_metrics_configuration_with_http_info(metric_name, opts)
+      nil
+    end
+
+    # Delete a historical metrics configuration.
+    #
+    # Disable historical metrics ingestion for a metric. Idempotent: always returns 204,
+    # whether or not the configuration existed or the metric itself still exists, so that
+    # Terraform destroy succeeds for a metric removed out-of-band.
+    #
+    # @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_historical_metrics_configuration_with_http_info(metric_name, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.delete_historical_metrics_configuration".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.delete_historical_metrics_configuration")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.delete_historical_metrics_configuration"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MetricsAPI.delete_historical_metrics_configuration ...'
+      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_historical_metrics_configuration"
+      end
+      # resource path
+      local_var_path = '/api/v2/metrics/historical-metrics-configurations/{metric_name}'.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_historical_metrics_configuration,
+        :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_historical_metrics_configuration\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Delete a tag configuration.
     #
     # @see #delete_tag_configuration_with_http_info
@@ -479,6 +640,12 @@ module DatadogAPIClient::V2
     # @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 = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.delete_tag_indexing_rule".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.delete_tag_indexing_rule")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.delete_tag_indexing_rule"))
+      end
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: MetricsAPI.delete_tag_indexing_rule ...'
@@ -546,6 +713,12 @@ module DatadogAPIClient::V2
     # @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 = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.delete_tag_indexing_rule_exemption".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.delete_tag_indexing_rule_exemption")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.delete_tag_indexing_rule_exemption"))
+      end
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: MetricsAPI.delete_tag_indexing_rule_exemption ...'
@@ -682,6 +855,79 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Get a historical metrics configuration.
+    #
+    # @see #get_historical_metrics_configuration_with_http_info
+    def get_historical_metrics_configuration(metric_name, opts = {})
+      data, _status_code, _headers = get_historical_metrics_configuration_with_http_info(metric_name, opts)
+      data
+    end
+
+    # Get a historical metrics configuration.
+    #
+    # Get the historical metrics ingestion configuration for a metric. Existence of the
+    # resource means historical metrics ingestion is enabled; returns 404 when it is not
+    # enabled for the metric.
+    #
+    # @param metric_name [String] The name of the metric.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(HistoricalMetricsConfigurationResponse, Integer, Hash)>] HistoricalMetricsConfigurationResponse data, response status code and response headers
+    def get_historical_metrics_configuration_with_http_info(metric_name, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.get_historical_metrics_configuration".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.get_historical_metrics_configuration")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.get_historical_metrics_configuration"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MetricsAPI.get_historical_metrics_configuration ...'
+      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_historical_metrics_configuration"
+      end
+      # resource path
+      local_var_path = '/api/v2/metrics/historical-metrics-configurations/{metric_name}'.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] || 'HistoricalMetricsConfigurationResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :get_historical_metrics_configuration,
+        :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_historical_metrics_configuration\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
@@ -763,6 +1009,12 @@ module DatadogAPIClient::V2
     # @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 = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.get_tag_indexing_rule".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.get_tag_indexing_rule")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.get_tag_indexing_rule"))
+      end
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: MetricsAPI.get_tag_indexing_rule ...'
@@ -831,6 +1083,12 @@ module DatadogAPIClient::V2
     # @param opts [Hash] the optional parameters
     # @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 = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.get_tag_indexing_rule_exemption".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.get_tag_indexing_rule_exemption")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.get_tag_indexing_rule_exemption"))
+      end
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: MetricsAPI.get_tag_indexing_rule_exemption ...'
@@ -1092,7 +1350,8 @@ module DatadogAPIClient::V2
     # Query parameters use bracket notation (for example, `filter[tags]`, `filter[queried][window][seconds]`). Pass them as standard URL query strings, URL-encoding the brackets if your client does not handle them. For example: `GET /api/v2/metrics?filter[tags]=env:prod&window[seconds]=86400&page[size]=500`.
     #
     # @param opts [Hash] the optional parameters
-    # @option opts [Boolean] :filter_configured Only return custom metrics that have been configured with Metrics Without Limits.
+    # @option opts [Boolean] :filter_configured Only return custom metrics that have been configured (`true`) or not configured (`false`) with Metrics Without Limits.
+    # @option opts [Boolean] :filter_is_configurable Only return metrics that are eligible (`true`) or ineligible (`false`) for configuration with Metrics Without Limits.
     # @option opts [String] :filter_tags_configured Only return metrics that have the given tag key(s) in their Metrics Without Limits configuration (included or excluded).
     # @option opts [MetricTagConfigurationMetricTypeCategory] :filter_metric_type Only return metrics of the given metric type.
     # @option opts [Boolean] :filter_include_percentiles Only return distribution metrics that have percentile aggregations enabled (true) or disabled (false).
@@ -1100,6 +1359,8 @@ module DatadogAPIClient::V2
     # @option opts [Integer] :filter_queried_window_seconds This parameter has no effect unless `filter[queried]` is also set. Only return metrics that have been queried or not queried in the specified window. The default value is 2,592,000 seconds (30 days), the maximum value is 15,552,000 seconds (180 days), and the minimum value is 1 second. For example: `filter[queried]=true&filter[queried][window][seconds]=604800`.
     # @option opts [String] :filter_tags Only return metrics that were submitted with tags matching this expression. You can use AND, OR, IN, and wildcards. For example: `filter[tags]=env IN (staging,test) AND service:web*`.
     # @option opts [Boolean] :filter_related_assets Only return metrics that are used in at least one dashboard, monitor, notebook, or SLO.
+    # @option opts [String] :include Include related resources in the response. Set to `metric_volumes` to include indexed and ingested volume counts for each metric.
+    # @option opts [String] :sort Sort results by metric volume. Prefix a key with `-` for descending order. Supported keys: `metric_volumes.indexed_volume`, `metric_volumes.ingested_volume`, `metric_volumes.indexed_volume_delta`, `metric_volumes.ingested_volume_delta`. Requires a paginated request (`page[size]` or `page[cursor]`).
     # @option opts [Integer] :window_seconds Only return metrics that have been actively reporting in the specified window. The default value is 3600 seconds (1 hour), the maximum value is 2,592,000 seconds (30 days), and the minimum value is 1 second.
     # @option opts [Integer] :page_size Maximum number of results per page. Send `page[size]` on the first request to opt in to pagination. On each subsequent request, send `page[cursor]` set to the value of `meta.pagination.next_cursor` from the previous response. The default value is 10000, the maximum value is 10000, and the minimum value is 1.
     # @option opts [String] :page_cursor Cursor for pagination. Use `page[size]` to opt-in to pagination and get the first page; for subsequent pages, use the value from `meta.pagination.next_cursor` in the response. Pagination is complete when `next_cursor` is null.
@@ -1137,6 +1398,7 @@ module DatadogAPIClient::V2
       # query parameters
       query_params = opts[:query_params] || {}
       query_params[:'filter[configured]'] = opts[:'filter_configured'] if !opts[:'filter_configured'].nil?
+      query_params[:'filter[is_configurable]'] = opts[:'filter_is_configurable'] if !opts[:'filter_is_configurable'].nil?
       query_params[:'filter[tags_configured]'] = opts[:'filter_tags_configured'] if !opts[:'filter_tags_configured'].nil?
       query_params[:'filter[metric_type]'] = opts[:'filter_metric_type'] if !opts[:'filter_metric_type'].nil?
       query_params[:'filter[include_percentiles]'] = opts[:'filter_include_percentiles'] if !opts[:'filter_include_percentiles'].nil?
@@ -1144,6 +1406,8 @@ module DatadogAPIClient::V2
       query_params[:'filter[queried][window][seconds]'] = opts[:'filter_queried_window_seconds'] if !opts[:'filter_queried_window_seconds'].nil?
       query_params[:'filter[tags]'] = opts[:'filter_tags'] if !opts[:'filter_tags'].nil?
       query_params[:'filter[related_assets]'] = opts[:'filter_related_assets'] if !opts[:'filter_related_assets'].nil?
+      query_params[:'include'] = opts[:'include'] if !opts[:'include'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
       query_params[:'window[seconds]'] = opts[:'window_seconds'] if !opts[:'window_seconds'].nil?
       query_params[:'page[size]'] = opts[:'page_size'] if !opts[:'page_size'].nil?
       query_params[:'page[cursor]'] = opts[:'page_cursor'] if !opts[:'page_cursor'].nil?
@@ -1222,6 +1486,12 @@ module DatadogAPIClient::V2
     # @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 = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_tag_indexing_rules".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_tag_indexing_rules")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_tag_indexing_rules"))
+      end
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: MetricsAPI.list_tag_indexing_rules ...'
@@ -1287,6 +1557,12 @@ module DatadogAPIClient::V2
     # @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 = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_tag_indexing_rules_for_metric".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_tag_indexing_rules_for_metric")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_tag_indexing_rules_for_metric"))
+      end
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: MetricsAPI.list_tag_indexing_rules_for_metric ...'
@@ -1638,12 +1914,19 @@ module DatadogAPIClient::V2
     #
     # 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.
+    # The UUIDs of all active rules must be provided; omitting any active rule UUID returns a 400 error.
     # 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 = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.reorder_tag_indexing_rules".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.reorder_tag_indexing_rules")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.reorder_tag_indexing_rules"))
+      end
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: MetricsAPI.reorder_tag_indexing_rules ...'
@@ -1874,6 +2157,12 @@ module DatadogAPIClient::V2
     # @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 = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.update_tag_indexing_rule".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.update_tag_indexing_rule")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.update_tag_indexing_rule"))
+      end
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: MetricsAPI.update_tag_indexing_rule ...'

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

@@ -776,6 +776,77 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Get on-call responders for a schedule.
+    #
+    # @see #get_schedule_on_call_responders_with_http_info
+    def get_schedule_on_call_responders(schedule_id, opts = {})
+      data, _status_code, _headers = get_schedule_on_call_responders_with_http_info(schedule_id, opts)
+      data
+    end
+
+    # Get on-call responders for a schedule.
+    #
+    # Retrieves the on-call responders for the specified schedule, grouped by position (previous, current, next), at a given time. Supports schedules with multiple concurrent on-call responders at a position, by returning a list of shifts per position.
+    #
+    # @param schedule_id [String] The ID of the schedule.
+    # @param opts [Hash] the optional parameters
+    # @option opts [String] :include Comma-separated list of included relationships to be returned. Allowed values: `schedule`, `responders`, `responders.shifts`, `responders.shifts.user`.
+    # @option opts [String] :filter_position Comma-separated list of positions to retrieve. Allowed values: `previous`, `current`, `next`. Defaults to `current` if omitted.
+    # @option opts [String] :filter_at_ts Retrieves the on-call responders at the given timestamp in RFC3339 format (for example, `2025-05-07T02:53:01Z` or `2025-05-07T02:53:01+00:00`). When using timezone offsets with `+` or `-`, ensure proper URL encoding (`+` should be encoded as `%2B`). Defaults to the current time if omitted.
+    # @return [Array<(ScheduleOnCallResponders, Integer, Hash)>] ScheduleOnCallResponders data, response status code and response headers
+    def get_schedule_on_call_responders_with_http_info(schedule_id, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: OnCallAPI.get_schedule_on_call_responders ...'
+      end
+      # verify the required parameter 'schedule_id' is set
+      if @api_client.config.client_side_validation && schedule_id.nil?
+        fail ArgumentError, "Missing the required parameter 'schedule_id' when calling OnCallAPI.get_schedule_on_call_responders"
+      end
+      # resource path
+      local_var_path = '/api/v2/on-call/schedules/{schedule_id}/responders'.sub('{schedule_id}', CGI.escape(schedule_id.to_s).gsub('%2F', '/'))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'include'] = opts[:'include'] if !opts[:'include'].nil?
+      query_params[:'filter[position]'] = opts[:'filter_position'] if !opts[:'filter_position'].nil?
+      query_params[:'filter[at_ts]'] = opts[:'filter_at_ts'] if !opts[:'filter_at_ts'].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] || 'ScheduleOnCallResponders'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :get_schedule_on_call_responders,
+        :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: OnCallAPI#get_schedule_on_call_responders\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Get scheduled on-call user.
     #
     # @see #get_schedule_on_call_user_with_http_info
@@ -786,7 +857,9 @@ module DatadogAPIClient::V2
 
     # Get scheduled on-call user.
     #
-    # Retrieves the user who is on-call for the specified schedule at a given time.
+    # Retrieves the user who is on-call for the specified schedule at a given time. This endpoint does not support schedules with multiple concurrent on-call responders at a position. Deprecated. Use `Get on-call responders for a schedule` instead.
+    #
+    # @deprecated This API is deprecated.
     #
     # @param schedule_id [String] The ID of the schedule.
     # @param opts [Hash] the optional parameters
@@ -794,6 +867,7 @@ module DatadogAPIClient::V2
     # @option opts [String] :filter_at_ts Retrieves the on-call user at the given timestamp in RFC3339 format (for example, `2025-05-07T02:53:01Z` or `2025-05-07T02:53:01+00:00`). When using timezone offsets with `+` or `-`, ensure proper URL encoding (`+` should be encoded as `%2B`). Defaults to the current time if omitted.
     # @return [Array<(Shift, Integer, Hash)>] Shift data, response status code and response headers
     def get_schedule_on_call_user_with_http_info(schedule_id, opts = {})
+      warn "[DEPRECATION] `GetScheduleOnCallUser` is deprecated."
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: OnCallAPI.get_schedule_on_call_user ...'