As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# API de preferências
Use a API de preferências para trabalhar com as preferências do usuário no espaço de trabalho do Amazon Managed Grafana.
Chaves:
+ **tema**: os valores válidos são `light`, `dark` ou uma string vazia para usar o tema padrão.
+ **home DashboardId** — O número `:id` de um painel favorito. O padrão é 0.
+ **fuso horário**: os valores válidos são `utc`, `browser` ou uma string vazia para usar o padrão.
A omissão de uma chave faz com que o valor atual seja substituído pelo valor padrão do sistema.
**nota**
Para usar uma API do Grafana com seu espaço de trabalho Amazon Managed Grafana, você deve ter um token de conta de serviço válido. Você inclui isso no campo `Authorization` na solicitação da API.
## Obter as preferências atuais do usuário
```
GET /api/user/preferences
```
**Exemplo de solicitação**
```
GET /api/user/preferences HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```
**Exemplo de resposta**
```
HTTP/1.1 200
Content-Type: application/json
{"theme":"","homeDashboardId":0,"timezone":""}
```
## Atualizar as preferências atuais do usuário
```
PUT /api/user/preferences
```
**Exemplo de solicitação**
```
PUT /api/user/preferences HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
{
"theme": "",
"homeDashboardId":0,
"timezone":"utc"
}
```
**Exemplo de resposta**
```
HTTP/1.1 200
Content-Type: text/plain; charset=utf-8
{"message":"Preferences updated"}
```
## Obter as preferências atuais da organização
```
GET /api/org/preferences
```
**Exemplo de solicitação**
```
GET /api/org/preferences HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```
**Exemplo de resposta**
```
HTTP/1.1 200
Content-Type: application/json
{"theme":"","homeDashboardId":0,"timezone":""}
```
## Atualizar as preferências atuais da organização
```
PUT /api/org/preferences
```
**Exemplo de solicitação**
```
PUT /api/org/preferences HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
{
"theme": "",
"homeDashboardId":0,
"timezone":"utc"
}
```
**Exemplo de resposta**
```
HTTP/1.1 200
Content-Type: text/plain; charset=utf-8
{"message":"Preferences updated"}
```