API de permisos del panel - Amazon Managed Grafana
Obtenga permisos para un panelActualizar los permisos de un panel

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 del panel

Usa la API de permisos del panel de control para actualizar o recuperar los permisos de un panel de control.

Los permisos con dashboardId=-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 un panel

GET /api/dashboards/id/:dashboardId/permissions

Obtiene todos los permisos existentes para el panel de control con los proporcionadosdashboardId.

Ejemplo de solicitud

GET /api/dashboards/id/1/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,
    "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": "Viewer",
    "permission": 1,
    "permissionName": "View",
    "uid": "",
    "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ó el panel

Actualizar los permisos de un panel

POST /api/dashboards/id/:dashboardId/permissions

Actualiza los permisos de un panel. Esta operación elimina los permisos existentes si no están incluidos en la solicitud.

Ejemplo de solicitud

POST /api/dashboards/id/1/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":"Dashboard permissions updated"}

Códigos de estado:

  • 200 — Creado

  • 401 — No autorizado

  • 403 — Acceso denegado

  • 404 — No se encontró el panel