Admin - Apps GetAppUsersAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Devuelve una lista de usuarios que tienen acceso a la aplicación especificada.

Permisos

• El usuario debe tener derechos de administrador (como Office 365 administrador global o administrador del servicio Power BI) o autenticarse mediante una entidad de servicio.
• Se admiten permisos delegados.

Cuando se ejecuta con la autenticación prinicipal del servicio, una aplicación no debe tener ninguna premisión necesaria para el consentimiento del administrador para Power BI establecida en él en el 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	Aceptar

Ejemplos

Example

Sample Request

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

Sample Response

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 tiene el usuario 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

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

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

AppUserAccessRight

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

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

AppUsers

Contenedor de respuesta de OData para obtener una lista de usuarios de Power BI con acceso a una aplicación

Nombre	Tipo	Description
odata.context	string
value	AppUser[]	Lista de usuarios con acceso a una aplicación

PrincipalType

El tipo de entidad de seguridad

Nombre	Tipo	Description
App	string	Tipo de entidad de servicio
Group	string	Tipo de entidad de seguridad de grupo
None	string	No hay ningún tipo de entidad de seguridad. Se usa para el acceso de nivel de organización completo.
User	string	Tipo de entidad de seguridad de usuario