View a markdown version of this page

API de sincronização de grupos externos - Amazon Managed Grafana

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

API de sincronização de grupos externos

nota

Para usar uma API do Grafana com seu espaço de trabalho Amazon Managed Grafana, você deve ter um token de conta de serviço válido. Você inclui isso no campo Authorization na solicitação da API.

Obter grupos externos

GET /api/teams/:teamId/groups

Exemplo de solicitação

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

Exemplo de resposta

HTTP/1.1 200 Content-Type: application/json [ { "orgId": 1, "teamId": 1, "groupId": "cn=editors,ou=groups,dc=grafana,dc=org" } ]

Códigos de status:

  • 200: Ok

  • 401: não autorizado

  • 403: acesso negado

Adicionar grupo externo

POST /api/teams/:teamId/groups

Exemplo de solicitação

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" }

Exemplo de resposta

HTTP/1.1 200 Content-Type: application/json {"message":"Group added to Team"}

Códigos de status:

  • 200: Ok

  • 400: o grupo já foi adicionado a esta equipe

  • 401: não autorizado

  • 403: permissão negada

  • 404: equipe não encontrada

Remover grupo externo

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

Exemplo de solicitação

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]

Exemplo de resposta

HTTP/1.1 200 Content-Type: application/json {"message":"Team Group removed"}

Códigos de status:

  • 200: Ok

  • 401: não autorizado

  • 403: permissão negada

  • 404: equipe ou grupo não encontrado