Compartir a través de


Admin - Groups GetGroupUsersAsAdmin

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

Permisos

  • El usuario debe ser un administrador de Fabric o autenticarse mediante una entidad de servicio.
  • Se admiten permisos delegados.

Cuando se ejecuta en la autenticación prinicipal del servicio, una aplicación no debe tener las premisiones necesarias de consentimiento del administrador para Power BI establecidas en él en Azure Portal.

Ámbito requerido

Tenant.Read.All o Tenant.ReadWrite.All

Solo es relevante al autenticarse a través de un token de acceso de administrador delegado estándar. No debe estar presente cuando se usa la autenticación a través de una entidad de servicio.

Limitaciones

Máximo de 200 solicitudes por hora.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
groupId
path True

string (uuid)

Identificador del área de trabajo

Respuestas

Nombre Tipo Description
200 OK

GroupUsers

De acuerdo

Ejemplos

Example

Solicitud de ejemplo

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

Respuesta de muestra

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "groupUserAccessRight": "Admin",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    },
    {
      "displayName": "Adam Wood",
      "emailAddress": "Adam@contoso.com",
      "groupUserAccessRight": "Member",
      "identifier": "Adam@contoso.com",
      "graphId": "785e192c-0f1f-41ca-ae7a-a85da28e565a",
      "principalType": "User"
    },
    {
      "displayName": "ContosoTestApp",
      "groupUserAccessRight": "Admin",
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "graphId": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App"
    }
  ]
}

Definiciones

Nombre Description
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 solución multiinquilino de Power BI Embedded.

GroupUser

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

Nombre Tipo Description
displayName

string

Nombre para mostrar de la entidad de seguridad

emailAddress

string

Dirección de correo electrónico del usuario

graphId

string

Identificador de la entidad de seguridad en Microsoft Graph. Solo está disponible para las API de administración.

groupUserAccessRight

GroupUserAccessRight

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

identifier

string

Identificador de la entidad de seguridad

principalType

PrincipalType

El tipo de entidad de seguridad

profile

ServicePrincipalProfile

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

userType

string

Tipo del usuario.

GroupUserAccessRight

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

Valor Description
None

Sin acceso al contenido del área de trabajo

Member

Leer, volver a compartir y explorar (ReadReshareExplore) derechos de acceso al contenido del área de trabajo

Admin

Derechos de administrador para el contenido del área de trabajo

Contributor

Acceso de lectura y exploración (ReadExplore) al contenido del área de trabajo

Viewer

Acceso de solo lectura (lectura) al contenido del á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

Nombre Tipo Description
@odata.context

string

value

GroupUser[]

Lista de usuarios con acceso a un área de trabajo

PrincipalType

El tipo de entidad de seguridad

Valor Description
None

No hay ningún tipo de entidad de seguridad. Se usa para el acceso de nivel de organización completo.

User

Tipo de entidad de seguridad de usuario

Group

Tipo de entidad de seguridad de grupo

App

Tipo de entidad de servicio

ServicePrincipalProfile

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

Nombre Tipo Description
displayName

string

El nombre del perfil de entidad de servicio

id

string (uuid)

Identificador del perfil de la entidad de servicio