Compartir a través de


Admin - Dataflows GetDataflowUsersAsAdmin

Devuelve una lista de usuarios que tienen acceso al flujo de datos especificado.

Permissions

  • 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 ninguna premisión necesaria de consentimiento del administrador para Power BI establecida 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/dataflows/{dataflowId}/users

Parámetros de identificador URI

Nombre En Requerido Tipo Description
dataflowId
path True

string (uuid)

Identificador del flujo de datos

Respuestas

Nombre Tipo Description
200 OK

DataflowUsers

OK

Ejemplos

Example

Solicitud de ejemplo

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows/{dataflowId}/users

Respuesta de muestra

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

Definiciones

Nombre Description
DataflowUser

Una entrada adecuada de acceso de usuario de Power BI para un flujo de datos

DataflowUserAccessRight

Derecho de acceso que un usuario tiene para el flujo de datos (nivel de permiso)

DataflowUsers

Contenedor de respuesta de OData para obtener una lista de usuarios de Power BI con acceso a un flujo de datos

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.

DataflowUser

Una entrada adecuada de acceso de usuario de Power BI para un flujo de datos

Nombre Tipo Description
DataflowUserAccessRight

DataflowUserAccessRight

Derecho de acceso que un usuario tiene para el flujo de datos (nivel de permiso)

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

profile

ServicePrincipalProfile

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

userType

string

Tipo del usuario.

DataflowUserAccessRight

Derecho de acceso que un usuario tiene para el flujo de datos (nivel de permiso)

Valor Description
None

Quita el permiso para el contenido en el flujo de datos.

Read

Concede acceso de lectura al contenido en el flujo de datos

ReadWrite

Concede acceso de lectura y escritura al contenido en el flujo de datos

ReadReshare

Concede acceso de lectura y volver a compartir el contenido en el flujo de datos

Owner

Concede acceso de lectura, escritura y recompartición al contenido en el flujo de datos

DataflowUsers

Contenedor de respuesta de OData para obtener una lista de usuarios de Power BI con acceso a un flujo de datos

Nombre Tipo Description
@odata.context

string

value

DataflowUser[]

Lista de usuarios con acceso a un flujo de datos

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 la 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