kinetic_sdk 0.1.1

data/lib/kinetic_sdk/task/lib/categories.rb

@@ -0,0 +1,190 @@
+module KineticSdk
+  class Task
+
+    # Add a category
+    #
+    # @param category [Hash] Category properties
+    #   - +name+ - name of the category
+    #   - +handlers+ - array of handler definitionIds associated to the category
+    #   - +policyRules+ - array of policy rule names associated to the category
+    #   - +trees+ - array of tree (routine) definitionIds associated to the category
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def add_category(category, headers=default_headers)
+      info("Add category \"#{category['name']}\"")
+      post("#{@api_url}/categories", category, headers)
+    end
+
+    # Delete a Category
+    #
+    # @param name [String] Category name
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def delete_category(name, headers=header_basic_auth)
+      info("Deleting Category \"#{name}\"")
+      delete("#{@api_url}/categories/#{encode(name)}", headers)
+    end
+
+    # Delete all Categories
+    #
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def delete_categories(headers=header_basic_auth)
+      info("Deleting all categories")
+      (find_categories(headers).content["categories"] || []).each do |category|
+        delete_category(category['name'], headers)
+      end
+    end
+
+    # Export a Category
+    #
+    # @param category [String|Hash] Category name, or hash of category properties
+    #   - +name+ - name of the category
+    #   - +handlers+ - array of handler definitionIds associated to the category
+    #   - +policyRules+ - array of policy rule names associated to the category
+    #   - +trees+ - array of tree (routine) definitionIds associated to the category
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def export_category(category, headers=header_basic_auth)
+      raise StandardError.new "An export directory must be defined to export a category." if @options[:export_directory].nil?
+      if category.is_a? String
+        response = find_category(category, { "include" => "handlers,trees,policyRules" }, headers)
+        category = response.content
+      end
+      info("Exporting category \"#{category['name']}\" to #{@options[:export_directory]}.")
+      # Create the category directory if it doesn't yet exist
+      category_dir = FileUtils::mkdir_p(File.join(@options[:export_directory], "categories"))
+      category_file = File.join(category_dir, "#{category['name'].slugify}.json")
+
+      # Just export the associated key values
+      category['handlers'].collect! { |h| h['definitionId'] }.sort!
+      category['trees'].collect! { |t| t['definitionId'] }.sort!
+      category['policyRules'].collect! { |pr| pr['name'] }.sort!
+
+      # write the file
+      File.write(category_file, JSON.pretty_generate(category))
+      info("Exported category: #{category['name']} to #{category_file}")
+    end
+
+    # Export Categories
+    #
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def export_categories(headers=header_basic_auth)
+      raise StandardError.new "An export directory must be defined to export categories." if @options[:export_directory].nil?
+      (find_categories({ "include" => "handlers,trees,policyRules" }).content["categories"] || []).each do |category|
+        export_category(category)
+      end
+    end
+
+    # Find all categories
+    #
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_categories(params={}, headers=header_basic_auth)
+      info("Finding all categories")
+      get("#{@api_url}/categories", params, headers)
+    end
+
+    # Find a category
+    #
+    # @param name [String] name of the category
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_category(name, params={}, headers=header_basic_auth)
+      info("Finding Category \"#{name}\"")
+      get("#{@api_url}/categories/#{encode(name)}", params, headers)
+    end
+
+    # Update a category
+    #
+    # @param original_name [String] name of the category before updating
+    # @param body [Hash] the updated property values
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    # 
+    # Example
+    #
+    #     update_category("Foo", { "name" => "Bar" })
+    #
+    def update_category(original_name, body={}, headers=default_headers)
+      info("Updating Category \"#{original_name}\"")
+      put("#{@api_url}/categories/#{encode(original_name)}", body, headers)
+    end
+
+
+    # Add a handler to a category
+    #
+    # @param handler_id [String] the handler id to add
+    # @param category_name [String] name of the category to associate the handler
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def add_handler_to_category(handler_id, category_name, headers=default_headers)
+      body = { "definitionId" => handler_id }
+      info("Adding handler \"#{handler_id}\" to category \"#{category_name}\"")
+      post("#{@api_url}/categories/#{encode(category_name)}/handlers", body, headers)
+    end
+
+    # Remove a handler from a category
+    #
+    # @param handler_id [String] the handler id to remove
+    # @param category_name [String] name of the category to remove the handler from
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def remove_handler_from_category(handler_id, category_name, headers=default_headers)
+      info("Removing handler \"#{handler_id}\" from category \"#{category_name}\"")
+      delete("#{@api_url}/categories/#{encode(category_name)}/handlers/#{encode(handler_id)}", headers)
+    end
+
+    # Add a global routine to a category
+    #
+    # @param routine_id [String] the global routine id to add
+    # @param category_name [String] name of the category to associate the global routine
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def add_routine_to_category(routine_id, category_name, headers=default_headers)
+      body = { "definitionId" => routine_id }
+      info("Adding routine \"#{routine_id}\" to category \"#{category_name}\"")
+      post("#{@api_url}/categories/#{encode(category_name)}/routines", body, headers)
+    end
+
+    # Remove a global routine from a category
+    #
+    # @param routine_id [String] the global routine id to remove
+    # @param category_name [String] name of the category to remove the global routine from
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def remove_routine_from_category(routine_id, category_name, headers=default_headers)
+      info("Removing routine \"#{routine_id}\" from category \"#{category_name}\"")
+      delete("#{@api_url}/categories/#{encode(category_name)}/routines/#{encode(routine_id)}", headers)
+    end
+
+    # Add a policy rule to a category
+    #
+    # @param policy_rule_type [String] the type of policy rule
+    # @param policy_rule_name [String] the name of policy rule
+    # @param category_name [String] name of the category to associate the policy rule
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def add_policy_rule_to_category(policy_rule_type, policy_rule_name, category_name, headers=default_headers)
+      body = { "type" => policy_rule_type, "name" => policy_rule_name }
+      info("Adding policy rule \"#{policy_rule_type} - #{policy_rule_name}\" to category \"#{category_name}\"")
+      post("#{@api_url}/categories/#{encode(category_name)}/policyRules", body, headers)
+    end
+
+    # Remove a policy rule from a category
+    #
+    # @param policy_rule_type [String] the type of policy rule
+    # @param policy_rule_name [String] the name of policy rule
+    # @param category_name [String] name of the category to remove the policy rule from
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def remove_policy_rule_from_category(policy_rule_type, policy_rule_name, category_name, headers=default_headers)
+      info("Removing policy rule \"#{policy_rule_type} - #{policy_rule_name}\" from category \"#{category_name}\"")
+      delete("#{@api_url}/categories/#{encode(category_name)}/policyRules/#{encode(policy_rule_type)}/#{encode(policy_rule_name)}", headers)
+    end
+
+  end
+end

