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 Datenquellenberechtigungen
Verwenden Sie die API für Datenquellenberechtigungen, um Berechtigungen für Datenquellen zu aktivieren, zu deaktivieren, aufzulisten, hinzuzufügen und zu entfernen.
Sie können Berechtigungen für einen Benutzer oder ein Team festlegen. Für Administratoren können keine Berechtigungen festgelegt werden, da sie immer Zugriff auf alles haben.
Die Berechtigungsstufen für das Berechtigungsfeld lauten wie folgt:
-
1 = Abfrage
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 unterAuthentifizieren Sie sich mit Tokens.
Aktivieren Sie Berechtigungen für eine Datenquelle
POST /api/datasources/:id/enable-permissions
Aktiviert Berechtigungen für die Datenquelle mit der angegebenen ID. Niemand außer Organisationsadministratoren kann die Datenquelle abfragen, bis Berechtigungen hinzugefügt wurden, die es bestimmten Benutzern oder Teams ermöglichen, die Datenquelle abzufragen.
Beispielanforderung
POST /api/datasources/1/enable-permissions 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: 35 {"message":"Datasource permissions enabled"}
Statuscodes:
-
200 — Erstellt
-
400 — Berechtigungen können nicht aktiviert werden. Einzelheiten finden Sie im Antworttext.
-
401 — Nicht autorisiert
-
403 — Zugriff verweigert
-
404 — Datenquelle nicht gefunden
Deaktivieren Sie die Berechtigungen für eine Datenquelle
POST /api/datasources/:id/disable-permissions
Deaktiviert die Berechtigungen für die Datenquelle mit der angegebenen ID. Alle vorhandenen Berechtigungen werden entfernt und jeder kann die Datenquelle abfragen.
Beispielanforderung
POST /api/datasources/1/disable-permissions 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: 35 {"message":"Datasource permissions disabled"}
Statuscodes:
-
200 — In Ordnung
-
400 — Berechtigungen können nicht deaktiviert werden. Einzelheiten finden Sie im Antworttext.
-
401 — Nicht autorisiert
-
403 — Zugriff verweigert
-
404 — Datenquelle nicht gefunden
Holen Sie sich Berechtigungen für eine Datenquelle
GET /api/datasources/:id/permissions
Ruft alle vorhandenen Berechtigungen für die Datenquelle mit den angegebenen Werten abid
.
Beispielanforderung
GET /api/datasources/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 { "datasourceId": 1, "enabled": true, "permissions": [ { "id": 1, "datasourceId": 1, "userId": 1, "userLogin": "user", "userEmail": "user@test.com", "userAvatarUrl": "/avatar/46d229b033af06a191ff2267bca9ae", "permission": 1, "permissionName": "Query", "created": "2017-06-20T02:00:00+02:00", "updated": "2017-06-20T02:00:00+02:00", }, { "id": 2, "datasourceId": 1, "teamId": 1, "team": "A Team", "teamAvatarUrl": "/avatar/46d229b033af06a191ff2267bca9ae", "permission": 1, "permissionName": "Query", "created": "2017-06-20T02:00:00+02:00", "updated": "2017-06-20T02:00:00+02:00", } ] }
Statuscodes:
-
200 — In Ordnung
-
401 — Nicht autorisiert
-
403 — Zugriff verweigert
-
404 — Datenquelle nicht gefunden
Fügen Sie eine Berechtigung für eine Datenquelle hinzu
POST /api/datasources/:id/permissions
Fügt eine Benutzerberechtigung für die angegebene Datenquelle hinzuid
.
Beispiel für eine Anfrage zum Hinzufügen von Benutzerberechtigungen
POST /api/datasources/1/permissions Accept: application/json Content-Type: application/json Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk { "userId": 1, "permission": 1 }
Beispielantwort für das Hinzufügen einer Benutzerberechtigung
HTTP/1.1 200 OK Content-Type: application/json; charset=UTF-8 Content-Length: 35 {"message":"Datasource permission added"}
Beispiel für eine Anfrage zum Hinzufügen einer Teamberechtigung
POST /api/datasources/1/permissions Accept: application/json Content-Type: application/json Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk { "teamId": 1, "permission": 1 }
Beispielantwort für das Hinzufügen einer Teamberechtigung
HTTP/1.1 200 OK Content-Type: application/json; charset=UTF-8 Content-Length: 35 {"message":"Datasource permission added"}
Statuscodes:
-
200 — In Ordnung
-
400 — Die Berechtigung kann nicht hinzugefügt werden. Weitere Informationen finden Sie im Antworttext.
-
401 — Nicht autorisiert
-
403 — Zugriff verweigert
-
404 — Datenquelle nicht gefunden
Entfernen Sie die Berechtigung für eine Datenquelle
DELETE /api/datasources/:id/permissions/:permissionId
Entfernt die Berechtigung mit der angegebenen PermissionId für die Datenquelle mit der angegebenen. id
Beispielanforderung
DELETE /api/datasources/1/permissions/2 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: 35 {"message":"Datasource permission removed"}
Statuscodes:
-
200 — In Ordnung
-
401 — Nicht autorisiert
-
403 — Zugriff verweigert
-
404 — Die Datenquelle wurde nicht gefunden oder die Berechtigung wurde nicht gefunden