API de autenticación - Amazon Managed Grafana

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.

API de autenticación

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/keys

Ejemplo de solicitud

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

Pará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/keys

Ejemplo 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, Editor o Viewer.

  • 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: secondsToLive es 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/:id

Ejemplo de solicitud

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

Ejemplo de respuesta

HTTP/1.1 200 Content-Type: application/json {"message":"API key deleted"}