Condividi tramite

Dataflows - Get Dataflows

  • Riferimento
Servizio:
Power BI REST APIs
Versione API:
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 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 dell'area di lavoro

Risposte

Nome Tipo Descrizione
200 OK

Dataflows

OK

Esempio

Example

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
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

Immissione del diritto di accesso 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 di entità
ServicePrincipalProfile

Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.

Dataflow

Object

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

string

Nome del flusso di dati
objectId

string

ID flusso di dati
users

DataflowUser[]

(Valore vuoto) Dettagli di accesso utente del flusso di dati. Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare informazioni utente su un flusso di dati di Power BI usando il Get Dataflow Users as Admin API call oppure la chiamata API PostWorkspaceInfo con il parametro getArtifactUser.

Dataflows

Object

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

Nome Tipo Descrizione
@odata.context

string

value

Dataflow[]

Elenco di metadati del flusso di dati

DataflowUser

Object

Immissione del diritto di accesso 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 di entità
profile

ServicePrincipalProfile

Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.
userType

string

Tipo di utente.

DataflowUserAccessRight

Enumeration

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

Valore Descrizione
None

Rimuove l'autorizzazione per il contenuto nel flusso di dati
Owner

Concede l'accesso in lettura, scrittura e ricondivisione al contenuto nel flusso di dati
Read

Concede l'accesso in lettura al contenuto nel flusso di dati
ReadReshare

Concede l'accesso in lettura e ricondivisione al contenuto nel flusso di dati
ReadWrite

Concede l'accesso in lettura e scrittura al contenuto nel flusso di dati

PrincipalType

Enumeration

Tipo di entità

Valore Descrizione
App

Tipo di entità servizio
Group

Tipo di entità gruppo
None

Nessun tipo di entità. Usare per l'accesso a livello di organizzazione intero.
User

Tipo di entità utente

ServicePrincipalProfile

Object

Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.

Nome Tipo Descrizione
displayName

string

Nome del profilo dell'entità servizio
id

string

ID del profilo dell'entità servizio