Update the license
- POST also PUT /_license
You can update your license at runtime without shutting down your nodes. License updates take effect immediately. If the license you are installing does not support all of the features that were available with your previous license, however, you are notified in the response. You must then re-submit the API request with the acknowledge parameter set to true.
NOTE: If Elasticsearch security features are enabled and you are installing a gold or higher license, you must enable TLS on the transport networking layer before you install the license. If the operator privileges feature is enabled, only operator users can use this API.
- Cluster privileges:
manage
Query Parameters
-
acknowledgeboolean · default: false Specifies whether you acknowledge the license changes.
-
master_timeoutstring Duration · default: 30s The period to wait for a connection to the master node.
-
timeoutstring Duration · default: 30s The period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.
Request
-
licenseLicense -
expiry_date_in_millisEpochTimeUnitMillisrequired -
issue_date_in_millisEpochTimeUnitMillisrequired -
start_date_in_millisEpochTimeUnitMillis -
issued_tostringrequired -
issuerstringrequired -
max_nodesnumber | stringnullable -
max_resource_unitsnumber -
signaturestringrequired -
typeLicenseTyperequired -
Values:
missingtrialbasicstandarddevsilvergoldplatinumenterprise -
uidstringrequired -
licensesLicense -
A sequence of one or more JSON documents containing the license information.
Response
-
acknowledgeAcknowledgement -
acknowledgedbooleanrequired -
license_statusLicenseStatusrequired -
Values:
activevalidinvalidexpired