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 com folderId=-1
são as permissões padrão para usuários com as funções de 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 o permission
campo são os seguintes:
-
1 = Visualizar
-
2 = Editar
-
4 = Administrador
nota
Para usar uma API do Grafana com seu espaço de trabalho do Amazon Managed Grafana, você deve ter uma chave de API do Grafana válida. Você inclui essa chave no Authorization
campo na solicitação da API. Para obter informações sobre como criar uma chave da API Grafana, consulte. Usando as APIs HTTP da 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": "" } ]
Códigos de status:
-
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"}
Códigos de status:
-
200 — Criado
-
401 — Não autorizado
-
403 — Acesso negado
-
404 — Painel de controle não encontrado