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