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
<a name="Grafana-API-DashboardPermissions"></a>

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

Los permisos con `dashboardId=-1` son los predeterminados para los usuarios con los roles de espectador y editor. Los permisos se pueden establecer para un usuario, un equipo o un rol (Espectador o Editor). Los permisos no se pueden configurar para los administradores, ya que siempre tienen acceso a todo.

Los niveles de permisos del campo `permission` son los siguientes:
+ 1 = Visualización
+ 2 = Edición
+ 4 = Administración

**nota**  
Para usar una API de Grafana con su espacio de trabajo de Amazon Managed Grafana, debe tener un token de API de Grafana que sea válido. Lo incluye en el campo `Authorization` de la solicitud de API. Para obtener información sobre cómo crear un token para autenticar sus llamadas a la API, consulte [Autenticación con tokens](authenticating-grafana-apis.md).

## Obtención de permisos de un panel
<a name="Grafana-API-DashboardPermissions-get"></a>

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

Obtiene todos los permisos del panel con el `dashboardId` indicado.

**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**: correcto.
+ **401**: no autorizado.
+ **403**: acceso denegado.
+ **404**: no se encontró el panel.

## Actualización de permisos de un panel
<a name="Grafana-API-DashboardPermissions-update"></a>

```
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 JSON:
+ **items**: elementos de permisos que se van a agregar 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.