Module: Elasticsearch::API::Tasks::Actions

Included in:
TasksClient
Defined in:
lib/elasticsearch/api/namespace/tasks.rb,
lib/elasticsearch/api/actions/tasks/get.rb,
lib/elasticsearch/api/actions/tasks/list.rb,
lib/elasticsearch/api/actions/tasks/cancel.rb,
lib/elasticsearch/api/actions/tasks/params_registry.rb

Defined Under Namespace

Modules: ParamsRegistry

Instance Method Summary collapse

Instance Method Details

#cancel(arguments = {}) ⇒ Object

Cancel a specific task

Parameters:

  • arguments (Hash) (defaults to: {}) —

    a customizable set of options

Options Hash (arguments):

  • :task_id (String) —

    Cancel the task with specified task id (node_id:task_number)

  • :nodes (List) —

    A comma-separated list of node IDs or names to limit the returned information; use ‘_local` to return information from the node you’re connecting to, leave empty to get information from all nodes

  • :actions (List) —

    A comma-separated list of actions that should be cancelled. Leave empty to cancel all.

  • :parent_task_id (String) —

    Cancel tasks with specified parent task id (node_id:task_number). Set to -1 to cancel all.

See Also:



15
16
17
18
19
20
21
22
23
24
25
 
# File 'lib/elasticsearch/api/actions/tasks/cancel.rb', line 15

def cancel(arguments={})
  arguments = arguments.clone
  task_id = arguments.delete(:task_id)

  method = 'POST'
  path   = Utils.__pathify( '_tasks', Utils.__escape(task_id), '_cancel' )
  params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
  body   = nil

  perform_request(method, path, params, body).body
end

#get(arguments = {}) ⇒ Object

Return information about a specific task

Parameters:

  • arguments (Hash) (defaults to: {}) —

    a customizable set of options

Options Hash (arguments):

  • :task_id (String) —

    Return the task with specified id (node_id:task_number) (Required)

  • :wait_for_completion (Boolean) —

    Wait for the matching tasks to complete (default: false)

  • :timeout (Time) —

    Explicit operation timeout

See Also:



14
15
16
17
18
19
20
21
22
23
 
# File 'lib/elasticsearch/api/actions/tasks/get.rb', line 14

def get(arguments={})
  arguments = arguments.clone
  task_id = arguments.delete(:task_id)
  method = HTTP_GET
  path   = Utils.__pathify '_tasks', Utils.__escape(task_id)
  params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
  body   = nil

  perform_request(method, path, params, body).body
end

#list(arguments = {}) ⇒ Object

Return the list of tasks

Parameters:

  • arguments (Hash) (defaults to: {}) —

    a customizable set of options

Options Hash (arguments):

  • :nodes (List) —

    A comma-separated list of node IDs or names to limit the returned information; use ‘_local` to return information from the node you’re connecting to, leave empty to get information from all nodes

  • :actions (List) —

    A comma-separated list of actions that should be returned. Leave empty to return all.

  • :detailed (Boolean) —

    Return detailed task information (default: false)

  • :parent_task_id (String) —

    Return tasks with specified parent task id (node_id:task_number). Set to -1 to return all.

  • :wait_for_completion (Boolean) —

    Wait for the matching tasks to complete (default: false)

  • :group_by (String) —

    Group tasks by nodes or parent/child relationships (options: nodes, parents, none)

  • :timeout (Time) —

    Explicit operation timeout

See Also:



18
19
20
21
22
23
24
25
26
27
28
 
# File 'lib/elasticsearch/api/actions/tasks/list.rb', line 18

def list(arguments={})
  arguments = arguments.clone
  task_id = arguments.delete(:task_id)

  method = 'GET'
  path   = Utils.__pathify( '_tasks', Utils.__escape(task_id) )
  params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
  body   = nil

  perform_request(method, path, params, body).body
end