Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Utilisez l'API d'authentification pour utiliser les clés d'authentification dans un espace de travail Amazon Managed Grafana.
Note
Pour utiliser une API Grafana avec votre espace de travail Amazon Managed Grafana, vous devez disposer d'un jeton d'API Grafana valide. Vous l'incluez dans le Authorization champ de la demande d'API. Pour plus d'informations sur la création d'un jeton pour authentifier vos appels d'API, consultezAuthentifiez-vous avec des jetons.
Obtenir des clés d'API
GET /api/auth/keysExemple de demande
GET /api/auth/keys HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbkParamètre de requête :
-
IncludeExpired — Paramètre booléen (facultatif) qui indique s'il faut inclure les clés expirées dans les résultats renvoyés. L’argument par défaut est
false.
Exemple de réponse
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"}
]Créer une clé d'API
POST /api/auth/keysExemple de demande
POST /api/auth/keys HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
{
"name": "mykey",
"role": "Admin",
"secondsToLive": 86400
}Schéma de corps JSON :
-
name — Le nom de la clé.
-
role — Définit le niveau d'accès (rôle Grafana) pour la clé. Les valeurs valides sont
Admin,EditorouViewer. -
secondsToLive— Définit le délai avant l'expiration de la clé. Il doit être inférieur ou égal à 2592000 (30 jours).
Exemple de réponse
{"name":"mykey","key":"eyJrIjoiWHZiSWd3NzdCYUZnNUtibE9obUpESmE3bzJYNDRIc0UiLCJuIjoibXlrZXkiLCJpZCI6MX1=","id":1}Statuts d'erreur :
-
400 —
secondsToLiveest supérieur à 2592000 -
500 — Impossible de stocker la clé dans la base de données.
Supprimer la clé d'API
DELETE /api/auth/keys/:idExemple de demande
DELETE /api/auth/keys/3 HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbkExemple de réponse
HTTP/1.1 200
Content-Type: application/json
{"message":"API key deleted"}