Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Einstellungen-API
<a name="v12-Grafana-API-Preferences"></a>

Verwenden Sie die Preferences-API, um mit Benutzereinstellungen im Amazon Managed Grafana-Workspace zu arbeiten. 

Schlüssel:
+ **theme** — Gültige Werte sind `light``dark`, oder eine leere Zeichenfolge, um das Standarddesign zu verwenden.
+ **home DashboardId** — Die Zahl `:id` eines als Favorit markierten Dashboards. Der Standardwert ist 0.
+ **Zeitzone** — Gültige Werte sind`utc`, oder eine leere Zeichenfolge`browser`, um die Standardwerte zu verwenden.

Wenn Sie einen Schlüssel weglassen, wird der aktuelle Wert durch den Standardwert des Systems ersetzt.

**Anmerkung**  
Um eine Grafana-API mit Ihrem Amazon Managed Grafana-Workspace verwenden zu können, benötigen Sie ein gültiges Dienstkonto-Token. Sie fügen dies in das `Authorization` Feld in der API-Anfrage ein.

## Aktuelle Benutzereinstellungen abrufen
<a name="v12-Grafana-API-Preferences-get"></a>

```
GET /api/user/preferences
```

**Beispielanforderung**

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

**Beispielantwort**

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

{"theme":"","homeDashboardId":0,"timezone":""}
```

## Aktuelle Benutzereinstellungen aktualisieren
<a name="v12-Grafana-API-Preferences-update"></a>

```
PUT /api/user/preferences
```

**Beispielanforderung**

```
PUT /api/user/preferences HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

{
  "theme": "",
  "homeDashboardId":0,
  "timezone":"utc"
}
```

**Beispielantwort**

```
HTTP/1.1 200
Content-Type: text/plain; charset=utf-8

{"message":"Preferences updated"}
```

## Holen Sie sich die aktuellen Organisationseinstellungen
<a name="v12-Grafana-API-Preferences-get-org"></a>

```
GET /api/org/preferences
```

**Beispielanforderung**

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

**Beispielantwort**

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

{"theme":"","homeDashboardId":0,"timezone":""}
```

## Aktualisiere die aktuellen Einstellungen der Organisation
<a name="v12-Grafana-API-Playlist-Preferences-update-org"></a>

```
PUT /api/org/preferences
```

**Beispielanforderung**

```
PUT /api/org/preferences HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

{
  "theme": "",
  "homeDashboardId":0,
  "timezone":"utc"
}
```

**Beispielantwort**

```
HTTP/1.1 200
Content-Type: text/plain; charset=utf-8

{"message":"Preferences updated"}
```