本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

**注意**  
要在您的亚马逊托管 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**：找不到团队或组