API per le autorizzazioni delle origini dati

Utilizza l'API Data Source Permissions per abilitare, disabilitare, elencare, aggiungere e rimuovere le autorizzazioni per le fonti di dati.

Puoi impostare le autorizzazioni per un utente o un team. Le autorizzazioni non possono essere impostate per gli amministratori, perché hanno sempre accesso a tutto.

I livelli di autorizzazione per il campo di autorizzazione sono i seguenti:

• 1 = Interrogazione

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.

Abilita le autorizzazioni per una fonte di dati

POST /api/datasources/:id/enable-permissions

Abilita le autorizzazioni per l'origine dati con l'ID specificato. Nessuno tranne gli amministratori di sistema può interrogare l'origine dati finché non sono state aggiunte le autorizzazioni per consentire a determinati utenti o team di interrogare l'origine dati.

Richiesta di esempio

POST /api/datasources/1/enable-permissions
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: 35

{"message":"Datasource permissions enabled"}

Codici di stato:

• 200 — Creato

• 400 - Le autorizzazioni non possono essere abilitate, consulta il corpo della risposta per i dettagli.

• 401 — Non autorizzato

• 403 — Accesso negato

• 404 — Fonte dati non trovata

Disattiva le autorizzazioni per un'origine dati

POST /api/datasources/:id/disable-permissions

Disattiva le autorizzazioni per l'origine dati con l'ID specificato. Tutte le autorizzazioni esistenti vengono rimosse e chiunque può interrogare l'origine dati.

Richiesta di esempio

POST /api/datasources/1/disable-permissions
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: 35

{"message":"Datasource permissions disabled"}

Codici di stato:

• 200 — Ok

• 400 — Le autorizzazioni non possono essere disabilitate, consulta il corpo della risposta per i dettagli.

• 401 — Non autorizzato

• 403 — Accesso negato

• 404 — Fonte dati non trovata

Ottieni le autorizzazioni per una fonte di dati

GET /api/datasources/:id/permissions

Ottiene tutte le autorizzazioni esistenti per l'origine dati con il dato. id

Richiesta di esempio

GET /api/datasources/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

{
  "datasourceId": 1,
  "enabled": true,
  "permissions":
  [
    {
      "id": 1,
      "datasourceId": 1,
      "userId": 1,
      "userLogin": "user",
      "userEmail": "[e-mail]",
      "userAvatarUrl": "/avatar/46d229b033af06a191ff2267bca9ae",
      "permission": 1,
      "permissionName": "Query",
      "created": "2017-06-20T02:00:00+02:00",
      "updated": "2017-06-20T02:00:00+02:00",
    },
    {
      "id": 2,
      "datasourceId": 1,
      "teamId": 1,
      "team": "A Team",
      "teamAvatarUrl": "/avatar/46d229b033af06a191ff2267bca9ae",
      "permission": 1,
      "permissionName": "Query",
      "created": "2017-06-20T02:00:00+02:00",
      "updated": "2017-06-20T02:00:00+02:00",
    }
  ]
}

Codici di stato:

• 200 — Ok

• 401 — Non autorizzato

• 403 — Accesso negato

• 404 — Fonte dati non trovata

Aggiungere l'autorizzazione per un'origine dati

POST /api/datasources/:id/permissions

Aggiunge un'autorizzazione utente per l'origine dati con quella specificataid.

Esempio di richiesta per aggiungere l'autorizzazione dell'utente

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

{
  "userId": 1,
  "permission": 1
}

Esempio di risposta per l'aggiunta di un'autorizzazione utente

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

{"message":"Datasource permission added"}

Esempio di richiesta per aggiungere l'autorizzazione del team

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

{
  "teamId": 1,
  "permission": 1
}

Esempio di risposta per l'aggiunta di un'autorizzazione al team

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

{"message":"Datasource permission added"}

Codici di stato:

• 200 — Ok

• 400 — L'autorizzazione non può essere aggiunta, vedi il corpo della risposta per i dettagli.

• 401 — Non autorizzato

• 403 — Accesso negato

• 404 — Fonte dati non trovata

Rimuovere l'autorizzazione per un'origine dati

DELETE /api/datasources/:id/permissions/:permissionId

Rimuove l'autorizzazione con il PermissionID specificato per l'origine dati con il dato dato. id

Richiesta di esempio

DELETE /api/datasources/1/permissions/2
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: 35

{"message":"Datasource permission removed"}

Codici di stato:

• 200 — Ok

• 401 — Non autorizzato

• 403 — Accesso negato

• 404 — Origine dati non trovata o autorizzazione non trovata