API de sincronización de grupos externos - Amazon Managed Grafana

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

API de sincronización de grupos externos

nota

Para usar una API de Grafana con su espacio de trabajo de Amazon Managed Grafana, debe tener un token de API de Grafana que sea válido. Lo incluye en el campo Authorization de la solicitud de API. Para obtener información sobre cómo crear un token para autenticar sus llamadas a la API, consulte Autenticación con tokens.

Obtención de grupos externos

GET /api/teams/:teamId/groups

Ejemplo de solicitud

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

Ejemplo de respuesta

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

Códigos de estado:

  • 200: correcto.

  • 401: no autorizado.

  • 403: acceso denegado.

Cómo agregar un grupo externo

POST /api/teams/:teamId/groups

Ejemplo de solicitud

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

Ejemplo de respuesta

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

Códigos de estado:

  • 200: correcto.

  • 400: el grupo ya está agregado a este equipo.

  • 401: no autorizado.

  • 403: permiso denegado.

  • 404: no se encontró el equipo.

Eliminación de un grupo externo

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

Ejemplo de solicitud

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]

Ejemplo de respuesta

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

Códigos de estado:

  • 200: correcto.

  • 401: no autorizado.

  • 403: permiso denegado.

  • 404: no se encontró el equipo o el grupo.