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