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

# 외부 그룹 동기화 API
<a name="v10-Grafana-API-ExternalGroupSynchronization"></a>

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

## 외부 그룹 가져오기
<a name="v10-Grafana-API-ExternalGroupSynchronization-get"></a>

```
GET /api/teams/:teamId/groups
```

**요청 예제**

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

**응답의 예**

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

[
  {
    "orgId": 1,
    "teamId": 1,
    "groupId": "cn=editors,ou=groups,dc=grafana,dc=org"
  }
]
```

상태 코드:
+ **200** - 정상
+ **401** - 권한이 없음
+ **403** - 액세스 거부됨

## 외부 그룹 추가
<a name="v10-Grafana-API-ExternalGroupSynchronization-add"></a>

```
POST /api/teams/:teamId/groups
```

**요청 예제**

```
POST /api/teams/1/members HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk]

{
  "groupId": "cn=editors,ou=groups,dc=grafana,dc=org"
}
```

**응답의 예**

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

{"message":"Group added to Team"}
```

상태 코드:
+ **200** - 정상
+ **400** - 그룹이 이미 이 팀에 추가되었습니다.
+ **401** - 권한이 없음
+ **403** - 권한이 거부됨
+ **404** - 팀을 찾을 수 없음

## 외부 그룹 제거
<a name="v10-Grafana-API-ExternalGroupSynchronization-remove"></a>

```
DELETE /api/teams/:teamId/groups/:groupId
```

**요청 예제**

```
DELETE /api/teams/1/groups/cn=editors,ou=groups,dc=grafana,dc=org HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk]
```

**응답의 예**

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

{"message":"Team Group removed"}
```

상태 코드:
+ **200** - 정상
+ **401** - 권한이 없음
+ **403** - 권한이 거부됨
+ **404** - 팀 또는 그룹을 찾을 수 없음