菜单
文档breadcrumb arrow Grafana 文档breadcrumb arrow 开发者breadcrumb arrow HTTP APIbreadcrumb arrow 团队同步 HTTP API
企业版 开源

团队同步 API

团队同步仅在 Grafana Enterprise 中可用。了解更多关于Grafana Enterprise 的信息。

如果您正在运行 Grafana Enterprise，对于某些端点，您需要拥有特定权限。有关更多信息，请参阅基于角色的访问控制权限。

获取外部组

GET /api/teams/:teamId/groups

所需权限

有关解释，请参阅简介中的说明。

操作作用域
teams.permissions:readteams:*

请求示例:

http 
GET /api/teams/1/groups HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer glsa_kcVxDhZtu5ISOZIEt

响应示例:

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

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

状态码

  • 200 - 成功
  • 401 - 未授权
  • 403 - 权限不足

添加外部组

POST /api/teams/:teamId/groups

所需权限

有关解释，请参阅简介中的说明。

操作作用域
teams.permissions:writeteams:*

请求示例:

http 
POST /api/teams/1/groups HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer YWRtaW46YWRtaW4=

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

响应示例:

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

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

状态码

  • 200 - 成功
  • 400 - 此组已添加到此团队
  • 401 - 未授权
  • 403 - 权限不足
  • 404 - 未找到团队

移除外部组

DELETE /api/teams/:teamId/groups?groupId=external-group-id

所需权限

有关解释，请参阅简介中的说明。

操作作用域
teams.permissions:writeteams:*

请求示例:

http 
DELETE /api/teams/1/groups?groupId=cn%3Deditors%2Cou%3Dgroups%2Cdc%3Dgrafana%2Cdc%3Dorg HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer glsa_kcVxDhZtu5ISOZIEt

响应示例:

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

{"message":"Team Group removed"}

状态码

  • 200 - 成功
  • 401 - 未授权
  • 403 - 权限不足
  • 404 - 未找到团队/未找到组