datadog_api_client 2.49.0 → 2.51.0

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

@@ -23,6 +23,79 @@ module DatadogAPIClient::V2
       @api_client = api_client
     end
 
+    # Activate content pack.
+    #
+    # @see #activate_content_pack_with_http_info
+    def activate_content_pack(content_pack_id, opts = {})
+      activate_content_pack_with_http_info(content_pack_id, opts)
+      nil
+    end
+
+    # Activate content pack.
+    #
+    # Activate a security monitoring content pack. This operation configures the necessary
+    # log filters or security filters depending on the pricing model and updates the content
+    # pack activation state.
+    #
+    # @param content_pack_id [String] The ID of the content pack to activate.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def activate_content_pack_with_http_info(content_pack_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.activate_content_pack".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.activate_content_pack")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.activate_content_pack"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SecurityMonitoringAPI.activate_content_pack ...'
+      end
+      # verify the required parameter 'content_pack_id' is set
+      if @api_client.config.client_side_validation && content_pack_id.nil?
+        fail ArgumentError, "Missing the required parameter 'content_pack_id' when calling SecurityMonitoringAPI.activate_content_pack"
+      end
+      # resource path
+      local_var_path = '/api/v2/security_monitoring/content_packs/{content_pack_id}/activate'.sub('{content_pack_id}', CGI.escape(content_pack_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 => :activate_content_pack,
+        :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: SecurityMonitoringAPI#activate_content_pack\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Attach security findings to a case.
     #
     # @see #attach_case_with_http_info
@@ -113,12 +186,6 @@ module DatadogAPIClient::V2
     # @param opts [Hash] the optional parameters
     # @return [Array<(FindingCaseResponse, Integer, Hash)>] FindingCaseResponse data, response status code and response headers
     def attach_jira_issue_with_http_info(body, opts = {})
-      unstable_enabled = @api_client.config.unstable_operations["v2.attach_jira_issue".to_sym]
-      if unstable_enabled
-        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.attach_jira_issue")
-      else
-        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.attach_jira_issue"))
-      end
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: SecurityMonitoringAPI.attach_jira_issue ...'
@@ -170,6 +237,75 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Bulk export security monitoring rules.
+    #
+    # @see #bulk_export_security_monitoring_rules_with_http_info
+    def bulk_export_security_monitoring_rules(body, opts = {})
+      data, _status_code, _headers = bulk_export_security_monitoring_rules_with_http_info(body, opts)
+      data
+    end
+
+    # Bulk export security monitoring rules.
+    #
+    # Export a list of security monitoring rules as a ZIP file containing JSON rule definitions.
+    # The endpoint accepts a list of rule IDs and returns a ZIP archive where each rule is
+    # saved as a separate JSON file named after the rule.
+    #
+    # @param body [SecurityMonitoringRuleBulkExportPayload] 
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
+    def bulk_export_security_monitoring_rules_with_http_info(body, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SecurityMonitoringAPI.bulk_export_security_monitoring_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 SecurityMonitoringAPI.bulk_export_security_monitoring_rules"
+      end
+      # resource path
+      local_var_path = '/api/v2/security_monitoring/rules/bulk_export'
+
+      # 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/zip', '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] || 'File'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :bulk_export_security_monitoring_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: SecurityMonitoringAPI#bulk_export_security_monitoring_rules\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Cancel a threat hunting job.
     #
     # @see #cancel_threat_hunting_job_with_http_info
@@ -610,12 +746,6 @@ module DatadogAPIClient::V2
     # @param opts [Hash] the optional parameters
     # @return [Array<(FindingCaseResponseArray, Integer, Hash)>] FindingCaseResponseArray data, response status code and response headers
     def create_jira_issues_with_http_info(body, opts = {})
-      unstable_enabled = @api_client.config.unstable_operations["v2.create_jira_issues".to_sym]
-      if unstable_enabled
-        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.create_jira_issues")
-      else
-        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.create_jira_issues"))
-      end
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: SecurityMonitoringAPI.create_jira_issues ...'
@@ -1072,6 +1202,78 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Deactivate content pack.
+    #
+    # @see #deactivate_content_pack_with_http_info
+    def deactivate_content_pack(content_pack_id, opts = {})
+      deactivate_content_pack_with_http_info(content_pack_id, opts)
+      nil
+    end
+
+    # Deactivate content pack.
+    #
+    # Deactivate a security monitoring content pack. This operation removes the content pack's
+    # configuration from log filters or security filters and updates the content pack activation state.
+    #
+    # @param content_pack_id [String] The ID of the content pack to deactivate.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def deactivate_content_pack_with_http_info(content_pack_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.deactivate_content_pack".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.deactivate_content_pack")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.deactivate_content_pack"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SecurityMonitoringAPI.deactivate_content_pack ...'
+      end
+      # verify the required parameter 'content_pack_id' is set
+      if @api_client.config.client_side_validation && content_pack_id.nil?
+        fail ArgumentError, "Missing the required parameter 'content_pack_id' when calling SecurityMonitoringAPI.deactivate_content_pack"
+      end
+      # resource path
+      local_var_path = '/api/v2/security_monitoring/content_packs/{content_pack_id}/deactivate'.sub('{content_pack_id}', CGI.escape(content_pack_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 => :deactivate_content_pack,
+        :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: SecurityMonitoringAPI#deactivate_content_pack\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Delete a custom framework.
     #
     # @see #delete_custom_framework_with_http_info
@@ -1887,6 +2089,74 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Get content pack states.
+    #
+    # @see #get_content_packs_states_with_http_info
+    def get_content_packs_states(opts = {})
+      data, _status_code, _headers = get_content_packs_states_with_http_info(opts)
+      data
+    end
+
+    # Get content pack states.
+    #
+    # Get the activation and configuration states for all security monitoring content packs.
+    # This endpoint returns status information about each content pack including activation state,
+    # integration status, and log collection status.
+    #
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(SecurityMonitoringContentPackStatesResponse, Integer, Hash)>] SecurityMonitoringContentPackStatesResponse data, response status code and response headers
+    def get_content_packs_states_with_http_info(opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.get_content_packs_states".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.get_content_packs_states")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.get_content_packs_states"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SecurityMonitoringAPI.get_content_packs_states ...'
+      end
+      # resource path
+      local_var_path = '/api/v2/security_monitoring/content_packs/states'
+
+      # 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] || 'SecurityMonitoringContentPackStatesResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :get_content_packs_states,
+        :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: SecurityMonitoringAPI#get_content_packs_states\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Get critical assets affecting a specific rule.
     #
     # @see #get_critical_assets_affecting_rule_with_http_info
@@ -2258,12 +2528,6 @@ module DatadogAPIClient::V2
     # @option opts [SBOMFormat] :ext_format The standard of the SBOM.
     # @return [Array<(GetSBOMResponse, Integer, Hash)>] GetSBOMResponse data, response status code and response headers
     def get_sbom_with_http_info(asset_type, filter_asset_name, opts = {})
-      unstable_enabled = @api_client.config.unstable_operations["v2.get_sbom".to_sym]
-      if unstable_enabled
-        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.get_sbom")
-      else
-        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.get_sbom"))
-      end
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: SecurityMonitoringAPI.get_sbom ...'
@@ -3441,12 +3705,6 @@ module DatadogAPIClient::V2
     # @option opts [SBOMComponentLicenseType] :filter_license_type The software license type of the component that is a dependency of an asset.
     # @return [Array<(ListAssetsSBOMsResponse, Integer, Hash)>] ListAssetsSBOMsResponse data, response status code and response headers
     def list_assets_sbo_ms_with_http_info(opts = {})
-      unstable_enabled = @api_client.config.unstable_operations["v2.list_assets_sbo_ms".to_sym]
-      if unstable_enabled
-        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_assets_sbo_ms")
-      else
-        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_assets_sbo_ms"))
-      end
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: SecurityMonitoringAPI.list_assets_sbo_ms ...'
@@ -4218,12 +4476,17 @@ module DatadogAPIClient::V2
     # @option opts [Integer] :page_size Size for a given page. The maximum allowed value is 100.
     # @option opts [Integer] :page_number Specific page number to return.
     # @option opts [String] :query A search query to filter security rules. You can filter by attributes such as `type`, `source`, `tags`.
+    # @option opts [SecurityMonitoringRuleSort] :sort Attribute used to sort rules. Prefix with `-` to sort in descending order.
     # @return [Array<(SecurityMonitoringListRulesResponse, Integer, Hash)>] SecurityMonitoringListRulesResponse data, response status code and response headers
     def list_security_monitoring_rules_with_http_info(opts = {})
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: SecurityMonitoringAPI.list_security_monitoring_rules ...'
       end
+      allowable_values = ['name', 'creation_date', 'update_date', 'enabled', 'type', 'highest_severity', 'source', '-name', '-creation_date', '-update_date', '-enabled', '-type', '-highest_severity', '-source']
+      if @api_client.config.client_side_validation && opts[:'sort'] && !allowable_values.include?(opts[:'sort'])
+        fail ArgumentError, "invalid value for \"sort\", must be one of #{allowable_values}"
+      end
       # resource path
       local_var_path = '/api/v2/security_monitoring/rules'
 
@@ -4232,6 +4495,7 @@ module DatadogAPIClient::V2
       query_params[:'page[size]'] = opts[:'page_size'] if !opts[:'page_size'].nil?
       query_params[:'page[number]'] = opts[:'page_number'] if !opts[:'page_number'].nil?
       query_params[:'query'] = opts[:'query'] if !opts[:'query'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -4384,18 +4648,28 @@ module DatadogAPIClient::V2
     #
     # @param opts [Hash] the optional parameters
     # @option opts [String] :query Query string.
-    # @return [Array<(SecurityMonitoringSuppressionsResponse, Integer, Hash)>] SecurityMonitoringSuppressionsResponse data, response status code and response headers
+    # @option opts [SecurityMonitoringSuppressionSort] :sort Attribute used to sort the list of suppression rules. Prefix with `-` to sort in descending order.
+    # @option opts [Integer] :page_size Size for a given page. Use `-1` to return all items.
+    # @option opts [Integer] :page_number Specific page number to return.
+    # @return [Array<(SecurityMonitoringPaginatedSuppressionsResponse, Integer, Hash)>] SecurityMonitoringPaginatedSuppressionsResponse data, response status code and response headers
     def list_security_monitoring_suppressions_with_http_info(opts = {})
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: SecurityMonitoringAPI.list_security_monitoring_suppressions ...'
       end
+      allowable_values = ['name', 'start_date', 'expiration_date', 'update_date', 'enabled', '-name', '-start_date', '-expiration_date', '-update_date', '-creation_date', '-enabled']
+      if @api_client.config.client_side_validation && opts[:'sort'] && !allowable_values.include?(opts[:'sort'])
+        fail ArgumentError, "invalid value for \"sort\", must be one of #{allowable_values}"
+      end
       # resource path
       local_var_path = '/api/v2/security_monitoring/configuration/suppressions'
 
       # query parameters
       query_params = opts[:query_params] || {}
       query_params[:'query'] = opts[:'query'] if !opts[:'query'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
+      query_params[:'page[size]'] = opts[:'page_size'] if !opts[:'page_size'].nil?
+      query_params[:'page[number]'] = opts[:'page_number'] if !opts[:'page_number'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -4409,7 +4683,7 @@ module DatadogAPIClient::V2
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'SecurityMonitoringSuppressionsResponse'
+      return_type = opts[:debug_return_type] || 'SecurityMonitoringPaginatedSuppressionsResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]

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

@@ -241,5 +241,92 @@ module DatadogAPIClient::V2
       end
       return data, status_code, headers
     end
+
+    # Get SLO status.
+    #
+    # @see #get_slo_status_with_http_info
+    def get_slo_status(slo_id, from_ts, to_ts, opts = {})
+      data, _status_code, _headers = get_slo_status_with_http_info(slo_id, from_ts, to_ts, opts)
+      data
+    end
+
+    # Get SLO status.
+    #
+    # Get the status of a Service Level Objective (SLO) for a given time period.
+    #
+    # This endpoint returns the current SLI value, error budget remaining, and other status information for the specified SLO.
+    #
+    # @param slo_id [String] The ID of the SLO.
+    # @param from_ts [Integer] The starting timestamp for the SLO status query in epoch seconds.
+    # @param to_ts [Integer] The ending timestamp for the SLO status query in epoch seconds.
+    # @param opts [Hash] the optional parameters
+    # @option opts [Boolean] :disable_corrections Whether to exclude correction windows from the SLO status calculation. Defaults to false.
+    # @return [Array<(SloStatusResponse, Integer, Hash)>] SloStatusResponse data, response status code and response headers
+    def get_slo_status_with_http_info(slo_id, from_ts, to_ts, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.get_slo_status".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.get_slo_status")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.get_slo_status"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ServiceLevelObjectivesAPI.get_slo_status ...'
+      end
+      # verify the required parameter 'slo_id' is set
+      if @api_client.config.client_side_validation && slo_id.nil?
+        fail ArgumentError, "Missing the required parameter 'slo_id' when calling ServiceLevelObjectivesAPI.get_slo_status"
+      end
+      # verify the required parameter 'from_ts' is set
+      if @api_client.config.client_side_validation && from_ts.nil?
+        fail ArgumentError, "Missing the required parameter 'from_ts' when calling ServiceLevelObjectivesAPI.get_slo_status"
+      end
+      # verify the required parameter 'to_ts' is set
+      if @api_client.config.client_side_validation && to_ts.nil?
+        fail ArgumentError, "Missing the required parameter 'to_ts' when calling ServiceLevelObjectivesAPI.get_slo_status"
+      end
+      # resource path
+      local_var_path = '/api/v2/slo/{slo_id}/status'.sub('{slo_id}', CGI.escape(slo_id.to_s).gsub('%2F', '/'))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'from_ts'] = from_ts
+      query_params[:'to_ts'] = to_ts
+      query_params[:'disable_corrections'] = opts[:'disable_corrections'] if !opts[:'disable_corrections'].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] || 'SloStatusResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :get_slo_status,
+        :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: ServiceLevelObjectivesAPI#get_slo_status\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
   end
 end