Batch start or resume reindex API

A newer version is available. Check out the latest documentation.

Batch start or resume reindex API

The underlying Upgrade Assistant concepts are stable, but the APIs for managing Upgrade Assistant are experimental.

Start or resume upgrading multiple indices in one request. Additionally, reindexing tasks for upgrading indices that are started or resumed via the batch endpoint will be placed on a queue and executed one-by-one. This ensures that minimal cluster resources are consumed over time.

This API does not support data streams.

Request

edit

POST /api/upgrade_assistant/reindex/batch

Request body

edit

indexNames: (Required, array) The list of index names to be reindexed.

Response code

edit

200: Indicates a successful call.

Example

edit

$ curl -X POST api/upgrade_assistant/reindex/batch
{
  "indexNames": [ 
    "index1",
    "index2"
  ]
}

The order of the indices determines the order that the reindex tasks are executed.

Similar to the start or resume endpoint, the API returns the following:

{
  "enqueued": [ 
    {
      "indexName": "index1",
      "newIndexName": "reindexed-v8-index1",
      "status": 3,
      "lastCompletedStep": 0,
      "locked": null,
      "reindexTaskId": null,
      "reindexTaskPercComplete": null,
      "errorMessage": null,
      "runningReindexCount": null,
      "reindexOptions": { 
        "queueSettings": {
          "queuedAt": 1583406985489 
        }
      }
    }
  ],
  "errors": [ 
    {
      "indexName": "index2",
      "message": "Something went wrong!"
    }
  ]
}

	A list of reindex tasks created, the order in the array indicates the order in which tasks will be executed.
	Presence of this key indicates that the reindex job will occur in the batch.
	A Unix timestamp of when the reindex task was placed in the queue.
	A list of errors that may have occurred preventing the reindex task from being created.

« Start or resume reindex API Batch reindex queue API »