Type to search.

Get the status and progress of a specific reindex task

Auth The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats. Availability Generally available since 9.5 This functionality is generally available and ready for production usage. Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments. This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

This API follows reindex tasks across node-shutdown relocations, so callers can keep using the original task ID throughout the lifetime of the operation. Returned task IDs and timings reflect the original task, not its relocated successor. Relocated task IDs are also supported. They are followed transparently and return the task ID and timings of the original task.

When the task ID cannot be resolved, the API returns the response below with a 404 status code. This response is used whether the ID is unknown, refers to a non-reindex task, refers to a sliced child subtask, or refers to a task whose node left the cluster with no stored result (e.g. a non-graceful shutdown).

Text 
{
  "error": {
    "type": "resource_not_found_exception",
    "reason": "Reindex operation [r1A2WoRbTwKZ516z6NEs5A:36619] not found"
  },
  "status": 404
}

Required privileges

Cluster privileges monitor monitor_reindex manage_reindex

Path parameters

task_id string required

The ID of the reindex task to retrieve.

Query parameters

wait_for_completion boolean · default: false

If true, the request blocks until the reindex task completes, then returns the result.

timeout string · default: 30s

The period to wait for the reindex task to complete when wait_for_completion is true.

Response

application/json
completed boolean required

Whether the reindex task has completed.

id string required

The ID of the reindex task. The value is the ID assigned when the task was first created and remains stable across node-shutdown relocations.

description string

A sanitized description of the reindex operation (source and destination indices, and optionally remote host info).

start_time_in_millis number required

The time at which the reindex task started, in milliseconds since the Unix epoch.

start_time string

The time at which the reindex task started, as an ISO 8601 formatted string. Only present when the request includes the ?human=true query parameter.

running_time string

The elapsed running time of the reindex task, in a human-readable format. Only present when the request includes the ?human=true query parameter.

running_time_in_nanos number required

The elapsed running time of the reindex task, in nanoseconds.

cancelled boolean required

Whether the reindex task has been cancelled.