Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# API für die Synchronisation externer Gruppen
<a name="Grafana-API-ExternalGroupSynchronization"></a>

**Anmerkung**  
Um eine Grafana-API mit Ihrem Amazon Managed Grafana-Workspace verwenden zu können, benötigen Sie ein gültiges Grafana-API-Token. Sie fügen dies in das `Authorization` Feld in der API-Anfrage ein. Informationen zum Erstellen eines Tokens zur Authentifizierung Ihrer API-Aufrufe finden Sie unter[Authentifizieren Sie sich mit Tokens](authenticating-grafana-apis.md).

## Holen Sie sich externe Gruppen
<a name="Grafana-API-ExternalGroupSynchronization-get"></a>

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

**Beispielanforderung**

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

**Beispielantwort**

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

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

Statuscodes:
+ **200** — In Ordnung
+ **401** — Nicht autorisiert
+ **403** — Zugriff verweigert

## Externe Gruppe hinzufügen
<a name="Grafana-API-ExternalGroupSynchronization-add"></a>

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

**Beispielanforderung**

```
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"
}
```

**Beispielantwort**

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

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

Statuscodes:
+ **200** — In Ordnung
+ **400** — Die Gruppe wurde diesem Team bereits hinzugefügt
+ **401** — Nicht autorisiert
+ **403** — Genehmigung verweigert
+ **404** — Team nicht gefunden

## Externe Gruppe entfernen
<a name="Grafana-API-ExternalGroupSynchronization-remove"></a>

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

**Beispielanforderung**

```
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]
```

**Beispielantwort**

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

{"message":"Team Group removed"}
```

Statuscodes:
+ **200** — In Ordnung
+ **401** — Nicht autorisiert
+ **403** — Genehmigung verweigert
+ **404** — Team nicht gefunden oder Gruppe nicht gefunden