2017-07-21 19:20:13 -04:00
|
|
|
[role="xpack"]
|
2018-06-21 11:19:23 -04:00
|
|
|
[testenv="basic"]
|
2017-07-21 19:20:13 -04:00
|
|
|
[[migration-api-deprecation]]
|
2018-03-06 12:47:04 -05:00
|
|
|
=== Deprecation Info APIs
|
2017-07-21 19:20:13 -04:00
|
|
|
|
2017-09-11 17:02:23 -04:00
|
|
|
The deprecation API is to be used to retrieve information about different
|
|
|
|
cluster, node, and index level settings that use deprecated features that will
|
|
|
|
be removed or changed in the next major version.
|
2017-07-21 19:20:13 -04:00
|
|
|
|
2017-09-11 17:02:23 -04:00
|
|
|
[float]
|
2018-03-06 12:47:04 -05:00
|
|
|
==== Request
|
2017-09-11 17:02:23 -04:00
|
|
|
|
2018-11-28 15:19:33 -05:00
|
|
|
`GET /_migration/deprecations` +
|
2017-09-11 17:02:23 -04:00
|
|
|
|
2018-11-28 15:19:33 -05:00
|
|
|
`GET /<index_name>/_migration/deprecations`
|
2017-09-11 17:02:23 -04:00
|
|
|
|
|
|
|
//=== Description
|
|
|
|
|
|
|
|
[float]
|
2018-03-06 12:47:04 -05:00
|
|
|
==== Path Parameters
|
2017-09-11 17:02:23 -04:00
|
|
|
|
|
|
|
`index_name`::
|
|
|
|
(string) Identifier for the index. It can be an index name or a wildcard
|
|
|
|
expression. When you specify this parameter, only index-level deprecations for
|
|
|
|
the specified indices are returned.
|
|
|
|
|
|
|
|
//=== Query Parameters
|
|
|
|
|
|
|
|
//=== Authorization
|
|
|
|
|
|
|
|
[float]
|
2018-03-06 12:47:04 -05:00
|
|
|
==== Examples
|
2017-09-11 17:02:23 -04:00
|
|
|
|
|
|
|
To see the list of offenders in your cluster, submit a GET request to the
|
2018-11-28 15:19:33 -05:00
|
|
|
`_migration/deprecations` endpoint:
|
2017-07-21 19:20:13 -04:00
|
|
|
|
|
|
|
[source,js]
|
|
|
|
--------------------------------------------------
|
2018-11-28 15:19:33 -05:00
|
|
|
GET /_migration/deprecations
|
2017-07-21 19:20:13 -04:00
|
|
|
--------------------------------------------------
|
|
|
|
// CONSOLE
|
|
|
|
// TEST[skip:cannot assert tests have certain deprecations]
|
|
|
|
|
|
|
|
Example response:
|
|
|
|
|
|
|
|
|
2017-08-16 16:59:37 -04:00
|
|
|
["source","js",subs="attributes,callouts,macros"]
|
2017-07-21 19:20:13 -04:00
|
|
|
--------------------------------------------------
|
|
|
|
{
|
|
|
|
"cluster_settings" : [
|
|
|
|
{
|
2018-12-07 17:45:53 -05:00
|
|
|
"level" : "critical",
|
|
|
|
"message" : "Cluster name cannot contain ':'",
|
|
|
|
"url" : "{ref}/breaking-changes-7.0.html#_literal_literal_is_no_longer_allowed_in_cluster_name",
|
|
|
|
"details" : "This cluster is named [mycompany:logging], which contains the illegal character ':'."
|
2017-07-21 19:20:13 -04:00
|
|
|
}
|
|
|
|
],
|
|
|
|
"node_settings" : [ ],
|
|
|
|
"index_settings" : {
|
2018-12-07 17:45:53 -05:00
|
|
|
"logs:apache" : [
|
2017-07-21 19:20:13 -04:00
|
|
|
{
|
2018-12-07 17:45:53 -05:00
|
|
|
"level" : "warning",
|
|
|
|
"message" : "Index name cannot contain ':'",
|
|
|
|
"url" : "{ref}/breaking-changes-7.0.html#_literal_literal_is_no_longer_allowed_in_index_name",
|
|
|
|
"details" : "This index is named [logs:apache], which contains the illegal character ':'."
|
2017-07-21 19:20:13 -04:00
|
|
|
}
|
|
|
|
]
|
|
|
|
}
|
|
|
|
}
|
|
|
|
--------------------------------------------------
|
|
|
|
// NOTCONSOLE
|
|
|
|
|
2017-09-11 17:02:23 -04:00
|
|
|
The response breaks down all the specific forward-incompatible settings that you
|
|
|
|
should resolve before upgrading your cluster. Any offending settings are
|
|
|
|
represented as a deprecation warning.
|
2017-07-21 19:20:13 -04:00
|
|
|
|
|
|
|
The following is an example deprecation warning:
|
|
|
|
|
2017-08-16 16:59:37 -04:00
|
|
|
["source","js",subs="attributes,callouts,macros"]
|
2017-07-21 19:20:13 -04:00
|
|
|
--------------------------------------------------
|
|
|
|
{
|
2018-12-07 17:45:53 -05:00
|
|
|
"level" : "warning",
|
2017-07-21 19:20:13 -04:00
|
|
|
"message" : "This is the generic descriptive message of the breaking change",
|
2017-08-16 18:40:44 -04:00
|
|
|
"url" : "{ref-60}/breaking_60_indices_changes.html",
|
2017-07-21 19:20:13 -04:00
|
|
|
"details" : "more information, like which nodes, indices, or settings are to blame"
|
|
|
|
}
|
|
|
|
--------------------------------------------------
|
|
|
|
// NOTCONSOLE
|
|
|
|
|
2017-09-11 17:02:23 -04:00
|
|
|
As is shown, there is a `level` property that describes the significance of the
|
|
|
|
issue.
|
2017-07-21 19:20:13 -04:00
|
|
|
|
|
|
|
|=======
|
2017-09-11 17:02:23 -04:00
|
|
|
|warning | You can upgrade directly, but you are using deprecated functionality
|
2018-12-07 17:45:53 -05:00
|
|
|
which will not be available or behave differently in the next major version.
|
2017-09-11 17:02:23 -04:00
|
|
|
|critical | You cannot upgrade without fixing this problem.
|
2017-07-21 19:20:13 -04:00
|
|
|
|=======
|
|
|
|
|
2017-09-11 17:02:23 -04:00
|
|
|
The `message` property and the optional `details` property provide descriptive
|
|
|
|
information about the deprecation warning. The `url` property provides a link to
|
|
|
|
the Breaking Changes Documentation, where you can find more information about
|
|
|
|
this change.
|
2017-07-21 19:20:13 -04:00
|
|
|
|
2017-09-11 17:02:23 -04:00
|
|
|
Any cluster-level deprecation warnings can be found under the `cluster_settings`
|
|
|
|
key. Similarly, any node-level warnings are found under `node_settings`. Since
|
|
|
|
only a select subset of your nodes might incorporate these settings, it is
|
|
|
|
important to read the `details` section for more information about which nodes
|
|
|
|
are affected. Index warnings are sectioned off per index and can be filtered
|
|
|
|
using an index-pattern in the query.
|
2017-07-21 19:20:13 -04:00
|
|
|
|
2017-09-11 17:02:23 -04:00
|
|
|
The following example request shows only index-level deprecations of all
|
|
|
|
`logstash-*` indices:
|
2017-07-21 19:20:13 -04:00
|
|
|
|
|
|
|
[source,js]
|
|
|
|
--------------------------------------------------
|
2018-11-28 15:19:33 -05:00
|
|
|
GET /logstash-*/_migration/deprecations
|
2017-07-21 19:20:13 -04:00
|
|
|
--------------------------------------------------
|
|
|
|
// CONSOLE
|
|
|
|
// TEST[skip:cannot assert tests have certain deprecations]
|