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 |
|---|---|---|---|---|
|
dataflow
|
path | True |
string (uuid) |
Identificador del flujo de datos |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
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 |
|---|---|
|
Dataflow |
Una entrada adecuada de acceso de usuario de Power BI para un flujo de datos |
|
Dataflow |
Derecho de acceso que un usuario tiene para el flujo de datos (nivel de permiso) |
|
Dataflow |
Contenedor de respuesta de OData para obtener una lista de usuarios de Power BI con acceso a un flujo de datos |
|
Principal |
El tipo de entidad de seguridad |
|
Service |
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 |
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 |
El tipo de entidad de seguridad |
|
| profile |
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 |
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 |