本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 外部群組同步 API
<a name="v12-Grafana-API-ExternalGroupSynchronization"></a>

**注意**  
若要搭配 Amazon Managed Grafana 工作區使用 Grafana API，您必須擁有有效的服務帳戶字符。您可以在 API 請求的 `Authorization` 欄位中包含此項目。

## 取得外部群組
<a name="v12-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="v12-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="v12-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** — 找不到團隊或群組