API Otentikasi

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

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, lihatOtentikasi dengan token.

Dapatkan kunci API

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

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.

• secondsToLive— Menetapkan 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

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"}