Groups - Get Group Users

Retourne une liste d’utilisateurs qui ont accès à l’espace de travail spécifié.

Permissions

Cet appel d’API peut être appelé par un profil de principal de service. Pour plus d’informations, consultez : Profils de principal de service dans Power BI Embedded.

Étendue requise

Workspace.Read.All ou Workspace.ReadWrite.All

Limites

• Les autorisations utilisateur pour les espaces de travail prennent du temps pour être mis à jour et peuvent ne pas être immédiatement disponibles lors de l’utilisation d’appels d’API. Pour actualiser les autorisations utilisateur, utilisez l’appel de l’API Actualiser les autorisations utilisateur .
  
  

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/users

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/users?$top={$top}&$skip={$skip}

Paramètres URI

Réponses

Exemples

Example

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "groupUserAccessRight": "Admin",
      "identifier": "john@contoso.com",
      "principalType": "User"
    },
    {
      "displayName": "Adam Wood",
      "emailAddress": "Adam@contoso.com",
      "groupUserAccessRight": "Member",
      "identifier": "Adam@contoso.com",
      "principalType": "User"
    },
    {
      "displayName": "ContosoTestApp",
      "groupUserAccessRight": "Admin",
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App"
    }
  ]
}

Définitions

GroupUser

Un utilisateur Power BI ayant accès à l’espace de travail

GroupUserAccessRight

Droit d’accès (niveau d’autorisation) qu’un utilisateur a sur l’espace de travail

GroupUsers

Wrapper de réponse OData pour une liste d’utilisateurs Power BI ayant accès à un espace de travail

PrincipalType

Type de principal

ServicePrincipalProfile

Profil de principal du service Power BI. Uniquement pertinent pour la solution multilocataire Power BI Embedded.