NOTE: You are looking at documentation for an older release. For the latest information, see the current release documentation.
Migration upgrade API
editMigration upgrade API
editTo prepare a cluster for an upgrade to Elasticsearch version 7, use the Kibana Upgrade Assistant or reindex manually before upgrading.
Deprecated in 6.7.
Use the Kibana Upgrade Assistant or reindex manually before upgrading.
The migration upgrade API performs the upgrade of internal indices to make them compatible with version 6 of Elasticsearch.
Request
editPOST /_xpack/migration/upgrade/<index_name>
Description
editIndices must be upgraded one at a time.
Path Parameters
edit-
index_name
- (string) Identifier for the index.
-
wait_for_completion
-
(boolean) Defines whether the upgrade call blocks until the upgrade process is
finished. The default value is
true
. If set tofalse
, the upgrade can be performed asynchronously.
Examples
editThe following example submits a POST request to the
/_xpack/migration/upgrade/<index_name>
endpoint:
POST /_xpack/migration/upgrade/.watches
A successful call returns the statistics about the upgrade process:
{ "took" : 127, "timed_out" : false, "total" : 4, "updated" : 0, "created" : 4, "deleted" : 0, "batches" : 1, "version_conflicts" : 0, "noops" : 0, "retries" : { "bulk" : 0, "search" : 0 }, "throttled_millis" : 0, "failures" : [ ] }
The following example upgrades a large index asynchronously by specifying the
wait_for_completion
parameter:
POST /_xpack/migration/upgrade/.watches?wait_for_completion=false
This call should return the id of the upgrade process task:
{ "task" : "PFvgv7T6TGumRyFF3vqTFg:1137" }
The status of the running or finished upgrade requests can be obtained by using the Task API:
GET _tasks/PFvgv7T6TGumRyFF3vqTFg:1137?detailed=true
{ "completed" : true, "task" : { "node" : "PFvgv7T6TGumRyFF3vqTFg", "id" : 1137, "type" : "transport", "action" : "cluster:admin/xpack/upgrade", "description" : "", "start_time_in_millis" : 1500650625413, "running_time_in_nanos" : 947456819, "cancellable" : true }, "response" : { "took" : 212, "timed_out" : false, "total" : 4, "updated" : 0, "created" : 4, "deleted" : 0, "batches" : 1, "version_conflicts" : 0, "noops" : 0, "retries" : { "bulk" : 0, "search" : 0 }, "throttled_millis" : 0, "failures" : [ ] } }