Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Use la API de autenticación para trabajar con las claves de autenticación en un espacio de trabajo de Amazon Managed Grafana.
nota
Para usar una API de Grafana con su espacio de trabajo de Amazon Managed Grafana, debe tener un token de API de Grafana que sea válido. Lo incluye en el campo Authorization de la solicitud de API. Para obtener información sobre cómo crear un token para autenticar sus llamadas a la API, consulte Autenticación con tokens.
Obtención de claves de la API
GET /api/auth/keysEjemplo de solicitud
GET /api/auth/keys HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbkParámetro de consulta:
-
includeExpired: (opcional) parámetro booleano que especifica si se deben incluir las claves caducadas en los resultados devueltos. El valor predeterminado es
false.
Ejemplo de respuesta
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"}
]Creación de una clave de la API
POST /api/auth/keysEjemplo de solicitud
POST /api/auth/keys HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
{
"name": "mykey",
"role": "Admin",
"secondsToLive": 86400
}Esquema de cuerpo JSON:
-
name: nombre de la clave.
-
role: establece el nivel de acceso (rol de Grafana) de la clave. Los valores válidos son
Admin,EditoroViewer. -
secondsToLive— Establece la cantidad de tiempo antes de que caduque la clave. Debe ser 2 592 000 (30 días) o menos.
Ejemplo de respuesta
{"name":"mykey","key":"eyJrIjoiWHZiSWd3NzdCYUZnNUtibE9obUpESmE3bzJYNDRIc0UiLCJuIjoibXlrZXkiLCJpZCI6MX1=","id":1}Estados de error:
-
400:
secondsToLivees superior a 2 592 000. -
500: no se pudo almacenar la clave en la base de datos.
Eliminación de una clave de la API
DELETE /api/auth/keys/:idEjemplo de solicitud
DELETE /api/auth/keys/3 HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbkEjemplo de respuesta
HTTP/1.1 200
Content-Type: application/json
{"message":"API key deleted"}