OpenSearch/x-pack/docs/en/rest-api/license/get-basic-status.asciidoc

46 lines
1.1 KiB
Plaintext
Raw Normal View History

[role="xpack"]
[[get-basic-status]]
=== Get Basic Status API
This API enables you to check the status of your basic license.
[float]
==== Request
`GET _xpack/license/basic_status`
[float]
==== Description
In order to initiate a basic license, you must not currently have a basic
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 basic:
[source,js]
------------------------------------------------------------
GET _xpack/license/basic_status
------------------------------------------------------------
// CONSOLE
Example response:
[source,js]
------------------------------------------------------------
{
"eligible_to_start_basic": true
}
------------------------------------------------------------
// TESTRESPONSE[s/"eligible_to_start_basic": true/"eligible_to_start_basic": $body.eligible_to_start_basic/]