Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# API di sincronizzazione di gruppi esterni
<a name="Grafana-API-ExternalGroupSynchronization"></a>

**Nota**  
Per utilizzare un'API Grafana con il tuo spazio di lavoro Amazon Managed Grafana, devi disporre di un token API Grafana valido. Lo includi nel `Authorization` campo della richiesta API. Per informazioni su come creare un token per autenticare le chiamate API, consulta[Autenticazione con token](authenticating-grafana-apis.md).

## Ottieni gruppi esterni
<a name="Grafana-API-ExternalGroupSynchronization-get"></a>

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

**Richiesta di esempio**

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

**Esempio di risposta**

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

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

Codici di stato:
+ **200** — Ok
+ **401** — Non autorizzato
+ **403 — Accesso** negato

## Aggiungi gruppo esterno
<a name="Grafana-API-ExternalGroupSynchronization-add"></a>

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

**Richiesta di esempio**

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

**Esempio di risposta**

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

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

Codici di stato:
+ **200** — Ok
+ **400** — Il gruppo è già stato aggiunto a questa squadra
+ **401** — Non autorizzato
+ **403 - Autorizzazione** negata
+ **404** — Squadra non trovata

## Rimuovi gruppo esterno
<a name="Grafana-API-ExternalGroupSynchronization-remove"></a>

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

**Richiesta di esempio**

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

**Esempio di risposta**

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

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

Codici di stato:
+ **200** — Ok
+ **401** — Non autorizzato
+ **403 - Autorizzazione** negata
+ **404** - Squadra non trovata o gruppo non trovato