To activate a license for a given, unique combination of an activation key and a HostID, use the following request:
PUT /licenses/
(activation_key)/(hostids)
where:
- activation_key (string) is your license order activation key
and
- hostids (string) are Base64 encoded values. The format of HostIDs is a comma-separated list of types and values; for example, ETHERNET=AABBCCDDEEFF,IPADDRESS=192.168.0.5
Note that request headers are used by default.
Example request
PUT /rest/v1/licenses/4CT1V-4T10N-K3Y1S-C000L/dHlwZTE9dmFsdWUxLHR5cGUyPXZhbHVlPTI= HTTP/1.1 Host: license.x-formation.com Accept: application/hal+json
Response
The LAC REST API returns standard HTTP response codes described in the following table.
Status Code | Header Field | Description |
---|---|---|
202 Accepted | New license request has been created after successful license validation. The Location header field contains an absolute URI for automatic redirection to this resource.
| |
| Requested activation key is invalid or the format of a hostid is wrong. Response body contains more detailed information about this error.
| |
403 Forbidden | License cannot be activated, because it is not in sync with the internal configuration. Response message contains more information. |
Example response
HTTP/1.1 202 Accepted Vary: Accept Location: https://license.x-formation.com/rest/v1/license-queue/4CT1V-4T10N-K3Y1S-C000L/dHlwZTE9dmFsdWUxLHR5cGUyPXZhbHVlPTI=
For more information about HTTP methods, see Supported HTTP methods.