OpenSearch/docs/reference/licensing/get-license.asciidoc
Jason Tedor bf5f0af491
Use trial license in docs tests (#34673)
This commit switches to using a trial license in the docs tests that run
on the default distribution. This is needed so that docs tests can be
executed against non-basic features.
2018-10-21 06:23:42 -04:00

77 lines
2.1 KiB
Plaintext

[role="xpack"]
[testenv="basic"]
[[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 trial license:
[source,js]
--------------------------------------------------
GET _xpack/license
--------------------------------------------------
// CONSOLE
[source,js]
--------------------------------------------------
{
"license" : {
"status" : "active",
"uid" : "cbff45e7-c553-41f7-ae4f-9205eabd80xx",
"type" : "trial",
"issue_date" : "2018-10-20T22:05:12.332Z",
"issue_date_in_millis" : 1540073112332,
"expiry_date" : "2018-11-19T22:05:12.332Z",
"expiry_date_in_millis" : 1542665112332,
"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/"basic"/$body.license.type/]
// TESTRESPONSE[s/"2018-10-20T22:05:12.332Z"/$body.license.issue_date/]
// TESTRESPONSE[s/1540073112332/$body.license.issue_date_in_millis/]
// TESTRESPONSE[s/"2018-11-19T22:05:12.332Z"/$body.license.expiry_date/]
// TESTRESPONSE[s/1542665112332/$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/]