기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 사용자 API
<a name="Grafana-API-User"></a>

사용자 API를 사용하여 Amazon Managed Grafana 워크스페이스에서 사용자에 대한 작업을 수행합니다.

**참고**  
Amazon Managed Grafana 워크스페이스에서 Grafana API를 사용하려면 유효한 Grafana API 토큰이 있어야 합니다. API 요청의 `Authorization` 필드에 이를 포함합니다. API 직접 호출을 인증하기 위해 토큰을 생성하는 방법에 대한 자세한 내용은 [토큰으로 인증](authenticating-grafana-apis.md) 섹션을 참조하세요.

## 사용자가 멤버인 팀 가져오기
<a name="Grafana-API-User-teammember"></a>

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

**요청 예제**

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

**응답의 예**

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

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

## 스냅샷 목록 가져오기
<a name="Grafana-API-User-stardashboard"></a>

실제 사용자에 대해 지정된 대시보드에 별표를 추가합니다.

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

**요청 예제**

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

**응답의 예**

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

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

## 대시보드 별표 취소
<a name="Grafana-API-User-unstardashboard"></a>

실제 사용자에 대해 지정된 대시보드의 별표를 삭제합니다.

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

**요청 예제**

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

**응답의 예**

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

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

## 실제 사용자의 인증 토큰 가져오기
<a name="Grafana-API-User-authtokens"></a>

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

**요청 예제**

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

**응답의 예**

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

## 실제 사용자의 인증 토큰 취소
<a name="Grafana-API-User-authtokens-revoke"></a>

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

실제 사용자에 대해 지정된 인증 토큰(디바이스)을 취소합니다. 발급된 인증 토큰(디바이스)의 사용자는 더 이상 로그인되지 않으며 다음 활동에서 다시 인증해야 합니다.

**요청 예제**

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

{
  "authTokenId": 364
}
```

**응답의 예**

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

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