› › ›

API обновления лицензии

Обновляет лицензию для кластера Elasticsearch.

Запрос

PUT _license

POST _license

Предварительные условия

Если в Elasticsearch включены функции безопасности, вам необходим правый доступ на кластер, чтобы установить лицензию.
Если в Elasticsearch включены функции безопасности и вы устанавливаете лицензию Gold или выше, необходимо включить TLS на транспортном уровне сети перед установкой лицензии. См. Шифрование межузловой коммуникации с помощью TLS.
Если включена функция прав оператора, использовать этот API могут только пользователи с правами оператора.

Описание

Вы можете обновить лицензию во время работы, не останавливая узлы. Обновления лицензии вступают в силу немедленно. Однако, если устанавливаемая лицензия не поддерживает все функции, доступные в предыдущей лицензии, об этом будет сообщено в ответе. После этого необходимо повторно отправить запрос API с параметром acknowledge, установленным в значение true.

Дополнительную информацию о различных типах лицензий см. на странице https://www.elastic.co/subscriptions.

Параметры запроса

acknowledge: (Необязательно, булево) Указывает, согласны ли вы с изменениями в лицензии. Значение по умолчанию — false.

Тело запроса

licenses: (Обязательно, массив) Последовательность одного или нескольких JSON-документов, содержащих информацию о лицензии.

Примеры

Следующий пример обновляет лицензию до базовой:

PUT _license
{
  "licenses": [
    {
      "uid":"893361dc-9749-4997-93cb-802e3d7fa4xx",
      "type":"basic",
      "issue_date_in_millis":1411948800000,
      "expiry_date_in_millis":1914278399999,
      "max_nodes":1,
      "issued_to":"issuedTo",
      "issuer":"issuer",
      "signature":"xx"
    }
    ]
}

Эти значения некорректны; необходимо заменить их соответствующим содержимым из вашего файла лицензии.

Вы также можете установить файл лицензии с помощью команды curl. Не забудьте добавить @ перед путем к файлу лицензии, чтобы указать curl на обработку его как входного файла.

curl -XPUT -u <user> 'http://<host>:<port>/_license' -H "Content-Type: application/json" -d @license.json

В Windows используйте следующую команду:

Invoke-WebRequest -uri http://<host>:<port>/_license -Credential elastic -Method Put -ContentType "application/json" -InFile .\license.json

В этих примерах:

<user> — идентификатор пользователя с соответствующими правами.
<host> — имя хоста любого узла в кластере Elasticsearch (localhost при выполнении локально)
<port> — порт HTTP (по умолчанию 9200)
license.json — файл лицензии в формате JSON

Если на узле Elasticsearch включен SSL для HTTP-интерфейса, необходимо начать URL с https://

Если ранее у вас была лицензия с большим количеством функций, чем базовая лицензия, вы получите следующий ответ:

  {
  "acknowledged": false,
  "license_status": "valid",
  "acknowledge": {
    "message": """This license update requires acknowledgement. To acknowledge the license, please read the following messages and update the license again, this time with the "acknowledge=true" parameter:""",
    "watcher": [
      "Watcher will be disabled"
    ],
    "logstash": [
      "Logstash will no longer poll for centrally-managed pipelines"
    ],
    "security": [
      "The following X-Pack security functionality will be disabled: ..." ]
    }
}

Для завершения обновления необходимо повторно отправить запрос API и установить параметр acknowledge в значение true. Например:

PUT _license?acknowledge=true
{
  "licenses": [
    {
      "uid":"893361dc-9749-4997-93cb-802e3d7fa4xx",
      "type":"basic",
      "issue_date_in_millis":1411948800000,
      "expiry_date_in_millis":1914278399999,
      "max_nodes":1,
      "issued_to":"issuedTo",
      "issuer":"issuer",
      "signature":"xx"
    }
    ]
}

Или:

curl -XPUT -u elastic 'http://<host>:<port>/_license?acknowledge=true' -H "Content-Type: application/json" -d @license.json

Дополнительную информацию о функциях, которые отключаются при истечении срока действия лицензии, см. на странице Истечение срока действия лицензии.

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/7.17/update-license.html