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 de synchronisation de groupes externes
<a name="v12-Grafana-API-ExternalGroupSynchronization"></a>

**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.

## Obtenir des groupes externes
<a name="v12-Grafana-API-ExternalGroupSynchronization-get"></a>

```
GET /api/teams/:teamId/groups
```

**Exemple de demande**

```
GET /api/teams/1/groups 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

[
  {
    "orgId": 1,
    "teamId": 1,
    "groupId": "cn=editors,ou=groups,dc=grafana,dc=org"
  }
]
```

Codes de statut :
+ **200** — D'accord
+ **401** — Non autorisé
+ **403** — Accès refusé

## Ajouter un groupe externe
<a name="v12-Grafana-API-ExternalGroupSynchronization-add"></a>

```
POST /api/teams/:teamId/groups
```

**Exemple de demande**

```
POST /api/teams/1/members HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk]

{
  "groupId": "cn=editors,ou=groups,dc=grafana,dc=org"
}
```

**Exemple de réponse**

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

{"message":"Group added to Team"}
```

Codes de statut :
+ **200** — D'accord
+ **400** — Le groupe est déjà ajouté à cette équipe
+ **401** — Non autorisé
+ **403** — Permission refusée
+ **404** — L'équipe n'a pas été trouvée

## Supprimer un groupe externe
<a name="v12-Grafana-API-ExternalGroupSynchronization-remove"></a>

```
DELETE /api/teams/:teamId/groups/:groupId
```

**Exemple de demande**

```
DELETE /api/teams/1/groups/cn=editors,ou=groups,dc=grafana,dc=org 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":"Team Group removed"}
```

Codes de statut :
+ **200** — D'accord
+ **401** — Non autorisé
+ **403** — Permission refusée
+ **404** — Équipe introuvable ou groupe introuvable