Groups - Get Group Users

Devuelve una lista de usuarios que tienen acceso al área de trabajo especificada.

Permissions

Un perfil de entidad de servicio puede llamar a esta llamada API. Para obtener más información, consulte: Perfiles de entidad de servicio en Power BI Embedded.

Ámbito requerido

Workspace.Read.All o Workspace.ReadWrite.All

Limitaciones

• Los permisos de usuario para las áreas de trabajo tardan tiempo en actualizarse y es posible que no estén disponibles inmediatamente al usar llamadas API. Para actualizar los permisos de usuario, use la llamada API Actualizar permisos de usuario .
  
  

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}

Parámetros de identificador URI

Respuestas

Ejemplos

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

Definiciones

GroupUser

Un usuario de Power BI con acceso al área de trabajo

GroupUserAccessRight

Derecho de acceso (nivel de permiso) que un usuario tiene en el área de trabajo

GroupUsers

Contenedor de respuesta de OData para obtener una lista de usuarios de Power BI con acceso a un área de trabajo

PrincipalType

El tipo de entidad de seguridad

ServicePrincipalProfile

Un perfil de entidad de servicio de Power BI. Solo es relevante para la solución multiinquilino de Power BI Embedded.