翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 外部グループ同期 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** — OK
+ **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** — OK
+ **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** — OK
+ **401** — 未許可
+ **403**— アクセス許可拒否
+ **404** - チームが未検出またはグループが未検出