Dataflows - Get Dataflows

Servicio:

Power BI REST APIs

Versión de la API:

v1.0

Devuelve una lista de todos los flujos de datos del área de trabajo especificada.

Permisos

Un perfil de entidad de servicio puede llamar a esta llamada API. Para obtener más información, consulte: perfiles de entidad de servicio de en Power BI Embedded.

Ámbito requerido

Dataflow.ReadWrite.All o Dataflow.Read.All

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dataflows

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
groupId	path	True	string uuid	Identificador del área de trabajo

Respuestas

Nombre	Tipo	Description
200 OK	Dataflows	De acuerdo

Ejemplos

Example

Solicitud de ejemplo

GET https://api.powerbi.com/v1.0/myorg/groups/a2f89923-421a-464e-bf4c-25eab39bb09f/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"
    }
  ]
}

Definiciones

Nombre	Description
Dataflow	Metadatos de un flujo de datos. 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.
Dataflows	Contenedor de respuesta de OData para una lista de metadatos de flujo de datos
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.

Dataflow

Object

Metadatos de un flujo de datos. 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)
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.

Dataflows

Object

Contenedor de respuesta de OData para una lista de metadatos de flujo de datos

Nombre	Tipo	Description
@odata.context	string
value	Dataflow[]	Lista de metadatos de flujo de datos

DataflowUser

Object

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

Enumeration

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.
Owner	Concede acceso de lectura, escritura y recompartición al contenido en el flujo de datos
Read	Concede acceso de lectura al contenido en el flujo de datos
ReadReshare	Concede acceso de lectura y volver a compartir el contenido en el flujo de datos
ReadWrite	Concede acceso de lectura y escritura al contenido en el flujo de datos

PrincipalType

Enumeration

El tipo de entidad de seguridad

Valor	Description
App	Tipo de entidad de servicio
Group	Tipo de entidad de seguridad de grupo
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

ServicePrincipalProfile

Object

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