Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
API de permisos de carpetas
Usa la API de carpetas para actualizar o recuperar los permisos de una carpeta.
Los permisos con folderId=-1
son los permisos predeterminados para los usuarios con las funciones de visor y editor. Los permisos se pueden configurar para un usuario, un equipo o un rol (visor o editor). Los permisos no se pueden configurar para los administradores, ya que siempre tienen acceso a todo.
Los niveles de permisos del permission
campo son los siguientes:
-
1 = Ver
-
2 = Editar
-
4 = Administrador
nota
Para usar una API de Grafana con tu espacio de trabajo de Grafana gestionado por Amazon, debes tener un token de API de Grafana válido. Lo incluyes en el Authorization
campo de la solicitud de API. Para obtener información sobre cómo crear un token para autenticar tus llamadas a la API, consultaAutenticarse con fichas.
Obtenga permisos para una carpeta
GET /api/folders/:uid/permissions
Obtiene todos los permisos existentes para la carpeta con los dadosuid
.
Ejemplo de solicitud
GET /api/folders/nErXDvCkzz/permissions HTTP/1.1 Accept: application/json Content-Type: application/json Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
Ejemplo de respuesta
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 estado:
-
200 — OK
-
401 — No autorizado
-
403 — Acceso denegado
-
404 — No se encontró la carpeta
Actualizar los permisos de una carpeta
POST /api/folders/:uid/permissions
Actualiza los permisos de una carpeta. Esta operación elimina los permisos existentes si no están incluidos en la solicitud.
Ejemplo de solicitud
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 de cuerpo de JSON:
-
elementos: los elementos de permiso que se van a añadir o actualizar. Se eliminan los elementos existentes que se omiten de la lista.
Ejemplo de respuesta
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 estado:
-
200 — Creado
-
401 — No autorizado
-
403 — Acceso denegado
-
404 — No se encontró el panel