mirror of
https://github.com/grafana/grafana.git
synced 2025-08-01 03:31:50 +08:00
a20b3e2d59
* fleshing out About topic * docs, fgac refactor initial draft * updated FGAC with service account details * finalized restructure * make prettier, corrects spelling * fixes typo * adds rollout strategy topic * started name change * renamed to rbac throughout docs * copy edit to about and actions and scopes docs * finishes content reorg * draft of refactored refactored docs * corrects relrefs * formatting tweaks * fixes typo * copy updates to about rbac * rbac rollout docs edits * update rbac role assignment docs * content update to manage rbac roles doc * sort and reorder roles reference in rbac docs * alphabetize permissions table * Update docs/sources/enterprise/settings-updates.md Co-authored-by: Mitch Seaman <mjseaman@users.noreply.github.com> * incorporates feedback, makes prettier * update http api references in rbac docs * fix broken refs and improve wording on enabling RBAC provisioning Co-authored-by: eleijonmarck <eric.leijonmarck@gmail.com> Co-authored-by: Mitchel Seaman <mitchel.seaman@gmail.com> Co-authored-by: Mitch Seaman <mjseaman@users.noreply.github.com>
164 lines
3.4 KiB
Markdown
164 lines
3.4 KiB
Markdown
+++
|
||
title = "Licensing HTTP API "
|
||
description = "Enterprise Licensing HTTP API"
|
||
keywords = ["grafana", "http", "documentation", "api", "licensing", "enterprise"]
|
||
aliases = ["/docs/grafana/latest/http_api/licensing/"]
|
||
+++
|
||
|
||
# Enterprise License API
|
||
|
||
Licensing is only available in Grafana Enterprise. Read more about [Grafana Enterprise]({{< relref "../enterprise" >}}).
|
||
|
||
If you are running Grafana Enterprise and have [Role-based access control]({{< relref "../enterprise/access-control/_index.md" >}}) enabled, for some endpoints you would need to have relevant permissions.
|
||
Refer to specific resources to understand what permissions are required.
|
||
|
||
## Check license availability
|
||
|
||
> **Note:** Available in Grafana Enterprise v7.4+.
|
||
|
||
`GET /api/licensing/check`
|
||
|
||
Checks if a valid license is available.
|
||
|
||
### Required permissions
|
||
|
||
See note in the [introduction]({{< ref "#enterprise-license-api" >}}) for an explanation.
|
||
|
||
| Action | Scope |
|
||
| -------------- | ----- |
|
||
| licensing:read | n/a |
|
||
|
||
### Examples
|
||
|
||
**Example request:**
|
||
|
||
```http
|
||
GET /api/licensing/check
|
||
Accept: application/json
|
||
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
|
||
```
|
||
|
||
**Example response:**
|
||
|
||
```http
|
||
HTTP/1.1 200 OK
|
||
Content-Type: application/json
|
||
Content-Length: 4
|
||
|
||
```
|
||
|
||
Status codes:
|
||
|
||
- **200** - OK
|
||
|
||
## Manually force license refresh
|
||
|
||
> **Note:** Available in Grafana Enterprise v7.4+.
|
||
|
||
`POST /api/licensing/token/renew`
|
||
|
||
Manually ask license issuer for a new token.
|
||
|
||
### Required permissions
|
||
|
||
See note in the [introduction]({{< ref "#enterprise-license-api" >}}) for an explanation.
|
||
|
||
| Action | Scope |
|
||
| ---------------- | ----- |
|
||
| licensing:update | n/a |
|
||
|
||
### Examples
|
||
|
||
**Example request:**
|
||
|
||
```http
|
||
POST /api/licensing/token/renew
|
||
Accept: application/json
|
||
Content-Type: application/json
|
||
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
|
||
|
||
{}
|
||
```
|
||
|
||
**Example response:**
|
||
|
||
```http
|
||
HTTP/1.1 200 OK
|
||
Content-Type: application/json
|
||
Content-Length: 357
|
||
|
||
```
|
||
|
||
The response is a JSON blob available for debugging purposes. The
|
||
available fields may change at any time without any prior notice.
|
||
|
||
Status Codes:
|
||
|
||
- **200** - OK
|
||
- **401** - Unauthorized
|
||
- **403** - Access denied
|
||
|
||
## Remove license from database
|
||
|
||
> **Note:** Available in Grafana Enterprise v7.4+.
|
||
|
||
`DELETE /api/licensing/token`
|
||
|
||
Removes the license stored in the Grafana database.
|
||
|
||
### Required permissions
|
||
|
||
See note in the [introduction]({{< ref "#enterprise-license-api" >}}) for an explanation.
|
||
|
||
| Action | Scope |
|
||
| ---------------- | ----- |
|
||
| licensing:delete | n/a |
|
||
|
||
### Examples
|
||
|
||
**Example request:**
|
||
|
||
```http
|
||
DELETE /api/licensing/token
|
||
Accept: application/json
|
||
Content-Type: application/json
|
||
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
|
||
|
||
{"instance": "http://play.grafana.org/"}
|
||
```
|
||
|
||
JSON Body schema:
|
||
|
||
- **instance** – Root URL for the instance for which the license should be deleted. Required.
|
||
|
||
**Example response:**
|
||
|
||
```http
|
||
HTTP/1.1 202 Accepted
|
||
Content-Type: application/json
|
||
Content-Length: 2
|
||
|
||
```
|
||
|
||
Status codes:
|
||
|
||
- **202** - Accepted, license removed or did not exist.
|
||
- **401** - Unauthorized
|
||
- **403** - Access denied
|
||
- **422** - Unprocessable entity, incorrect instance name provided.
|