2018-03-06 12:47:04 -05:00
|
|
|
[role="xpack"]
|
2018-06-20 11:17:11 -04:00
|
|
|
[testenv="basic"]
|
2018-03-06 12:47:04 -05:00
|
|
|
[[get-trial-status]]
|
2018-12-20 13:23:28 -05:00
|
|
|
=== Get trial status API
|
|
|
|
++++
|
|
|
|
<titleabbrev>Get trial status</titleabbrev>
|
|
|
|
++++
|
2018-03-06 12:47:04 -05:00
|
|
|
|
|
|
|
This API enables you to check the status of your trial license.
|
|
|
|
|
|
|
|
[float]
|
|
|
|
==== Request
|
|
|
|
|
2018-11-28 08:24:35 -05:00
|
|
|
`GET /_license/trial_status`
|
2018-03-06 12:47:04 -05:00
|
|
|
|
|
|
|
[float]
|
|
|
|
==== Description
|
|
|
|
|
2018-06-28 18:38:41 -04:00
|
|
|
If you want to try the features that are included in a platinum license, you can
|
|
|
|
start a 30-day trial.
|
2018-03-06 12:47:04 -05:00
|
|
|
|
|
|
|
NOTE: You are allowed to initiate a trial license only if your cluster has not
|
2018-06-28 18:38:41 -04:00
|
|
|
already activated a trial license for the current major product version. For
|
2018-03-06 12:47:04 -05:00
|
|
|
example, if you have already activated a trial for v6.0, you cannot start a new
|
|
|
|
trial until v7.0. You can, however, contact `info@elastic.co` to request an
|
|
|
|
extended trial license.
|
|
|
|
|
|
|
|
For more information about the different types of licenses, see
|
|
|
|
https://www.elastic.co/subscriptions.
|
|
|
|
|
|
|
|
==== Authorization
|
|
|
|
|
|
|
|
You must have `monitor` cluster privileges to use this API.
|
|
|
|
For more information, see
|
|
|
|
{xpack-ref}/security-privileges.html[Security Privileges].
|
|
|
|
|
|
|
|
[float]
|
|
|
|
==== Examples
|
|
|
|
|
|
|
|
The following example checks whether you are eligible to start a trial:
|
|
|
|
|
2019-09-06 11:31:13 -04:00
|
|
|
[source,console]
|
2018-03-06 12:47:04 -05:00
|
|
|
------------------------------------------------------------
|
2018-11-28 08:24:35 -05:00
|
|
|
GET /_license/trial_status
|
2018-03-06 12:47:04 -05:00
|
|
|
------------------------------------------------------------
|
|
|
|
|
|
|
|
Example response:
|
|
|
|
[source,js]
|
|
|
|
------------------------------------------------------------
|
|
|
|
{
|
|
|
|
"eligible_to_start_trial": true
|
|
|
|
}
|
|
|
|
------------------------------------------------------------
|
|
|
|
// TESTRESPONSE[s/"eligible_to_start_trial": true/"eligible_to_start_trial": $body.eligible_to_start_trial/]
|