mirror of https://github.com/hashicorp/consul
215 lines
6.1 KiB
Markdown
215 lines
6.1 KiB
Markdown
---
|
|
layout: api
|
|
page_title: License - Operator - HTTP API
|
|
description: |-
|
|
The /operator/license endpoint allows for retrieving the Consul
|
|
Enterprise License.
|
|
---
|
|
|
|
# License - Operator HTTP API
|
|
|
|
<EnterpriseAlert />
|
|
|
|
The licensing functionality described here is available only in
|
|
[Consul Enterprise](https://www.hashicorp.com/products/consul/) version 1.1.0 and later.
|
|
|
|
## Getting the Consul License
|
|
|
|
This endpoint gets information about the current license.
|
|
|
|
| Method | Path | Produces |
|
|
| ------ | ------------------- | ------------------ |
|
|
| `GET` | `/operator/license` | `application/json` |
|
|
|
|
The table below shows this endpoint's support for
|
|
[blocking queries](/api-docs/features/blocking),
|
|
[consistency modes](/api-docs/features/consistency),
|
|
[agent caching](/api-docs/features/caching), and
|
|
[required ACLs](/api-docs/api-structure#authentication).
|
|
|
|
| Blocking Queries | Consistency Modes | Agent Caching | ACL Required |
|
|
| ---------------- | ----------------- | ------------- | ------------ |
|
|
| `NO` | `all` | `none` | `none` |
|
|
|
|
The corresponding CLI command is [`consul license get`](/commands/license#get).
|
|
|
|
### Query Parameters
|
|
|
|
- `dc` `(string: "")` - Specifies the datacenter whose license should be retrieved.
|
|
This will default to the datacenter of the agent serving the HTTP request.
|
|
|
|
### Sample Request
|
|
|
|
```shell-session
|
|
$ curl \
|
|
http://127.0.0.1:8500/v1/operator/license
|
|
```
|
|
|
|
### Sample Response
|
|
|
|
```json
|
|
{
|
|
"Valid": true,
|
|
"License": {
|
|
"license_id": "2afbf681-0d1a-0649-cb6c-333ec9f0989c",
|
|
"customer_id": "0259271d-8ffc-e85e-0830-c0822c1f5f2b",
|
|
"installation_id": "*",
|
|
"issue_time": "2018-05-21T20:03:35.911567355Z",
|
|
"start_time": "2018-05-21T04:00:00Z",
|
|
"expiration_time": "2019-05-22T03:59:59.999Z",
|
|
"product": "consul",
|
|
"flags": {
|
|
"package": "premium"
|
|
},
|
|
"features": [
|
|
"Automated Backups",
|
|
"Automated Upgrades",
|
|
"Enhanced Read Scalability",
|
|
"Network Segments",
|
|
"Redundancy Zone",
|
|
"Advanced Network Federation"
|
|
],
|
|
"temporary": false
|
|
},
|
|
"Warnings": []
|
|
}
|
|
```
|
|
|
|
## Updating the Consul License
|
|
|
|
-> **Deprecated** This endpoint was removed in Consul v1.10.0 along with
|
|
the ability to manage the cluster's license via the API.
|
|
|
|
This endpoint updates the Consul license and returns some of the
|
|
license contents as well as any warning messages regarding its validity.
|
|
|
|
| Method | Path | Produces |
|
|
| ------ | ------------------- | ------------------ |
|
|
| `PUT` | `/operator/license` | `application/json` |
|
|
|
|
The table below shows this endpoint's support for
|
|
[blocking queries](/api-docs/features/blocking),
|
|
[consistency modes](/api-docs/features/consistency),
|
|
[agent caching](/api-docs/features/caching), and
|
|
[required ACLs](/api-docs/api-structure#authentication).
|
|
|
|
| Blocking Queries | Consistency Modes | Agent Caching | ACL Required |
|
|
| ---------------- | ----------------- | ------------- | ---------------- |
|
|
| `NO` | `none` | `none` | `operator:write` |
|
|
|
|
The corresponding CLI command is [`consul license put`](/commands/license#put).
|
|
|
|
### Query Parameters
|
|
|
|
- `dc` `(string: "")` - Specifies the datacenter whose license should be updated.
|
|
This will default to the datacenter of the agent serving the HTTP request.
|
|
|
|
### Sample Payload
|
|
|
|
The payload is the raw license blob.
|
|
|
|
### Sample Request
|
|
|
|
```shell-session
|
|
$ curl \
|
|
--request PUT \
|
|
--data @consul.license \
|
|
http://127.0.0.1:8500/v1/operator/license
|
|
```
|
|
|
|
### Sample Response
|
|
|
|
```json
|
|
{
|
|
"Valid": true,
|
|
"License": {
|
|
"license_id": "2afbf681-0d1a-0649-cb6c-333ec9f0989c",
|
|
"customer_id": "0259271d-8ffc-e85e-0830-c0822c1f5f2b",
|
|
"installation_id": "*",
|
|
"issue_time": "2018-05-21T20:03:35.911567355Z",
|
|
"start_time": "2018-05-21T04:00:00Z",
|
|
"expiration_time": "2019-05-22T03:59:59.999Z",
|
|
"product": "consul",
|
|
"flags": {
|
|
"package": "premium"
|
|
},
|
|
"features": [
|
|
"Automated Backups",
|
|
"Automated Upgrades",
|
|
"Enhanced Read Scalability",
|
|
"Network Segments",
|
|
"Redundancy Zone",
|
|
"Advanced Network Federation"
|
|
],
|
|
"temporary": false
|
|
},
|
|
"Warnings": []
|
|
}
|
|
```
|
|
|
|
## Resetting the Consul License
|
|
|
|
-> **Deprecated** This endpoint was removed in Consul v1.10.0 along with
|
|
the ability to manage the cluster's license via the API.
|
|
|
|
This endpoint resets the Consul license to the license included in the Enterprise binary. If the included license is not valid, the replace will fail.
|
|
|
|
| Method | Path | Produces |
|
|
| -------- | ------------------- | ------------------ |
|
|
| `DELETE` | `/operator/license` | `application/json` |
|
|
|
|
The table below shows this endpoint's support for
|
|
[blocking queries](/api-docs/features/blocking),
|
|
[consistency modes](/api-docs/features/consistency),
|
|
[agent caching](/api-docs/features/caching), and
|
|
[required ACLs](/api-docs/api-structure#authentication).
|
|
|
|
| Blocking Queries | Consistency Modes | Agent Caching | ACL Required |
|
|
| ---------------- | ----------------- | ------------- | ---------------- |
|
|
| `NO` | `none` | `none` | `operator:write` |
|
|
|
|
The corresponding CLI command is [`consul license reset`](/commands/license#reset).
|
|
|
|
### Query Parameters
|
|
|
|
- `dc` `(string: "")` - Specifies the datacenter whose license should be updated.
|
|
This will default to the datacenter of the agent serving the HTTP request.
|
|
|
|
### Sample Request
|
|
|
|
```shell-session
|
|
$ curl \
|
|
--request DELETE \
|
|
http://127.0.0.1:8500/v1/operator/license
|
|
```
|
|
|
|
### Sample Response
|
|
|
|
```json
|
|
{
|
|
"Valid": true,
|
|
"License": {
|
|
"license_id": "2afbf681-0d1a-0649-cb6c-333ec9f0989c",
|
|
"customer_id": "0259271d-8ffc-e85e-0830-c0822c1f5f2b",
|
|
"installation_id": "*",
|
|
"issue_time": "2018-05-21T20:03:35.911567355Z",
|
|
"start_time": "2018-05-21T04:00:00Z",
|
|
"expiration_time": "2019-05-22T03:59:59.999Z",
|
|
"product": "consul",
|
|
"flags": {
|
|
"package": "premium"
|
|
},
|
|
"features": [
|
|
"Automated Backups",
|
|
"Automated Upgrades",
|
|
"Enhanced Read Scalability",
|
|
"Network Segments",
|
|
"Redundancy Zone",
|
|
"Advanced Network Federation"
|
|
],
|
|
"temporary": false
|
|
},
|
|
"Warnings": []
|
|
}
|
|
```
|