Récupère une liste de groupes appartenant au locataire spécifié et correspondant aux critères de recherche.

get

https://{tenanturl}/v2.0/Groups

Habilitation requise : readUserGroups (Lire les utilisateurs et les groupes), ou manageUserGroups (Gérer les utilisateurs et les groupes), ou manageAllUserGroups (Synchroniser les utilisateurs et les groupes), ou manageUserStandardGroups (Gérer les utilisateurs et les groupes standard), ou readGroups (Lire tous les groupes mais pas leurs membres), ou readStandardGroups (Lire les groupes standard mais pas leurs membres), ou readGroupMembers (Lire tous les groupes et leurs membres), ou readStandardGroupMembers (Lire les groupes standard et leurs membres), ou manageGroups (Gérer tous les groupes mais pas leurs membres), ou manageStandardGroups (Gérer les groupes standard mais pas leurs membres), ou manageGroupMembers (Gérer tous les groupes et leurs membres), ou manageStandardGroupMembers (Gérer les groupes standard et leurs membres).
Note : Vous n'avez besoin que d'un seul droit, mais vous pouvez en avoir plusieurs.

L'attribut members n'est pas renvoyé dans la réponse.

La recherche, le tri, la pagination et le filtrage sont pris en charge.

Query Params

filter

string

Le filtre de recherche conforme au SCIM. Par exemple, displayName eq "admin". Le filtre ne doit pas dépasser 4096 caractères.

attributes

string

La liste des attributs qui sont transmis sous forme de valeurs séparées par des virgules et qui sont utilisées lors de la transmission du résultat à l'appelant. Pour améliorer les performances, ne spécifiez dans la liste que les attributs que vous souhaitez voir renvoyés. Si aucune liste n'est fournie, l'action par défaut est de renvoyer tous les attributs.

count

string

Spécifie le nombre maximum de résultats de la requête par page. Une valeur négative est interprétée comme 0. La valeur 0 indique qu'aucun résultat n'est renvoyé, à l'exception de totalResults.

startIndex

string

Un index basé sur 1 qui indique l'index de départ utilisé lorsque le nombre de groupes est renvoyé. Une valeur inférieure à 1 est interprétée comme 1.

sortBy

string

Trier les résultats en fonction des critères spécifiés lorsque les groupes sont renvoyés.

sortOrder

string

enum

L'ordre de tri lorsque le nombre de groupes est renvoyé.

Allowed:

fullText

string

Une adresse string qui est recherchée dans les enregistrements du groupe.

Responses

Language

URL

Response

Choose an example:

application/scim+json

200L'opération a abouti.

400La demande était incorrecte.

403Interdit.

500Une erreur de serveur interne s'est produite.

529Le délai d'attente de la demande a été dépassé.