Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# API de preferencias
Use la API de preferencias para trabajar con las preferencias del usuario en el espacio de trabajo de Amazon Managed Grafana.
Claves:
+ **theme**: los valores válidos son `light`, `dark` o una cadena vacía para usar el tema predeterminado.
+ **inicio DashboardId**: el número `:id` de un panel de control favorito. El valor predeterminado es 0.
+ **timezone**: los valores válidos son `utc`, `browser` o una cadena vacía para usar el valor predeterminado.
Si se omite una clave, el valor actual se sustituye por el valor predeterminado del sistema.
**nota**
Para usar una API de Grafana con tu espacio de trabajo de Grafana gestionado por Amazon, debes tener un token de cuenta de servicio válido. Lo incluye en el campo `Authorization` de la solicitud de API.
## Obtención de las preferencias actuales del usuario
```
GET /api/user/preferences
```
**Ejemplo de solicitud**
```
GET /api/user/preferences HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```
**Ejemplo de respuesta**
```
HTTP/1.1 200
Content-Type: application/json
{"theme":"","homeDashboardId":0,"timezone":""}
```
## Actualización de las preferencias actuales del usuario
```
PUT /api/user/preferences
```
**Ejemplo de solicitud**
```
PUT /api/user/preferences HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
{
"theme": "",
"homeDashboardId":0,
"timezone":"utc"
}
```
**Ejemplo de respuesta**
```
HTTP/1.1 200
Content-Type: text/plain; charset=utf-8
{"message":"Preferences updated"}
```
## Obtención de las preferencias actuales de la organización
```
GET /api/org/preferences
```
**Ejemplo de solicitud**
```
GET /api/org/preferences HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```
**Ejemplo de respuesta**
```
HTTP/1.1 200
Content-Type: application/json
{"theme":"","homeDashboardId":0,"timezone":""}
```
## Actualización de las preferencias actuales de la organización
```
PUT /api/org/preferences
```
**Ejemplo de solicitud**
```
PUT /api/org/preferences HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
{
"theme": "",
"homeDashboardId":0,
"timezone":"utc"
}
```
**Ejemplo de respuesta**
```
HTTP/1.1 200
Content-Type: text/plain; charset=utf-8
{"message":"Preferences updated"}
```