Info |
---|
This page refers to End-user REST API version 1 only. See End-user REST API for links to other versions of the End-user REST API. |
To activate a license for a given, unique combination of an Activation Key activation key and a HostID using the End-user REST API version 1, use the following request:
Panel |
---|
PUT /licenses/ (activation_key)/(hostids)
|
where:
- The activation_key (string) is your product license order activation key.
and
- The values of hostids (string) are Base64 encoded in Base64 format.values. The format of HostID(s) that you can specify 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
Code Block |
---|
language | js |
---|
firstline | 1 |
---|
linenumbers | true |
---|
|
PUT /rest/v1/licenses/4CT1V-4T10N-K3Y1S-C000L/dHlwZTE9dmFsdWUxLHR5cGUyPXZhbHVlPTI= HTTP/1.1
Host: license.x-formation.com
Accept: application/hal+json |
...
The LAC REST API returns standard HTTP response codes as described in the following table.
The request for a new license is created upon its successful validation. Furthermore, it indicates that the Location header field value consists of New license request has been created after successful license validation. The Location header field contains an absolute URI for automatic redirection to this resource. |
The requested Requested activation key is invalid or the format of a |
hosid The response Response body contains more |
details license The License cannot be activated |
according to , because it is not in sync with the internal configuration. |
The response Response message contains more information. |
Example responseresponses
Code Block |
---|
language | text |
---|
firstline | 1 |
---|
linenumbers | true |
---|
|
HTTP/1.1 202 Accepted
Vary: Accept
Location: https://license.x-formation.com/rest/v1/license-queue/4CT1V-4T10N-K3Y1S-C000L/dHlwZTE9dmFsdWUxLHR5cGUyPXZhbHVlPTI= |
Code Block |
---|
language | js |
---|
firstline | 1 |
---|
linenumbers | true |
---|
|
HTTP/1.1 400 Bad Request
Content-Type: application/hal+json
{
"message": "Invalid HostID format provided."
} |
Code Block |
---|
language | js |
---|
firstline | 1 |
---|
linenumbers | true |
---|
|
HTTP/1.1 403 Forbidden
Content-Type: application/hal+json
{
"message": "License generator was not uploaded for this product."
} |
For more information about HTTP methods, see Supported HTTP methods.