Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# API für Dashboard-Berechtigungen
<a name="Grafana-API-DashboardPermissions"></a>

Verwenden Sie die API für Dashboard-Berechtigungen, um die Berechtigungen für ein Dashboard zu aktualisieren oder abzurufen. 

Berechtigungen mit `dashboardId=-1` sind die Standardberechtigungen für Benutzer mit den Rollen Viewer und Editor. Berechtigungen können für einen Benutzer, ein Team oder eine Rolle (Viewer oder Editor) festgelegt werden. Für Administratoren können keine Berechtigungen festgelegt werden — sie haben immer Zugriff auf alles.

Die Berechtigungsstufen für das `permission` Feld lauten wie folgt:
+ 1 = Ansicht
+ 2 = Bearbeiten
+ 4 = Administrator

**Anmerkung**  
Um eine Grafana-API mit Ihrem Amazon Managed Grafana-Workspace verwenden zu können, benötigen Sie ein gültiges Grafana-API-Token. Sie fügen dies in das `Authorization` Feld in der API-Anfrage ein. Informationen zum Erstellen eines Tokens zur Authentifizierung Ihrer API-Aufrufe finden Sie unter[Authentifizieren Sie sich mit Tokens](authenticating-grafana-apis.md).

## Holen Sie sich Berechtigungen für ein Dashboard
<a name="Grafana-API-DashboardPermissions-get"></a>

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

Ruft alle vorhandenen Berechtigungen für das Dashboard mit den angegebenen ab`dashboardId`.

**Beispielanforderung**

```
GET /api/dashboards/id/1/permissions HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**Beispielantwort**

```
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": ""
  }
]
```

Statuscodes:
+ **200** — Okay
+ **401** — Nicht autorisiert
+ **403** — Zugriff verweigert
+ **404** — Dashboard nicht gefunden

## Aktualisieren Sie die Berechtigungen für ein Dashboard
<a name="Grafana-API-DashboardPermissions-update"></a>

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

Aktualisiert die Berechtigungen für ein Dashboard. Durch diesen Vorgang werden vorhandene Berechtigungen entfernt, wenn sie nicht in der Anfrage enthalten sind.

**Beispielanforderung**

```
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
    }
  ]
}
```

JSON-Textschema:
+ **Elemente** — Die Berechtigungselemente, die hinzugefügt oder aktualisiert werden sollen. Bestehende Elemente, die nicht in der Liste aufgeführt sind, werden entfernt. 

**Beispielantwort**

```
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Content-Length: 35

{"message":"Dashboard permissions updated"}
```

Statuscodes:
+ **200** — Erstellt
+ **401** — Nicht autorisiert
+ **403** — Zugriff verweigert
+ **404** — Dashboard nicht gefunden