API Izin Folder - Amazon Managed Grafana
Dapatkan izin untuk folderPerbarui izin untuk folder

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

API Izin Folder

Gunakan Folder API untuk memperbarui atau mengambil izin untuk folder.

Izin dengan folderId=-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 folder

GET /api/folders/:uid/permissions

Mendapat semua izin yang ada untuk folder dengan yang diberikanuid.

Permintaan contoh

GET /api/folders/nErXDvCkzz/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,
    "folderId": -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": "nErXDvCkzz",
    "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 - Folder tidak ditemukan

Perbarui izin untuk folder

POST /api/folders/:uid/permissions

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

Permintaan contoh

POST /api/folders/nErXDvCkzz/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":"Folder permissions updated","id":1,"title":"Department ABC"}

Kode Status:

  • 200 - Dibuat

  • 401 - Tidak Sah

  • 403 — Akses ditolak

  • 404 - Dashboard tidak ditemukan