API Izin Dasbor

Gunakan API Izin Dasbor untuk memperbarui atau mengambil izin untuk dasbor.

Izin dengan dashboardId=-1 adalah izin default untuk pengguna dengan peran Viewer dan Editor. Izin dapat diatur untuk pengguna, tim, atau peran (Penampil atau Editor). Izin tidak dapat diatur untuk Admin - mereka selalu memiliki akses ke semuanya.

Tingkat izin untuk permission bidang tersebut adalah sebagai berikut:

• 1 = Lihat

• 2 = Sunting

• 4 = Admin

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 izin untuk dasbor

GET /api/dashboards/id/:dashboardId/permissions

Mendapat semua izin yang ada untuk dasbor dengan yang diberikandashboardId.

Permintaan contoh

GET /api/dashboards/id/1/permissions HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

Contoh respon

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Content-Length: 551

[
  {
    "id": 1,
    "dashboardId": -1,
    "created": "2017-06-20T02:00:00+02:00",
    "updated": "2017-06-20T02:00:00+02:00",
    "userId": 0,
    "userLogin": "",
    "userEmail": "",
    "teamId": 0,
    "team": "",
    "role": "Viewer",
    "permission": 1,
    "permissionName": "View",
    "uid": "",
    "title": "",
    "slug": "",
    "isFolder": false,
    "url": ""
  },
  {
    "id": 2,
    "dashboardId": -1,
    "created": "2017-06-20T02:00:00+02:00",
    "updated": "2017-06-20T02:00:00+02:00",
    "userId": 0,
    "userLogin": "",
    "userEmail": "",
    "teamId": 0,
    "team": "",
    "role": "Editor",
    "permission": 2,
    "permissionName": "Edit",
    "uid": "",
    "title": "",
    "slug": "",
    "isFolder": false,
    "url": ""
  }
]

Kode Status:

• 200 — OK

• 401 - Tidak Sah

• 403 — Akses ditolak

• 404 - Dashboard tidak ditemukan

Perbarui izin untuk dasbor

POST /api/dashboards/id/:dashboardId/permissions

Memperbarui izin untuk dasbor. Operasi ini menghapus izin yang ada jika tidak disertakan dalam permintaan.

Permintaan contoh

POST /api/dashboards/id/1/permissions
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

{
  "items": [
    {
      "role": "Viewer",
      "permission": 1
    },
    {
      "role": "Editor",
      "permission": 2
    },
    {
      "teamId": 1,
      "permission": 1
    },
    {
      "userId": 11,
      "permission": 4
    }
  ]
}

Skema tubuh JSON:

• item — Item izin untuk menambah atau memperbarui. Item yang ada yang dihilangkan dari daftar akan dihapus.

Contoh respon

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Content-Length: 35

{"message":"Dashboard permissions updated"}

Kode Status:

• 200 - Dibuat

• 401 - Tidak Sah

• 403 — Akses ditolak

• 404 - Dashboard tidak ditemukan