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 autenticazione
<a name="v10-Grafana-API-Authentication"></a>

Usa l'API di autenticazione per lavorare con le chiavi di autenticazione in uno spazio di lavoro Amazon Managed Grafana.

**Nota**  
Per utilizzare un'API Grafana con il tuo spazio di lavoro Amazon Managed Grafana, devi disporre di un token di account di servizio valido. Lo includi nel `Authorization` campo della richiesta API.

## Ottieni le chiavi API
<a name="v10-Grafana-API-Authentication-GetApiKeys"></a>

```
GET /api/auth/keys
```

**Richiesta di esempio**

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

**Parametro di interrogazione:**
+ **includeExpired** — (Facoltativo) parametro booleano che specifica se includere chiavi scadute nei risultati restituiti. Il valore predefinito è `false`.

**Esempio di risposta**

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

## Crea una chiave API
<a name="v10-Grafana-API-Authentication-CreateApiKey"></a>

```
POST /api/auth/keys
```

**Richiesta di esempio**

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

{
  "name": "mykey",
  "role": "Admin",
  "secondsToLive": 86400
}
```

Schema del corpo JSON:
+ **name**: il nome della chiave.
+ **role** — Imposta il livello di accesso (ruolo Grafana) per la chiave. I valori validi sono `Admin`, `Editor` o `Viewer`.
+ **secondi ToLive**: imposta la quantità di tempo prima della scadenza della chiave. Deve essere pari o inferiore a 2592000 (30 giorni).

**Esempio di risposta**

```
{"name":"mykey","key":"eyJrIjoiWHZiSWd3NzdCYUZnNUtibE9obUpESmE3bzJYNDRIc0UiLCJuIjoibXlrZXkiLCJpZCI6MX1=","id":1}
```

Stati di errore:
+ **400**: `secondsToLive` è maggiore di 2592000
+ **500** — La chiave non può essere archiviata nel database.

## Elimina la chiave API
<a name="v10-Grafana-API-Authentication-DeleteApiKey"></a>

```
DELETE /api/auth/keys/:id
```

**Richiesta di esempio**

```
DELETE /api/auth/keys/3 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":"API key deleted"}
```