data/lib/kinetic_sdk/task/lib/config.rb

@@ -0,0 +1,202 @@
+module KineticSdk
+  class Task
+
+    # Find the database configuration
+    #
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_db(params={}, headers=header_basic_auth)
+      info("Finding the database configuration")
+      get("#{@api_url}/config/db", params, headers)
+    end
+
+
+    # Find the session configuration properties
+    #
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_session_configuration(params={}, headers=header_basic_auth)
+      info("Finding the session timeout")
+      get("#{@api_url}/config/session", params, headers)
+    end
+
+
+    # Update the authentication settings
+    #
+    # @param settings [Hash] Settings for the authenticator
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    #
+    # Example
+    #
+    #     update_authentication({
+    #       "authenticator" => "com.kineticdata.core.v1.authenticators.ProxyAuthenticator",
+    #       "authenticationJsp" => "/WEB-INF/app/login.jsp",
+    #       "properties" => {
+    #         "Authenticator[Authentication Strategy]" => "Http Header",
+    #         "Authenticator[Header Name]" => "X-Login",
+    #         "Authenticator[Guest Access Enabled]" => "No"
+    #       }
+    #     })
+    #
+    def update_authentication(settings, headers=default_headers)
+      info("Updating the authentication properties")
+      put("#{@api_url}/config/auth", settings, headers)
+    end
+
+
+    # Update the database configuration
+    #
+    # This assumes the database has already been created on the dbms.
+    #
+    # @param settings [Hash] Setting sfor the selected type of dbms
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    #
+    # Example
+    #
+    #     update_db({
+    #       "hibernate.connection.driver_class" => "org.postgresql.Driver",
+    #       "hibernate.connection.url" => "jdbc:postgresql://192.168.0.1:5432",
+    #       "hibernate.connection.username" => "my-db-user",
+    #       "hibernate.connection.password" => "my-db-password",
+    #       "hibernate.dialect" => "com.kineticdata.task.adapters.dbms.KineticPostgreSQLDialect"
+    #     })
+    #
+    def update_db(settings, headers=default_headers)
+      info("Updating the database properties")
+      put("#{@api_url}/config/db", settings, headers)
+    end
+
+
+    # Update the engine settings
+    #
+    # @param settings [Hash] Settings for the selected type of dbms
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    #
+    # Example
+    #
+    #     update_engine({
+    #       "Max Threads" => "1",
+    #       "Sleep Delay" => "10",
+    #       "Trigger Query" => "'Selection Criterion'=null"
+    #     })
+    #
+    def update_engine(settings, headers=default_headers)
+      info("Updating the engine properties")
+      put("#{@api_url}/config/engine", settings, headers)
+
+      # start the task engine?
+      if !settings['Sleep Delay'].nil? && settings['Sleep Delay'].to_i > 0
+        info("Starting the engine")
+        start_engine
+      end
+    end
+
+
+    # Update the identity store settings
+    #
+    # @param settings [Hash] Settings for the identity store
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    #
+    # Example
+    #
+    #     update_identity_store({
+    #       "Identity Store" => "com.kineticdata.authentication.kineticcore.KineticCoreIdentityStore",
+    #       "properties" => {
+    #         "Kinetic Core Space Url" => "http://server:port/kinetic/space",
+    #         "Group Attribute Name" => "Group",
+    #         "Proxy Username" => "admin",
+    #         "Proxy Password" => "admin"
+    #       }
+    #     })
+    #
+    def update_identity_store(settings, headers=default_headers)
+      info("Updating the identity store properties")
+      put("#{@api_url}/config/identityStore", settings, headers)
+    end
+
+
+    # Update the web server and default configuration user settings
+    #
+    # @param settings [Hash] Settings for the web server and configurator user
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    #
+    # Example
+    #
+    #     update_properties({
+    #       "Configurator Username" => "my-admin-user",
+    #       "Configurator Password" => "my-admin-pass",
+    #       "Log Level" => "DEBUG",
+    #       "Log Size (MB)" => "20"
+    #     })
+    #
+    # Example
+    #
+    #     update_properties({
+    #       "Configurator Username" => "my-admin-user",
+    #       "Configurator Password" => "my-admin-pass"
+    #     })
+    #
+    def update_properties(settings, headers=default_headers)
+      info("Updating the web server properties")
+      put("#{@api_url}/config/server", settings, headers)
+
+      # reset the configuration user
+      @config_user = {
+        username: settings["Configurator Username"],
+        password: settings["Configurator Password"]
+      }
+    end
+
+
+    # Update the session configuration settings
+    #
+    # @param settings [Hash] Settings for the session configuration
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    #
+    # Example
+    #
+    #     update_session_configuration({
+    #       "timeout" => "30"
+    #     })
+    #
+    def update_session_configuration(settings, headers=default_headers)
+      info("Updating the session configuration settings")
+      put("#{@api_url}/config/session", settings, headers)
+    end
+
+    # Find the system policy rule
+    #
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_system_policy_rule(params={}, headers=header_basic_auth)
+      info("Finding the system policy rule")
+      get("#{@api_url}/config/systemPolicyRule", params, headers)
+    end
+
+    # Update the system policy rule
+    #
+    # @param policy_rule_name [String] name of the policy rule to use
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    #
+    # Example
+    #
+    #     update_system_policy_rule("Allow All")
+    #
+    def update_system_policy_rule(policy_rule_name, headers=default_headers)
+      info("Updating the system policy rule")
+      payload = { "name" => policy_rule_name }
+      put("#{@api_url}/config/systemPolicyRule", payload, headers)
+    end
+
+  end
+end

