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.

# Benutzer-API
<a name="v12-Grafana-API-User"></a>

Verwenden Sie die Benutzer-API, um mit Benutzern in einem Amazon Managed Grafana-Arbeitsbereich zu arbeiten. 

**Anmerkung**  
Um eine Grafana-API mit Ihrem Amazon Managed Grafana-Workspace verwenden zu können, benötigen Sie ein gültiges Dienstkonto-Token. Sie fügen dies in das `Authorization` Feld in der API-Anfrage ein.

## Holen Sie sich Teams, in denen der Benutzer Mitglied ist
<a name="v12-Grafana-API-User-teammember"></a>

```
GET /api/user/teams
```

**Beispielanforderung**

```
GET /api/user/teams HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**Beispielantwort**

```
HTTP/1.1 200
Content-Type: application/json

[
  {
    "id": 1,
    "orgId": 1,
    "name": "MyTestTeam",
    "email": "",
    "avatarUrl": "\/avatar\/3f49c15916554246daa714b9bd0ee3",
    "memberCount": 1
  }
]
```

## Liste der Schnappschüsse abrufen
<a name="v12-Grafana-API-User-stardashboard"></a>

Markiert das angegebene Dashboard für den aktuellen Benutzer.

```
POST /api/user/stars/dashboard/:dashboardId
```

**Beispielanforderung**

```
POST /api/user/stars/dashboard/1 HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**Beispielantwort**

```
HTTP/1.1 200
Content-Type: application/json

{"message":"Dashboard starred!"}
```

## Entmarkierung eines Dashboards
<a name="v12-Grafana-API-User-unstardashboard"></a>

Löscht das Sternchen des angegebenen Dashboards für den aktuellen Benutzer.

```
DELETE /api/user/stars/dashboard/:dashboardId
```

**Beispielanforderung**

```
DELETE /api/user/stars/dashboard/1 HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**Beispielantwort**

```
HTTP/1.1 200
Content-Type: application/json

{"message":"Dashboard unstarred"}
```

## Ruft Authentifizierungstoken des tatsächlichen Benutzers ab
<a name="v12-Grafana-API-User-authtokens"></a>

```
GET /api/user/auth-tokens
```

**Beispielanforderung**

```
GET /api/user/auth-tokens HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**Beispielantwort**

```
HTTP/1.1 200
Content-Type: application/json

[
  {
    "id": 361,
    "isActive": true,
    "clientIp": "127.0.0.1",
    "browser": "Chrome",
    "browserVersion": "72.0",
    "os": "Linux",
    "osVersion": "",
    "device": "Other",
    "createdAt": "2019-03-05T21:22:54+01:00",
    "seenAt": "2019-03-06T19:41:06+01:00"
  },
  {
    "id": 364,
    "isActive": false,
    "clientIp": "127.0.0.1",
    "browser": "Mobile Safari",
    "browserVersion": "11.0",
    "os": "iOS",
    "osVersion": "11.0",
    "device": "iPhone",
    "createdAt": "2019-03-06T19:41:19+01:00",
    "seenAt": "2019-03-06T19:41:21+01:00"
  }
]
```

## Widerrufen Sie ein Authentifizierungstoken des tatsächlichen Benutzers
<a name="v12-Grafana-API-User-authtokens-revoke"></a>

```
POST /api/user/revoke-auth-token
```

Widerruft das angegebene Authentifizierungstoken (Gerät) für den tatsächlichen Benutzer. Benutzer des ausgestellten Authentifizierungstokens (Geräts) sind nicht mehr angemeldet und müssen sich bei ihrer nächsten Aktivität erneut authentifizieren.

**Beispielanforderung**

```
POST /api/user/revoke-auth-token HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

{
  "authTokenId": 364
}
```

**Beispielantwort**

```
HTTP/1.1 200
Content-Type: application/json

{
  "message": "User auth token revoked"
}
```