Admin - Dataflows GetDataflowsAsAdmin

Referencia

Service:: Power BI REST APIs

API Version:: v1.0

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

Permisos

El usuario debe tener derechos de administrador (como Office 365 administrador global o administrador del servicio Power BI) o autenticarse mediante una entidad de servicio.
Se admiten permisos delegados.

Cuando se ejecuta con 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 el 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.

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

With optional parameters:

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

Parámetros de identificador URI

Nombre	En	Tipo	Description
$filter	query	string	Filtra los resultados, en función de una condición booleana.
$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	Aceptar

Ejemplos

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/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",
      "configuredBy": "john@contoso.com",
      "workspaceId": "6369a442-4bc4-425c-916d-460c42be746b"
    }
  ]
}

Definiciones

Nombre	Description
AdminDataflow	Metadatos de un flujo de datos devuelto por Administración API. 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 Power BI Administración
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.

AdminDataflow

Metadatos de un flujo de datos devuelto por Administración API. 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 .
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 Power BI Administración

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

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