data/lib/kinetic_sdk/task/lib/engine.rb

@@ -0,0 +1,42 @@
+module KineticSdk
+  class Task
+
+    # Start the task engine
+    #
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def start_engine(headers=default_headers)
+      body = { "action" => "start" }
+      post("#{@api_url}/engine", body, headers)
+    end
+
+    # Stop the task engine
+    #
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def stop_engine(headers=default_headers)
+      body = { "action" => "stop" }
+      post("#{@api_url}/engine", body, headers)
+    end
+
+    # Get the engine info
+    #
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def engine_info(params={}, headers=header_basic_auth)
+      get("#{@api_url}/engine", params, headers)
+    end
+
+    # Get the engine status
+    #
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def engine_status(headers=header_basic_auth)
+      response = engine_info({}, headers)
+      data = response.content
+      data.nil? ? "Unknown" : data['status']
+    end
+
+  end
+end

data/lib/kinetic_sdk/task/lib/environment.rb

@@ -0,0 +1,14 @@
+module KineticSdk
+  class Task
+
+    # Get the web server environment
+    #
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def environment(params={}, headers=header_basic_auth)
+      get("#{@api_url}/environment", params, headers)
+    end
+
+  end
+end

data/lib/kinetic_sdk/task/lib/errors.rb

@@ -0,0 +1,165 @@
+module KineticSdk
+  class Task
+
+    # Delete an Error
+    #
+    # @param id [Integer] id of the error
+    # @param headers [Hash] headers to send with the request, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    # @since Task v4.3.0
+    def delete_error(id, headers=header_basic_auth)
+      info("Deleting Error \"#{id}\"")
+      delete("#{@api_url}/errors/#{id}", headers)
+    end
+
+    # Resolve multiple errors with the same action and resolution notes.
+    #
+    # @param ids [Array<Integer>] Array of error ids to resolve
+    # @param action [String] type of action to perform
+    #   - +Cancel Branch+ - resolve the error and cancel the branch (connector error)
+    #   - +Continue Branch+ - resolve the error and continue the branch (connector error)
+    #   - +Do Nothing+ - resolve the error and do nothing more
+    #   - +Retry+ - resolve the error and retry the connector that caused the error (connector error)
+    #   - +Retry Task+ - resolve the error and retry the task that caused the error (node error)
+    #   - +Skip Task+ - resolve the error and continue after the task that caused the error (node error)
+    # @param resolution [String] resolution notes
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def resolve_errors(ids, action, resolution, headers=default_headers)
+      info("Resolving errors #{ids}")
+      body = { "ids" => ids, "action" => action, "resolution" => resolution }
+      post("#{@api_url}/errors/resolve", body, headers)
+    end
+
+    # Find a list of errors.
+    #
+    # @param params [Hash] Query parameters that are added to the URL
+    #   - +timeline+ - either "createdAt" or "updatedAt". Default: createdAt
+    #   - +direction+ - DESC or ASC (default: DESC)
+    #   - +start+ - 2017-07-27 or 2017-07-27T15:00:00.000Z
+    #   - +end+ - 2017-07-27 or 2017-07-27T15:00:00.000Z
+    #   - +source+ - name of the source
+    #   - +sourceId+ - only if *source* is provided
+    #   - +group+ - only if *source* is provided
+    #   - +tree+ - only if *source* and *group* are provided
+    #   - +nodeId+ - only if *source*, *group*, and *tree* are provided
+    #   - +handlerId+
+    #   - +runId+
+    #   - +type+
+    #   - +status+
+    #   - +relatedItem1Id+
+    #   - +relatedItem1Type+
+    #   - +relatedItem2Id+
+    #   - +relatedItem2Type+
+    #   - +limit+
+    #   - +offset+
+    #   - +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_errors(params={}, headers=header_basic_auth)
+      info("Finding errors")
+      get("#{@api_url}/errors", params, headers)
+    end
+
+    # Find an Error
+    #
+    # @param id [Integer] id of the error
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_error(id, params={}, headers=header_basic_auth)
+      info("Finding error #{id}")
+      get("#{@api_url}/errors/#{id}", params, headers)
+    end
+
+    # Find Active Errors by Handler Id
+    #
+    # @param handler_id [String] handler identifier
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_active_errors_by_handler(handler_id, params={}, headers=header_basic_auth)
+      info("Finding active errors for handler #{handler_id}")
+      params['handlerId'] = handler_id
+      params['status'] = 'Active'
+      find_errors(params, headers)
+    end
+
+    # Find Active Errors by Source
+    #
+    # @param source_name [String] Source name
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_active_errors_by_source(source_name, params={}, headers=header_basic_auth)
+      info("Finding active errors for source \"#{source_name}\"")
+      params['source'] = source_name
+      params['status'] = 'Active'
+      find_errors(params, headers)
+    end
+
+    # Finding Active Errors by Source Group
+    #
+    # @param source_name [String] Source name
+    # @param group [String] Source group
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_active_errors_by_source_group(source_name, group, params={}, headers=header_basic_auth)
+      info("Finding active errors for source group \"#{source_name} :: #{group}\"")
+      params['group'] = group
+      params['source'] = source_name
+      params['status'] = 'Active'
+      find_errors(params, headers)
+    end
+
+    # Find Active Errors by Tree Name
+    #
+    # @param source_name [String] Source name
+    # @param group [String] Source group
+    # @param tree_name [String] Tree name
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_active_errors_by_tree(source_name, group, tree_name, params={}, headers=header_basic_auth)
+      info("Finding active errors for tree \"#{source_name} :: #{group} :: #{tree_name}\"")
+      params['tree'] = tree_name
+      params['group'] = group
+      params['source'] = source_name
+      params['status'] = 'Active'
+      find_errors(params, headers)
+    end
+
+    # Find Active Errors by Node
+    #
+    # @param source_name [String] Source name
+    # @param group [String] Source group
+    # @param tree_name [String] Tree name
+    # @param node_id [String] Node id in the tree
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_active_errors_by_node(source_name, group, tree_name, node_id, params={}, headers=header_basic_auth)
+      info("Finding active errors for node \"#{source_name} :: #{group} :: #{tree_name} :: #{node_id}\"")
+      params['nodeId'] = node_id
+      params['tree'] = tree_name
+      params['group'] = group
+      params['source'] = source_name
+      params['status'] = 'Active'
+      find_errors(params, headers)
+    end
+
+    # Find Errors by Run Id
+    #
+    # @param run_id [Integer] Run id
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_errors_by_run(run_id, params={}, headers=header_basic_auth)
+      info("Finding active errors for run #{run_id}")
+      params['runId'] = run_id
+      find_errors(params, headers)
+    end
+
+  end
+end