The following page lists the HTTP operations that need to be performed to successfully deactivate an LAC license.
To deactivate a license for a given, unique combination of an activation key and a HostID, use the following request:
| Panel |
|---|
DELETE /licenses/(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
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
DELETE /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 as described in the following table.
| Status Code | Header Field | Description |
|---|---|---|
| 204 No Content | Deactivation successful. | |
| 403 Forbidden | License order has been disabled or cannot deactivate license, because it's not allowed for end user. | |
| 404 Not Found | License does not exist. |
Example responses
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
HTTP/1.1 204 No Content |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
HTTP/1.1 403 Forbidden
Content-Type: application/hal+json
{
"message": "Cannot deactivate license."
} |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
HTTP/1.1 404 Not Found
Content-Type: application/hal+json
{
"message": "License does not exist."
} |
For more information about HTTP methods, see Supported HTTP methods.