Obtenir les utilisateurs du rôle
Récupérer la liste des utilisateurs associés à un rôle précis. Pour obtenir des instructions dans le Dashboard, consultez View Users Assigned to Roles.
Remarque : renvoie uniquement les utilisateurs auxquels des rôles sont directement attribués. Pour les groupes attribués à ce rôle, utilisez GET /api/v2/roles/{id}/groups.
Ce point de terminaison prend en charge deux types de pagination :
- Pagination par décalage
- Pagination par checkpoint
La pagination par checkpoint doit être utilisée si vous devez récupérer plus de 1 000 membres d’organisation.
Pagination par checkpoint
Pour effectuer une recherche par checkpoint, utilisez les paramètres suivants :
from: ID facultatif à partir duquel commencer la sélection.take: Nombre total d’entrées à récupérer lors de l’utilisation du paramètrefrom. La valeur par défaut est de 50.
Remarque : la première fois que vous appelez ce point de terminaison en utilisant la pagination par checkpoint, omettez le paramètre from. S’il y a d’autres résultats, une valeur next est incluse dans la réponse. Vous pouvez l’utiliser pour les appels d’API suivants. Lorsque next n’est plus inclus dans la réponse, cela signifie qu’il ne reste plus de pages.
Autorisations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Paramètres de chemin
ID du rôle pour lequel récupérer la liste des utilisateurs associés.
Paramètres de requête
Nombre de résultats par page. La valeur par défaut est de 50.
1 <= x <= 100Index de la page de résultats à renvoyer. La première page est 0.
x >= 0Renvoyer les résultats dans un objet contenant le nombre total de résultats (true) ou directement sous forme de tableau de résultats (false, par défaut).
ID facultatif à partir duquel commencer la sélection.
Nombre de résultats par page. La valeur par défaut est 50.
1 <= x <= 100Réponse
Les utilisateurs associés au rôle ont été récupérés avec succès.