Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
API per le autorizzazioni del pannello di controllo
Utilizza l'API Dashboard Permissions per aggiornare o recuperare le autorizzazioni per una dashboard.
Le autorizzazioni con dashboardId=-1
sono le autorizzazioni predefinite per gli utenti con i ruoli Viewer ed Editor. Le autorizzazioni possono essere impostate per un utente, un team o un ruolo (Viewer o Editor). Le autorizzazioni non possono essere impostate per gli amministratori: hanno sempre accesso a tutto.
I livelli di autorizzazione per il permission
campo sono i seguenti:
-
1 = Visualizza
-
2 = Modifica
-
4 = Amministratore
Nota
Per utilizzare un'API Grafana con il tuo spazio di lavoro Amazon Managed Grafana, devi disporre di un token API Grafana valido. Lo includi nel Authorization
campo della richiesta API. Per informazioni su come creare un token per autenticare le chiamate API, consultaAutenticazione con token.
Ottieni le autorizzazioni per una dashboard
GET /api/dashboards/id/:dashboardId/permissions
Ottiene tutte le autorizzazioni esistenti per la dashboard con le autorizzazioni fornite. dashboardId
Richiesta di esempio
GET /api/dashboards/id/1/permissions HTTP/1.1 Accept: application/json Content-Type: application/json Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
Example response
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": "" } ]
Codici di stato:
-
200 — OK
-
401 — Non autorizzato
-
403 — Accesso negato
-
404 — Dashboard non trovato
Aggiorna le autorizzazioni per un pannello di controllo
POST /api/dashboards/id/:dashboardId/permissions
Aggiorna le autorizzazioni per un pannello di controllo. Questa operazione rimuove le autorizzazioni esistenti se non sono incluse nella richiesta.
Richiesta di esempio
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 } ] }
Schema del corpo JSON:
-
items: gli elementi di autorizzazione da aggiungere o aggiornare. Gli elementi esistenti che vengono omessi dall'elenco vengono rimossi.
Example response
HTTP/1.1 200 OK Content-Type: application/json; charset=UTF-8 Content-Length: 35 {"message":"Dashboard permissions updated"}
Codici di stato:
-
200 — Creato
-
401 — Non autorizzato
-
403 — Accesso negato
-
404 — Dashboard non trovato