API de permissões de fonte de dados

Use a API Data Source Permissions para ativar, desativar, listar, adicionar e remover permissões para fontes de dados.

Você pode definir permissões para um usuário ou uma equipe. As permissões não podem ser definidas para administradores, porque eles sempre têm acesso a tudo.

Os níveis de permissão para o campo de permissão são os seguintes:

• 1 = Consulta

nota

Para usar uma API Grafana com seu espaço de trabalho Amazon Managed Grafana, você deve ter um token válido da API Grafana. Você inclui isso no Authorization campo na solicitação da API. Para obter informações sobre como criar um token para autenticar suas chamadas de API, consulteAutenticação com tokens.

Habilitar permissões para uma fonte de dados

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

Ativa permissões para a fonte de dados com o ID fornecido. Ninguém, exceto os administradores da organização, pode consultar a fonte de dados até que as permissões tenham sido adicionadas para permitir que determinados usuários ou equipes consultem a fonte de dados.

Exemplo de solicitação

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

Exemplo de resposta

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

{"message":"Datasource permissions enabled"}

Códigos de status:

• 200 — Criado

• 400 — As permissões não podem ser habilitadas, consulte o corpo da resposta para obter detalhes.

• 401 — Não autorizado

• 403 — Acesso negado

• 404 — Fonte de dados não encontrada

Desativar permissões para uma fonte de dados

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

Desativa as permissões para a fonte de dados com o ID fornecido. Todas as permissões existentes são removidas e qualquer pessoa pode consultar a fonte de dados.

Exemplo de solicitação

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

{}

Exemplo de resposta

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

{"message":"Datasource permissions disabled"}

Códigos de status:

• 200 — Ok

• 400 — As permissões não podem ser desativadas, consulte o corpo da resposta para obter detalhes.

• 401 — Não autorizado

• 403 — Acesso negado

• 404 — Fonte de dados não encontrada

Obter permissões para uma fonte de dados

GET /api/datasources/:id/permissions

Obtém todas as permissões existentes para a fonte de dados com o fornecidoid.

Exemplo de solicitação

GET /api/datasources/1/permissions HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

Exemplo de resposta

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

Códigos de status:

• 200 — Ok

• 401 — Não autorizado

• 403 — Acesso negado

• 404 — Fonte de dados não encontrada

Adicionar permissão para uma fonte de dados

POST /api/datasources/:id/permissions

Adiciona uma permissão de usuário para a fonte de dados com o fornecidoid.

Exemplo de solicitação para adicionar permissão de usuário

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

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

Exemplo de resposta para adicionar uma permissão de usuário

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

{"message":"Datasource permission added"}

Exemplo de solicitação para adicionar permissão de equipe

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

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

Exemplo de resposta para adicionar uma permissão de equipe

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

{"message":"Datasource permission added"}

Códigos de status:

• 200 — Ok

• 400 - A permissão não pode ser adicionada, consulte o corpo da resposta para obter detalhes.

• 401 — Não autorizado

• 403 — Acesso negado

• 404 — Fonte de dados não encontrada

Remover permissão para uma fonte de dados

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

Remove a permissão com o PermissionID fornecido para a fonte de dados com o dado. id

Exemplo de solicitação

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

Exemplo de resposta

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

{"message":"Datasource permission removed"}

Códigos de status:

• 200 — Ok

• 401 — Não autorizado

• 403 — Acesso negado

• 404 — Fonte de dados não encontrada ou permissão não encontrada