OpenSearch/docs/en/rest-api/license/start-basic.asciidoc
Tim Brooks 7f7ac08447 Add api to start basic license (elastic/x-pack-elasticsearch#4083)
This is related to elastic/x-pack-elasticsearch#3877. This commit adds a route /start_basic that
will self generate a basic license. The only validation that is
performed is to check that you do not already have a basic license
installed. Additionally, if you lose features from switching to a basic
license, you must acknowledge the changes.

Original commit: elastic/x-pack-elasticsearch@7b8eeb50b1
2018-03-12 14:39:58 -06:00

74 lines
2.0 KiB
Plaintext

[role="xpack"]
[[start-basic]]
=== Start Basic API
This API starts an indefinite basic license.
[float]
==== Request
`POST _xpack/license/start_basic`
[float]
==== Description
The `start basic` API enables you to initiate an indefinite basic license, which
gives access to all {xpack} basic features. If the basic license does not support
all of the features that are available with your current license, however, you are
notified in the response. You must then re-submit the API request with the
`acknowledge` parameter set to `true`.
To check the status of your basic license, use the following API:
<<get-basic-status>>.
For more information about the different types of licenses, see
https://www.elastic.co/subscriptions.
==== Authorization
You must have `manage` cluster privileges to use this API.
For more information, see
{xpack-ref}/security-privileges.html[Security Privileges].
[float]
==== Examples
The following example starts a basic license if you do not currently have a license:
[source,js]
------------------------------------------------------------
POST _xpack/license/start_basic
------------------------------------------------------------
// CONSOLE
// TEST[skip:license testing issues]
Example response:
[source,js]
------------------------------------------------------------
{
"basic_was_started": true,
"acknowledged": true
}
------------------------------------------------------------
// NOTCONSOLE
The following example starts a basic license if you currently have a license with more
features than a basic license. As you are losing features, you must pass the acknowledge
parameter:
[source,js]
------------------------------------------------------------
POST _xpack/license/start_basic?acknowledge=true
------------------------------------------------------------
// CONSOLE
// TEST[skip:license testing issues]
Example response:
[source,js]
------------------------------------------------------------
{
"basic_was_started": true,
"acknowledged": true
}
------------------------------------------------------------
// NOTCONSOLE