View a markdown version of this page

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 tu espacio de trabajo de Grafana gestionado por Amazon, debes tener un token de cuenta de servicio válido. Lo incluye en el campo Authorization de la solicitud de API.

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.