List Tasks APIedit

The List Tasks API allows to get information about the tasks currently executing in the cluster.

List Tasks Requestedit

A ListTasksRequest:

ListTasksRequest request = new ListTasksRequest();

There is no required parameters. By default the client will list all tasks and will not wait for task completion.


request.setNodes("nodeId1", "nodeId2"); 
request.setParentTaskId(new TaskId("parentTaskId", 42)); 

Request only cluster-related tasks

Request all tasks running on nodes nodeId1 and nodeId2

Request only children of a particular task


Should the information include detailed, potentially slow to generate data. Defaults to false


Should this request wait for all found tasks to complete. Defaults to false

Timeout for the request as a TimeValue. Applicable only if setWaitForCompletion is true. Defaults to 30 seconds

Timeout as a String

Synchronous Executionedit

ListTasksResponse response = client.tasks().list(request, RequestOptions.DEFAULT);

Asynchronous Executionedit

The asynchronous execution of a cluster update settings requires both the ListTasksRequest instance and an ActionListener instance to be passed to the asynchronous method:

client.tasks().listAsync(request, RequestOptions.DEFAULT, listener); 

The ListTasksRequest to execute and the ActionListener to use when the execution completes

The asynchronous method does not block and returns immediately. Once it is completed the ActionListener is called back using the onResponse method if the execution successfully completed or using the onFailure method if it failed.

A typical listener for ListTasksResponse looks like:

ActionListener<ListTasksResponse> listener =
        new ActionListener<ListTasksResponse>() {
            public void onResponse(ListTasksResponse response) {

            public void onFailure(Exception e) {

Called when the execution is successfully completed. The response is provided as an argument

Called in case of a failure. The raised exception is provided as an argument

List Tasks Responseedit

List<TaskInfo> tasks = response.getTasks(); 

List of currently running tasks

Map<String, List<TaskInfo>> perNodeTasks = response.getPerNodeTasks(); 
List<TaskGroup> groups = response.getTaskGroups(); 

List of tasks grouped by a node

List of tasks grouped by a parent task

List<ElasticsearchException> nodeFailures = response.getNodeFailures(); 
List<TaskOperationFailure> taskFailures = response.getTaskFailures(); 

List of node failures

List of tasks failures