76 lines
2.1 KiB
Plaintext
76 lines
2.1 KiB
Plaintext
|
[role="xpack"]
|
||
|
|
[[get-license]]
|
||
|
|
=== Get License API
|
||
|
|
|
||
|
|
This API enables you to retrieve licensing information.
|
||
|
|
|
||
|
|
[float]
|
||
|
|
==== Request
|
||
|
|
|
||
|
|
`GET /_xpack/license`
|
||
|
|
|
||
|
|
[float]
|
||
|
|
==== Description
|
||
|
|
|
||
|
|
This API returns information about the type of license, when it was issued, and
|
||
|
|
when it expires, for example.
|
||
|
|
|
||
|
|
For more information about the different types of licenses, see
|
||
|
|
https://www.elastic.co/subscriptions.
|
||
|
|
|
||
|
|
|
||
|
|
[float]
|
||
|
|
==== Query Parameters
|
||
|
|
|
||
|
|
`local`::
|
||
|
|
(boolean) Specifies whether to retrieve local information. The default value
|
||
|
|
is `false`, which means the information is retrieved from the master node.
|
||
|
|
|
||
|
|
|
||
|
|
[float]
|
||
|
|
==== 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 provides information about a basic license:
|
||
|
|
|
||
|
|
[source,js]
|
||
|
|
--------------------------------------------------
|
||
|
|
GET _xpack/license
|
||
|
|
--------------------------------------------------
|
||
|
|
// CONSOLE
|
||
|
|
|
||
|
|
[source,js]
|
||
|
|
--------------------------------------------------
|
||
|
|
{
|
||
|
|
"license" : {
|
||
|
|
"status" : "active",
|
||
|
|
"uid" : "cbff45e7-c553-41f7-ae4f-9205eabd80xx",
|
||
|
|
"type" : "trial",
|
||
|
|
"issue_date" : "2018-02-22T23:12:05.550Z",
|
||
|
|
"issue_date_in_millis" : 1519341125550,
|
||
|
|
"expiry_date" : "2018-03-24T23:12:05.550Z",
|
||
|
|
"expiry_date_in_millis" : 1521933125550,
|
||
|
|
"max_nodes" : 1000,
|
||
|
|
"issued_to" : "test",
|
||
|
|
"issuer" : "elasticsearch",
|
||
|
|
"start_date_in_millis" : -1
|
||
|
|
}
|
||
|
|
}
|
||
|
|
--------------------------------------------------
|
||
|
|
// TESTRESPONSE[s/"cbff45e7-c553-41f7-ae4f-9205eabd80xx"/$body.license.uid/]
|
||
|
|
// TESTRESPONSE[s/"trial"/$body.license.type/]
|
||
|
|
// TESTRESPONSE[s/"2018-02-22T23:12:05.550Z"/$body.license.issue_date/]
|
||
|
|
// TESTRESPONSE[s/1519341125550/$body.license.issue_date_in_millis/]
|
||
|
|
// TESTRESPONSE[s/"2018-03-24T23:12:05.550Z"/$body.license.expiry_date/]
|
||
|
|
// TESTRESPONSE[s/1521933125550/$body.license.expiry_date_in_millis/]
|
||
|
|
// TESTRESPONSE[s/1000/$body.license.max_nodes/]
|
||
|
|
// TESTRESPONSE[s/"test"/$body.license.issued_to/]
|
||
|
|
// TESTRESPONSE[s/"elasticsearch"/$body.license.issuer/]
|