Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

Gunakan Preferences API untuk bekerja dengan preferensi pengguna di ruang kerja Amazon Managed Grafana. 

Kunci:
+ **tema** - Nilai yang valid adalah `light``dark`,, atau string kosong untuk menggunakan tema default.
+ **homeDashboardId**— Numerik `:id` dari dasbor favorit. Default-nya adalah 0.
+ **zona waktu** - Nilai yang valid adalah `utc``browser`,, atau string kosong untuk menggunakan default.

Menghilangkan kunci menyebabkan nilai saat ini diganti dengan nilai default sistem.

**catatan**  
Untuk menggunakan Grafana API dengan ruang kerja Grafana Amazon Managed, Anda harus memiliki token Grafana API yang valid. Anda menyertakan ini di `Authorization` bidang dalam permintaan API. Untuk informasi tentang cara membuat token untuk mengautentikasi panggilan API Anda, lihat[Otentikasi dengan token](authenticating-grafana-apis.md).

## Dapatkan preferensi pengguna saat ini
<a name="Grafana-API-Preferences-get"></a>

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

**Contoh permintaan**

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

**Contoh respon**

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

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

## Perbarui preferensi pengguna saat ini
<a name="Grafana-API-Preferences-update"></a>

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

**Contoh permintaan**

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

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

**Contoh respon**

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

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

## Dapatkan preferensi organisasi saat ini
<a name="Grafana-API-Preferences-get-org"></a>

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

**Contoh permintaan**

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

**Contoh respon**

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

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

## Perbarui preferensi organisasi saat ini
<a name="Grafana-API-Playlist-Preferences-update-org"></a>

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

**Contoh permintaan**

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

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

**Contoh respon**

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

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