API per le autorizzazioni delle cartelle

Usa l'API Folder per aggiornare o recuperare le autorizzazioni per una cartella.

Le autorizzazioni con folderId=-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.

Ottenere le autorizzazioni per una cartella

GET /api/folders/:uid/permissions

Ottiene tutte le autorizzazioni esistenti per la cartella con quelle fornite. uid

Richiesta di esempio

GET /api/folders/nErXDvCkzz/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,
    "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": ""
  }
]

Codici di stato:

• 200 — OK

• 401 — Non autorizzato

• 403 — Accesso negato

• 404 — Cartella non trovata

Aggiorna le autorizzazioni per una cartella

POST /api/folders/:uid/permissions

Aggiorna le autorizzazioni per una cartella. Questa operazione rimuove le autorizzazioni esistenti se non sono incluse nella richiesta.

Richiesta di esempio

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

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

Codici di stato:

• 200 — Creato

• 401 — Non autorizzato

• 403 — Accesso negato

• 404 — Dashboard non trovato