API de autenticação - Amazon Managed Grafana
Obtenha chaves de APICriar chave de APIExcluir chave de API

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

API de autenticação

Use a API de autenticação para trabalhar com chaves de autenticação em um espaço de trabalho Amazon Managed Grafana.

nota

Para usar uma API Grafana com seu espaço de trabalho Amazon Managed Grafana, você deve ter um token válido da API Grafana. Você inclui isso no Authorization campo na solicitação da API. Para obter informações sobre como criar um token para autenticar suas chamadas de API, consulteAutenticar com tokens.

Obtenha chaves de API

GET /api/auth/keys

Exemplo de solicitação

GET /api/auth/keys HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

Parâmetro de consulta:

  • IncludeExpired — Parâmetro booleano (opcional) que especifica se as chaves expiradas devem ser incluídas nos resultados retornados. O padrão é false.

Exemplo de resposta

HTTP/1.1 200
Content-Type: application/json

[
  {"id": 3,"name": "API","role": "Admin"},
  {"id": 1,"name": "TestAdmin","role": "Admin","expiration": "2019-06-26T10:52:03+03:00"}
]

Criar chave de API

POST /api/auth/keys

Exemplo de solicitação

POST /api/auth/keys HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

{
  "name": "mykey",
  "role": "Admin",
  "secondsToLive": 86400
}

Esquema corporal JSON:

  • nome — O nome da chave.

  • função — Define o nível de acesso (função Grafana) para a chave. Os valores válidos são Admin, Editor ou Viewer.

  • secondsToLive— Define a quantidade de tempo antes que a chave expire. Deve ser 2592000 (30 dias) ou menos.

Exemplo de resposta

{"name":"mykey","key":"eyJrIjoiWHZiSWd3NzdCYUZnNUtibE9obUpESmE3bzJYNDRIc0UiLCJuIjoibXlrZXkiLCJpZCI6MX1=","id":1}

Status de erro:

  • 400 — secondsToLive é maior que 2592000

  • 500 — A chave não pôde ser armazenada no banco de dados.

Excluir chave de API

DELETE /api/auth/keys/:id

Exemplo de solicitação

DELETE /api/auth/keys/3 HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

Exemplo de resposta

HTTP/1.1 200
Content-Type: application/json

{"message":"API key deleted"}