Get the status and progress of a specific reindex task

GET /_reindex/{task_id}

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).

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

Authentication

Api key

Authorization: <value>

Elasticsearch APIs support key-based authentication. You must create an API key and use the encoded value in the request header. For example:

		curl -X GET "${ES_URL}/_cat/indices?v=true" \
  -H "Authorization: ApiKey ${API_KEY}"

To get API keys, use the /_security/api_key APIs.

Basic

Authorization: Basic <credentials>

Bearer

Authorization: Bearer <token>

Elasticsearch APIs support the use of bearer tokens in the Authorization HTTP header to authenticate with the API. For examples, refer to Token-based authentication services

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.
status object: The current progress of the reindex operation.
error object: The error that caused the reindex task to fail, if any.
response object: The final result of the completed reindex operation, if the task has finished successfully.

Examples

Request Console 1 / 8 languages

Console Kibana Dev Tools

GET _reindex/r1A2WoRbTwKZ516z6NEs5A:36619

JavaScript Elasticsearch JavaScript Client

const response = await client.getReindex({
  task_id: "r1A2WoRbTwKZ516z6NEs5A:36619",
});

Python Elasticsearch Python Client

resp = client.get_reindex(
    task_id="r1A2WoRbTwKZ516z6NEs5A:36619",
)

curl Shell

curl -X GET "$ELASTICSEARCH_URL/_reindex/r1A2WoRbTwKZ516z6NEs5A:36619" \
  -H "Authorization: ApiKey $ELASTIC_API_KEY"

Java Elasticsearch Java Client

client.getReindex(g -> g
    .taskId("r1A2WoRbTwKZ516z6NEs5A:36619")
);

C# Elasticsearch .NET Client

var response = await client.GetReindexAsync(taskId: "r1A2WoRbTwKZ516z6NEs5A:36619");

PHP Elasticsearch PHP Client

$resp = $client->getReindex([
    "task_id" => "r1A2WoRbTwKZ516z6NEs5A:36619",
]);

Ruby Elasticsearch Ruby Client

response = client.get_reindex(
  task_id: "r1A2WoRbTwKZ516z6NEs5A:36619"
)

Response

A successful response for an in-progress reindex task. The status block reports current progress; the response block is absent until the task completes.

{
  "completed": false,
  "id": "r1A2WoRbTwKZ516z6NEs5A:36619",
  "description": "reindex from [reindex_src] to [reindex_dst]",
  "start_time_in_millis": 1778265266199,
  "running_time_in_nanos": 1588606084,
  "cancelled": false,
  "status": {
    "total": 0,
    "updated": 0,
    "created": 0,
    "deleted": 0,
    "batches": 0,
    "version_conflicts": 0,
    "noops": 0,
    "retries": {
      "bulk": 0,
      "search": 0
    },
    "throttled_millis": 0,
    "requests_per_second": 4.0,
    "throttled_until_millis": 0,
    "slices": [
      null,
      null
    ]
  }
}

Get the status and progress of a specific reindex task

Authentication

Path parameters

Query parameters

Response