Dataflows - Get Dataflows

Referencia

Service:: Power BI REST APIs

API Version:: 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 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	Aceptar

Ejemplos

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/a2f89923-421a-464e-bf4c-25eab39bb09f/dataflows

Sample Response

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 de derecho de acceso de usuario de Power BI para un flujo de datos
DataflowUserAccessRight	Derecho de acceso que tiene un usuario para el flujo de datos (nivel de permiso)
PrincipalType	Tipo de entidad de seguridad
ServicePrincipalProfile	Un perfil principal de servicio Power BI. Solo es relevante para Power BI Embedded solución multiinquilino.

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.

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	El 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	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 la llamada a Get Dataflow Users as Administración API o la llamada api PostWorkspaceInfo con el `getArtifactUser` parámetro .

Dataflows

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

Nombre	Tipo	Description
odata.context	string
value	Dataflow[]	La lista de metadatos del flujo de datos

DataflowUser

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

Nombre	Tipo	Description
DataflowUserAccessRight	DataflowUserAccessRight	Derecho de acceso que tiene un usuario 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 administrador.
identifier	string	Identificador de la entidad de seguridad
principalType	PrincipalType	Tipo de entidad de seguridad
profile	ServicePrincipalProfile	Un perfil principal de servicio Power BI. Solo es relevante para Power BI Embedded solución multiinquilino.
userType	string	Tipo del usuario.

DataflowUserAccessRight

Derecho de acceso que tiene un usuario 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 del flujo de datos.
Read	string	Concede acceso de lectura al contenido en el flujo de datos.
ReadReshare	string	Concede acceso de lectura y recompartición al contenido en el flujo de datos
ReadWrite	string	Concede acceso de lectura y escritura al contenido en el flujo de datos.

PrincipalType

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. Use para el acceso de nivel de organización completo.
User	string	Tipo de entidad de seguridad de usuario

ServicePrincipalProfile

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

Nombre	Tipo	Description
displayName	string	El nombre del perfil de entidad de servicio
id	string	El identificador de perfil de la entidad de servicio