Start basic API

edit

This API starts an indefinite basic license.

Request

edit

POST /_license/start_basic

Description

edit

The start basic API enables you to initiate an indefinite basic license, which gives access to all the 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

edit

You must have manage cluster privileges to use this API. For more information, see Security privileges.

Examples

edit

The following example starts a basic license if you do not currently have a license:

resp = client.license.post_start_basic()
print(resp)
response = client.license.post_start_basic
puts response
const response = await client.license.postStartBasic();
console.log(response);
POST /_license/start_basic

Example response:

{
  "basic_was_started": true,
  "acknowledged": true
}

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:

resp = client.license.post_start_basic(
    acknowledge=True,
)
print(resp)
response = client.license.post_start_basic(
  acknowledge: true
)
puts response
const response = await client.license.postStartBasic({
  acknowledge: "true",
});
console.log(response);
POST /_license/start_basic?acknowledge=true

Example response:

{
  "basic_was_started": true,
  "acknowledged": true
}