Admin - Dataflows GetDataflowsAsAdmin

Servicio:

Power BI REST APIs

Versión de la API:

v1.0

Devuelve una lista de flujos de datos para la organización.

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/dataflows

Con parámetros opcionales:

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows?$filter={$filter}&$top={$top}&$skip={$skip}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
$filter	query		string	Devuelve un subconjunto de resultados basado en condición de parámetro de consulta de filtro Odata.
$skip	query		integer int32	Omite los primeros n resultados
$top	query		integer int32	Devuelve solo los primeros n resultados.

Respuestas

Nombre	Tipo	Description
200 OK	AdminDataflows	De acuerdo

Ejemplos

Example

Solicitud de ejemplo

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows

Respuesta de muestra

status code:

200

{
  "value": [
    {
      "objectId": "bd32e5c0-363f-430b-a03b-5535a4804b9b",
      "name": "AdventureWorks",
      "description": "Our Adventure Works",
      "modelUrl": "https://MyDataflowStorageAccount.dfs.core.windows.net/powerbi/contoso/AdventureWorks/model.json",
      "configuredBy": "john@contoso.com",
      "workspaceId": "6369a442-4bc4-425c-916d-460c42be746b"
    }
  ]
}

Definiciones

Nombre	Description
AdminDataflow	Metadatos de un flujo de datos devuelto por las API de administración. A continuación se muestra una lista de propiedades que se pueden devolver para un flujo de datos. Solo se devolverá un subconjunto de las propiedades en función de la API denominada, los permisos del autor de la llamada y la disponibilidad de los datos en la base de datos de Power BI.
AdminDataflows	Contenedor de respuesta de OData para una colección de flujos de datos de administración de Power BI
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)
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.

AdminDataflow

Metadatos de un flujo de datos devuelto por las API de administración. A continuación se muestra una lista de propiedades que se pueden devolver para un flujo de datos. Solo se devolverá un subconjunto de las propiedades en función de la API denominada, los permisos del autor de la llamada y la disponibilidad de los datos en la base de datos de Power BI.

Nombre	Tipo	Description
configuredBy	string	Propietario del flujo de datos
description	string	Descripción del flujo de datos
modelUrl	string	Dirección URL del archivo de definición de flujo de datos (model.json)
modifiedBy	string	Usuario que modificó el flujo de datos.
modifiedDateTime	string	Fecha y hora en que se modificó por última vez el flujo de datos
name	string	El nombre del flujo de datos
objectId	string	Identificador del flujo de datos
users	DataflowUser[]	(Valor vacío) Detalles de acceso del usuario del flujo de datos. Esta propiedad se quitará de la respuesta de carga en una próxima versión. Puede recuperar información de usuario en un flujo de datos de Power BI mediante el uso de la llamada API de obtención de flujos de datos como administrador llamada API o la llamada API de PostWorkspaceInfo con el parámetro getArtifactUser.
workspaceId	string	Identificador del área de trabajo del flujo de datos.

AdminDataflows

Contenedor de respuesta de OData para una colección de flujos de datos de administración de Power BI

Nombre	Tipo	Description
odata.context	string	Contexto de OData
value	AdminDataflow[]	Colección de informes

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

Nombre	Tipo	Description
None	string	Quita el permiso para el contenido en el flujo de datos.
Owner	string	Concede acceso de lectura, escritura y recompartición al contenido en el flujo de datos
Read	string	Concede acceso de lectura al contenido en el flujo de datos
ReadReshare	string	Concede acceso de lectura y volver a compartir el contenido en el flujo de datos
ReadWrite	string	Concede acceso de lectura y escritura al contenido en el flujo de datos

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

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	Identificador del perfil de la entidad de servicio