This version of the OpenSearch documentation is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.

CAT tasks

Introduced 1.0

The CAT tasks operation lists the progress of all tasks currently running on your cluster.

Example

  1. GET _cat/tasks?v

copy

Path and HTTP methods

  1. GET _cat/tasks

URL parameters

All CAT tasks URL parameters are optional.

In addition to the common URL parameters, you can specify the following parameters:

ParameterTypeDescription
nodesListA 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, specify the node name to get information from specific nodes, or keep the parameter empty to get information from all nodes.
detailedBooleanReturns detailed task information. (Default: false)
parent_task_idStringReturns tasks with a specified parent task ID (node_id:task_number). Keep empty or set to -1 to return all.
timeTimeSpecify the units for time. For example, 5d or 7h. For more information, see Supported units.

Response

  1. action | task_id | parent_task_id | type | start_time | timestamp | running_time | ip | node
  2. cluster:monitor/tasks/lists | 1vo54NuxSxOrbPEYdkSF0w:168062 | - | transport | 1624337809471 | 04:56:49 | 489.5ms | 172.18.0.4 | odfe-node1