As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
API de permissões de pasta
Use a API de pastas para atualizar ou recuperar as permissões de uma pasta.
As permissões comfolderId=-1
são as permissões padrão para usuários com as funções Visualizador e Editor. As permissões podem ser definidas para um usuário, uma equipe ou uma função (Visualizador ou Editor). As permissões não podem ser definidas para administradores - eles sempre têm acesso a tudo.
Os níveis de permissão para opermission
campo são os seguintes:
-
1 = Exibição
-
2 = Editar
-
4 = Admin
nota
Para usar uma API Grafana com seu espaço de trabalho Amazon Managed Grafana, você deve ter uma chave de API Grafana válida. Você inclui essa chave noAuthorization
campo da solicitação da API. Para obter informações sobre como criar uma chave de API do Grafana, consulteUsando APIs HTTP do Grafana.
Obter permissões para uma pasta
GET /api/folders/:uid/permissions
Obtém todas as permissões existentes para a pasta com o dadouid
.
Exemplo de solicitação
GET /api/folders/nErXDvCkzz/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 [ { "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": "" } ]
HTTP Status Codes
-
200 — OK
-
401 — Não autorizado
-
403 — Acesso negado
-
404 — Pasta não encontrada
Atualizar permissões para uma pasta
POST /api/folders/:uid/permissions
Atualiza as permissões de uma pasta. Essa operação remove as permissões existentes se elas não estiverem incluídas na solicitação.
Exemplo de solicitação
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 } ] }
Esquema corporal JSON:
-
itens — Os itens de permissão para adicionar ou atualizar. Os itens existentes que são omitidos da lista são removidos.
Exemplo de resposta
HTTP/1.1 200 OK Content-Type: application/json; charset=UTF-8 Content-Length: 35 {"message":"Folder permissions updated","id":1,"title":"Department ABC"}
HTTP Status Codes
-
200 — Criado
-
401 — Não autorizado
-
403 — Acesso negado
-
404 — Painel de controle não encontrado