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.

# API utilisateur
<a name="v12-Grafana-API-User"></a>

Utilisez l'API utilisateur pour travailler avec les utilisateurs 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 de compte de service valide. Vous l'incluez dans le `Authorization` champ de la demande d'API.

## Obtenez les équipes dont l'utilisateur est membre
<a name="v12-Grafana-API-User-teammember"></a>

```
GET /api/user/teams
```

**Exemple de demande**

```
GET /api/user/teams HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**Exemple de réponse**

```
HTTP/1.1 200
Content-Type: application/json

[
  {
    "id": 1,
    "orgId": 1,
    "name": "MyTestTeam",
    "email": "",
    "avatarUrl": "\/avatar\/3f49c15916554246daa714b9bd0ee3",
    "memberCount": 1
  }
]
```

## Obtenir la liste des instantanés
<a name="v12-Grafana-API-User-stardashboard"></a>

Met en vedette le tableau de bord donné pour l'utilisateur réel.

```
POST /api/user/stars/dashboard/:dashboardId
```

**Exemple de demande**

```
POST /api/user/stars/dashboard/1 HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**Exemple de réponse**

```
HTTP/1.1 200
Content-Type: application/json

{"message":"Dashboard starred!"}
```

## Supprimer un tableau de bord
<a name="v12-Grafana-API-User-unstardashboard"></a>

Supprime l'étoile du tableau de bord donné pour l'utilisateur réel.

```
DELETE /api/user/stars/dashboard/:dashboardId
```

**Exemple de demande**

```
DELETE /api/user/stars/dashboard/1 HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**Exemple de réponse**

```
HTTP/1.1 200
Content-Type: application/json

{"message":"Dashboard unstarred"}
```

## Obtenir les jetons d'authentification de l'utilisateur réel
<a name="v12-Grafana-API-User-authtokens"></a>

```
GET /api/user/auth-tokens
```

**Exemple de demande**

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

**Exemple de réponse**

```
HTTP/1.1 200
Content-Type: application/json

[
  {
    "id": 361,
    "isActive": true,
    "clientIp": "127.0.0.1",
    "browser": "Chrome",
    "browserVersion": "72.0",
    "os": "Linux",
    "osVersion": "",
    "device": "Other",
    "createdAt": "2019-03-05T21:22:54+01:00",
    "seenAt": "2019-03-06T19:41:06+01:00"
  },
  {
    "id": 364,
    "isActive": false,
    "clientIp": "127.0.0.1",
    "browser": "Mobile Safari",
    "browserVersion": "11.0",
    "os": "iOS",
    "osVersion": "11.0",
    "device": "iPhone",
    "createdAt": "2019-03-06T19:41:19+01:00",
    "seenAt": "2019-03-06T19:41:21+01:00"
  }
]
```

## Révoquer un jeton d'authentification de l'utilisateur réel
<a name="v12-Grafana-API-User-authtokens-revoke"></a>

```
POST /api/user/revoke-auth-token
```

Révoque le jeton d'authentification donné (appareil) pour l'utilisateur réel. L'utilisateur du jeton d'authentification (appareil) émis n'est plus connecté et doit s'authentifier à nouveau lors de sa prochaine activité.

**Exemple de demande**

```
POST /api/user/revoke-auth-token HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

{
  "authTokenId": 364
}
```

**Exemple de réponse**

```
HTTP/1.1 200
Content-Type: application/json

{
  "message": "User auth token revoked"
}
```