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

# API Otentikasi
<a name="v10-Grafana-API-Authentication"></a>

Gunakan API Otentikasi untuk bekerja dengan kunci autentikasi di ruang kerja Grafana Terkelola Amazon.

**catatan**  
Untuk menggunakan API Grafana dengan ruang kerja Grafana yang Dikelola Amazon, Anda harus memiliki token akun layanan yang valid. Anda menyertakan ini di `Authorization` bidang dalam permintaan API.

## Dapatkan kunci API
<a name="v10-Grafana-API-Authentication-GetApiKeys"></a>

```
GET /api/auth/keys
```

**Permintaan contoh**

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

**Parameter kueri:**
+ **IncludeExpired** - (Opsional) parameter Boolean yang menentukan apakah akan menyertakan kunci kedaluwarsa dalam hasil yang dikembalikan. Nilai default-nya `false`.

**Contoh respon**

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

[
  {"id": 3,"name": "API","role": "Admin"},
  {"id": 1,"name": "TestAdmin","role": "Admin","expiration": "2019-06-26T10:52:03+03:00"}
]
```

## Buat kunci API
<a name="v10-Grafana-API-Authentication-CreateApiKey"></a>

```
POST /api/auth/keys
```

**Permintaan contoh**

```
POST /api/auth/keys HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

{
  "name": "mykey",
  "role": "Admin",
  "secondsToLive": 86400
}
```

Skema tubuh JSON:
+ **Nama** — Nama untuk kunci.
+ **peran** — Menetapkan tingkat akses (peran Grafana) untuk kunci. Nilai yang valid adalah `Admin`, `Editor`, atau `Viewer`.
+ **detik ToLive** - Mengatur jumlah waktu sebelum kunci kedaluwarsa. Itu harus 2592000 (30 hari) atau kurang.

**Contoh respon**

```
{"name":"mykey","key":"eyJrIjoiWHZiSWd3NzdCYUZnNUtibE9obUpESmE3bzJYNDRIc0UiLCJuIjoibXlrZXkiLCJpZCI6MX1=","id":1}
```

Status kesalahan:
+ **400** - `secondsToLive` lebih besar dari 2592000
+ **500** — Kunci tidak dapat disimpan dalam database.

## Hapus kunci API
<a name="v10-Grafana-API-Authentication-DeleteApiKey"></a>

```
DELETE /api/auth/keys/:id
```

**Permintaan contoh**

```
DELETE /api/auth/keys/3 HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**Contoh respon**

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

{"message":"API key deleted"}
```