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 delle preferenze
Usa l'API Preferences per lavorare con le preferenze degli utenti nell'area di lavoro Amazon Managed Grafana.
Chiavi:
+ **tema**: i valori validi sono `light``dark`, o una stringa vuota per utilizzare il tema predefinito.
+ **home DashboardId** — Il numero numerico `:id` di una dashboard preferita. Il valore predefinito è 0.
+ **timezone**: i valori validi sono `utc``browser`, oppure una stringa vuota per utilizzare l'impostazione predefinita.
L'omissione di una chiave fa sì che il valore corrente venga sostituito con il valore predefinito del sistema.
**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 preferenze utente correnti
```
GET /api/user/preferences
```
**Richiesta di esempio**
```
GET /api/user/preferences HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```
**Esempio di risposta**
```
HTTP/1.1 200
Content-Type: application/json
{"theme":"","homeDashboardId":0,"timezone":""}
```
## Aggiorna le preferenze utente correnti
```
PUT /api/user/preferences
```
**Richiesta di esempio**
```
PUT /api/user/preferences HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
{
"theme": "",
"homeDashboardId":0,
"timezone":"utc"
}
```
**Esempio di risposta**
```
HTTP/1.1 200
Content-Type: text/plain; charset=utf-8
{"message":"Preferences updated"}
```
## Ottieni le preferenze attuali dell'organizzazione
```
GET /api/org/preferences
```
**Richiesta di esempio**
```
GET /api/org/preferences HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```
**Esempio di risposta**
```
HTTP/1.1 200
Content-Type: application/json
{"theme":"","homeDashboardId":0,"timezone":""}
```
## Aggiorna le preferenze attuali dell'organizzazione
```
PUT /api/org/preferences
```
**Richiesta di esempio**
```
PUT /api/org/preferences HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
{
"theme": "",
"homeDashboardId":0,
"timezone":"utc"
}
```
**Esempio di risposta**
```
HTTP/1.1 200
Content-Type: text/plain; charset=utf-8
{"message":"Preferences updated"}
```