Admin - Apps GetAppUsersAsAdmin

Servicio:: Power BI REST APIs

Versión de la API:: v1.0

Devuelve una lista de usuarios que tienen acceso a la aplicación 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/apps/{appId}/users

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
appId	path	True	string (uuid)	El identificador de la aplicación

Respuestas

Nombre	Tipo	Description
200 OK	AppUsers	De acuerdo

Ejemplos

Example

Solicitud de ejemplo

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

Respuesta de muestra

status code:: 200

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "appUserAccessRight": "ReadExplore",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    }
  ]
}

Definiciones

Nombre	Description
AppUser	Una entrada adecuada de acceso de usuario de Power BI para una aplicación
AppUserAccessRight	Derecho de acceso que el usuario tiene para la aplicación
AppUsers	Contenedor de respuesta de OData para obtener una lista de usuarios de Power BI con acceso a una aplicación
PrincipalType	El tipo de entidad de seguridad

AppUser

Object

Una entrada adecuada de acceso de usuario de Power BI para una aplicación

Nombre	Tipo	Description
appUserAccessRight	AppUserAccessRight	Derecho de acceso que el usuario tiene para la aplicación
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.
identifier	string	Identificador de la entidad de seguridad
principalType	PrincipalType	El tipo de entidad de seguridad

AppUserAccessRight

Enumeración

Derecho de acceso que el usuario tiene para la aplicación

Valor	Description
None	Sin permiso para el contenido de la aplicación
Read	Concede acceso de lectura al contenido de la aplicación
ReadWrite	Concede acceso de lectura y escritura al contenido de la aplicación
ReadReshare	Concede acceso de lectura y volver a compartir el contenido de la aplicación
ReadWriteReshare	Concede acceso de lectura, escritura y recompartición al contenido de la aplicación
ReadExplore	Concede acceso de lectura y exploración al contenido de la aplicación
ReadCopy	Concede acceso de lectura y copia al contenido de la aplicación
ReadExploreCopy	Concede acceso de lectura, exploración y copia al contenido de la aplicación
ReadReshareExplore	Concede acceso de lectura, volver a compartir y explorar el acceso al contenido de la aplicación
ReadReshareExploreCopy	Concede acceso de lectura, volver a compartir, explorar y copiar el contenido de la aplicación
ReadWriteExplore	Concede acceso de lectura, escritura y exploración al contenido de la aplicación
ReadWriteReshareExplore	Concede acceso de lectura, escritura, volver a compartir y explorar el acceso al contenido de la aplicación
ReadWriteExploreCopy	Concede acceso de lectura, escritura, exploración y copia al contenido de la aplicación
ReadReshareCopy	Concede acceso de lectura, volver a compartir y copiar el contenido de la aplicación
All	Concede acceso de lectura, escritura, exploración, uso compartido y copia al contenido de la aplicación

AppUsers