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

# 인증 API
<a name="v10-Grafana-API-Authentication"></a>

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

**참고**  
Amazon Managed Grafana 워크스페이스에서 Grafana API를 사용하려면 유효한 서비스 계정 토큰이 있어야 합니다. API 요청의 `Authorization` 필드에 이를 포함합니다.

## API 키 가져오기
<a name="v10-Grafana-API-Authentication-GetApiKeys"></a>

```
GET /api/auth/keys
```

**요청 예제**

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

**쿼리 파라미터:**
+ **includeExpired** - (선택 사항) 반환된 결과에 만료된 키를 포함할지 여부를 지정하는 부울 파라미터. 기본값은 `false`입니다.

**응답의 예**

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

[
  {"id": 3,"name": "API","role": "Admin"},
  {"id": 1,"name": "TestAdmin","role": "Admin","expiration": "2019-06-26T10:52:03+03:00"}
]
```

## API 키 생성
<a name="v10-Grafana-API-Authentication-CreateApiKey"></a>

```
POST /api/auth/keys
```

**요청 예제**

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

{
  "name": "mykey",
  "role": "Admin",
  "secondsToLive": 86400
}
```

JSON 본문 스키마:
+ **name** - 키의 이름.
+ **role** - 키의 액세스 수준(Grafana 역할)을 설정합니다. 유효한 값은 `Admin`, `Editor`또는 `Viewer`입니다.
+ **secondsToLive** - 키가 만료되기까지 시간을 설정합니다. 2,592,000(30일) 이하여야 합니다.

**응답의 예**

```
{"name":"mykey","key":"eyJrIjoiWHZiSWd3NzdCYUZnNUtibE9obUpESmE3bzJYNDRIc0UiLCJuIjoibXlrZXkiLCJpZCI6MX1=","id":1}
```

오류 상태:
+ **400** - `secondsToLive`는 2,592,000보다 큼
+ **500** - 키를 데이터베이스에 저장할 수 없습니다.

## API 키 삭제
<a name="v10-Grafana-API-Authentication-DeleteApiKey"></a>

```
DELETE /api/auth/keys/:id
```

**요청 예제**

```
DELETE /api/auth/keys/3 HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**응답의 예**

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

{"message":"API key deleted"}
```