API de synchronisation de groupes externes - Amazon Managed Grafana
Obtenir des groupes externesAjouter un groupe externeSupprimer un groupe externe

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

API de synchronisation de groupes externes

Note

Pour utiliser une API Grafana avec votre espace de travail Amazon Managed Grafana, vous devez disposer d'un jeton d'API Grafana valide. Vous l'incluez dans le Authorization champ de la demande d'API. Pour plus d'informations sur la création d'un jeton pour authentifier vos appels d'API, consultezAuthentifiez-vous avec des jetons.

Obtenir des groupes externes

GET /api/teams/:teamId/groups

Exemple de demande

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

Exemple de réponse

HTTP/1.1 200
Content-Type: application/json

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

Codes de statut :

  • 200 — D'accord

  • 401 — Non autorisé

  • 403 — Accès refusé

Ajouter un groupe externe

POST /api/teams/:teamId/groups

Exemple de demande

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

Exemple de réponse

HTTP/1.1 200
Content-Type: application/json

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

Codes de statut :

  • 200 — D'accord

  • 400 — Le groupe est déjà ajouté à cette équipe

  • 401 — Non autorisé

  • 403 — Permission refusée

  • 404 — L'équipe est introuvable

Supprimer un groupe externe

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

Exemple de demande

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]

Exemple de réponse

HTTP/1.1 200
Content-Type: application/json

{"message":"Team Group removed"}

Codes de statut :

  • 200 — D'accord

  • 401 — Non autorisé

  • 403 — Permission refusée

  • 404 — Équipe introuvable ou groupe introuvable