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

# 조직 API


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

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

## 현재 조직 가져오기


```
GET /api/org/
```

**요청 예제**

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

**응답의 예**

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

{
  "id":1,
  "name":"Main Org."
}
```

## 현재 조직 내 모든 사용자 가져오기


```
GET /api/org/users
```

필수 권한: `users:*` 범위의 `org.users:read` 작업

**요청 예제**

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

**응답의 예**

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

[
  {
    "orgId": 1,
    "userId": 1,
    "email": "admin@localhost",
    "avatarUrl": "/avatar/46d229b033af06a191ff2267bca9ae",
    "login": "admin",
    "role": "Admin",
    "lastSeenAt": "2019-08-09T11:02:49+02:00",
    "lastSeenAtAge": "< 1m"
  }
]
```

## 현재 조직 내 모든 사용자 가져오기(조회)


```
GET /api/org/users/lookup
```

현재 조직 내 모든 사용자를 반환합니다(단, 세부 정보는 적음). 조직 관리자 역할의 사용자, 모든 폴더의 관리자 또는 모든 팀의 관리자에 액세스할 수 있습니다. 팀원을 추가할 때와 폴더/대시보드 권한을 편집할 때 사용자 목록을 제공하기 위해 Grafana UI에서 주로 사용됩니다.

**요청 예제**

```
GET /api/org/users/lookup HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**응답의 예**

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

[
  {
    "userId": 1,
    "login": "admin",
    "avatarUrl": "/avatar/46d229b033af06a191ff2267bca9ae"
  }
]
```

## 지정된 사용자 업데이트


```
PATCH /api/org/users/:userId
```

필수 권한: `users:*` 범위의 `org.users.role:update` 작업

**요청 예제**

```
PATCH /api/org/users/1 HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

{
  "role": "Viewer",
}
```

**응답의 예**

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

{"message":"Organization user updated"}
```

## 현재 조직에서 사용자를 삭제합니다.


```
DELETE /api/org/users/:userId
```

필수 권한: `users:*` 범위의 `org.users:remove` 작업

**요청 예제**

```
DELETE /api/org/users/1 HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**응답의 예**

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

{"message":"User removed from organization"}
```

## 현재 조직 업데이트


```
PUT /api/org
```

**요청 예제**

```
PUT /api/org HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

{
  "name":"Main Org."
}
```

**응답의 예**

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

{"message":"Organization updated"}
```

## 현재 조직에 사용자 추가


```
POST /api/org/users
```

필수 권한: `users:*` 범위의 `org.users:add` 작업

**요청 예제**

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

{
  "role": "Admin",
  "loginOrEmail": "admin"
}
```

**응답의 예**

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

{"message":"User added to organization","userId":1}
```