Dataflows - Get Dataflows

Service:

Power BI REST APIs

API Version:

v1.0

Restituisce un elenco di tutti i flussi di dati dall'area di lavoro specificata.

Autorizzazioni

Questa chiamata API può essere chiamata da un profilo dell'entità servizio. Per altre informazioni, vedere: Profili dell'entità servizio in Power BI Embedded.

Ambito obbligatorio

Dataflow.ReadWrite.All o Dataflow.Read.All

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
groupId	path	True	string uuid	ID area di lavoro

Risposte

Nome	Tipo	Descrizione
200 OK	Dataflows	OK

Esempio

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"
    }
  ]
}

Definizioni

Nome	Descrizione
Dataflow	Metadati di un flusso di dati. Di seguito è riportato un elenco di proprietà che possono essere restituite per un flusso di dati. Solo un subset delle proprietà verrà restituito a seconda dell'API chiamata, delle autorizzazioni del chiamante e della disponibilità dei dati nel database di Power BI.
Dataflows	Wrapper di risposta OData per un elenco di metadati del flusso di dati
DataflowUser	Voce di accesso dell'utente di Power BI per un flusso di dati
DataflowUserAccessRight	Diritto di accesso che un utente ha per il flusso di dati (livello di autorizzazione)
PrincipalType	Tipo principale
ServicePrincipalProfile	Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.

Dataflow

Metadati di un flusso di dati. Di seguito è riportato un elenco di proprietà che possono essere restituite per un flusso di dati. Solo un subset delle proprietà verrà restituito a seconda dell'API chiamata, delle autorizzazioni del chiamante e della disponibilità dei dati nel database di Power BI.

Nome	Tipo	Descrizione
configuredBy	string	Proprietario del flusso di dati
description	string	Descrizione del flusso di dati
modelUrl	string	URL del file di definizione del flusso di dati (model.json)
modifiedBy	string	Utente che ha modificato il flusso di dati
modifiedDateTime	string	Data e ora dell'ultima modifica del flusso di dati
name	string	Nome del flusso di dati
objectId	string	ID flusso di dati
users	DataflowUser[]	(Valore vuoto) Dettagli dell'accesso utente del flusso di dati. Questa proprietà verrà rimossa dalla risposta del payload in una versione successiva. È possibile recuperare le informazioni utente su un flusso di dati di Power BI usando Get Dataflow Users come chiamata API Amministrazione o la chiamata API PostWorkspaceInfo con il getArtifactUser parametro .

Dataflows

Wrapper di risposta OData per un elenco di metadati del flusso di dati

Nome	Tipo	Descrizione
odata.context	string
value	Dataflow[]	Elenco dei metadati del flusso di dati

DataflowUser

Voce di accesso dell'utente di Power BI per un flusso di dati

Nome	Tipo	Descrizione
DataflowUserAccessRight	DataflowUserAccessRight	Diritto di accesso che un utente ha per il flusso di dati (livello di autorizzazione)
displayName	string	Nome visualizzato dell'entità
emailAddress	string	Indirizzo di posta elettronica dell'utente
graphId	string	Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione.
identifier	string	Identificatore dell'entità
principalType	PrincipalType	Tipo principale
profile	ServicePrincipalProfile	Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.
userType	string	Tipo dell'utente.

DataflowUserAccessRight

Diritto di accesso che un utente ha per il flusso di dati (livello di autorizzazione)

Nome	Tipo	Descrizione
None	string	Rimuove l'autorizzazione per il contenuto nel flusso di dati
Owner	string	Concede l'accesso in lettura, scrittura e ricondividi al contenuto nel flusso di dati
Read	string	Concede l'accesso in lettura al contenuto nel flusso di dati
ReadReshare	string	Concede l'accesso in lettura e rishare al contenuto nel flusso di dati
ReadWrite	string	Concede l'accesso in lettura e scrittura al contenuto nel flusso di dati

PrincipalType

Tipo principale

Nome	Tipo	Descrizione
App	string	Tipo di entità servizio
Group	string	Tipo di entità gruppo
None	string	Nessun tipo di entità. Usare per l'accesso a livello di organizzazione intero.
User	string	Tipo di entità utente

ServicePrincipalProfile

Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.

Nome	Tipo	Descrizione
displayName	string	Nome del profilo dell'entità servizio
id	string	ID profilo dell'entità servizio