To see details about errors that may have occurred in the proces of activating a license for a given, unique combination of an activation key and a HostID, use the following request:
GET
/license-errors
/(activation_key)/(hostids)
where:
- activation_key (string) is your license order activation key
and
- hostids (string) are Base64 encoded 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
GET /rest/v1/license-errors/4CT1V-4T10N-K3Y1S-C000L/dHlwZTE9dmFsdWUxLHR5cGUyPXZhbHVlPTI= HTTP/1.1 Host: license.x-formation.com Accept: application/hal+json
Response
The following table lists the Internet status codes that can be returned in a response by a server.
Status Code | Header Field | Description |
---|---|---|
200 OK | Errors that occurred during activation are listed in the response body. | |
403 Forbidden | License order has been disabled. | |
404 Not Found | No activation errors occurred for a given pair of activation_key and hostids. |
Example response
HTTP/1.1 200 OK { "errors": [ { "message": "LM-X XML License Generator v4.5.3 Copyright (C) 2002-2013 X-Formation. All rights reserved. LM-X Error: Unable to parse and load xml file /tmp/lgtmp_id_2/1400064446_139933.in! LM-X Error: /tmp/lgtmp_id_2/1400064446_139933.in(7): not well-formed (invalid token)!", "creationTime": "2014-05-14T10:47:26+00:00" } ], "_links": { "self": { "href": "https://license.x-formation.com/rest/v1/license-errors/4CT1V-4T10N-K3Y1S-C000L/dHlwZTE9dmFsdWUxLHR5cGUyPXZhbHVlPTI=" } } }
For more information about HTTP methods, see Supported HTTP methods.