Teilen über

Dataflows - Get Dataflows

  • Referenz
Dienst:
Power BI REST APIs
API-Version:
v1.0

Gibt eine Liste aller Datenflüsse aus dem angegebenen Arbeitsbereich zurück.

Erlaubnisse

Dieser API-Aufruf kann von einem Dienstprinzipalprofil aufgerufen werden. Weitere Informationen finden Sie unter: Dienstprinzipalprofile in Power BI Embedded.

Erforderlicher Bereich

Dataflow.ReadWrite.All oder Dataflow.Read.All 

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
groupId
 path True

string

uuid

Die Arbeitsbereichs-ID

Antworten

Name Typ Beschreibung
200 OK

Dataflows

OKAY

Beispiele

Example

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
Dataflow

Die Metadaten eines Datenflusses. Nachfolgend finden Sie eine Liste der Eigenschaften, die für einen Datenfluss zurückgegeben werden können. Je nach aufgerufener API, den Aufruferberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank werden nur eine Teilmenge der Eigenschaften zurückgegeben.
Dataflows

OData-Antwortwrapper für eine Datenflussmetadatenliste
DataflowUser

Ein Power BI-Benutzerzugriff für einen Datenfluss
DataflowUserAccessRight

Das Zugriffsrecht, das ein Benutzer für den Datenfluss hat (Berechtigungsstufe)
PrincipalType

Der Prinzipaltyp
ServicePrincipalProfile

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.

Dataflow

Object

Die Metadaten eines Datenflusses. Nachfolgend finden Sie eine Liste der Eigenschaften, die für einen Datenfluss zurückgegeben werden können. Je nach aufgerufener API, den Aufruferberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank werden nur eine Teilmenge der Eigenschaften zurückgegeben.

Name Typ Beschreibung
configuredBy

string

Der Datenflussbesitzer
description

string

Die Beschreibung des Datenflusses
modelUrl

string

Eine URL zur Datenflussdefinitionsdatei (model.json)
name

string

Der Name des Datenflusses
objectId

string

Die Datenfluss-ID
users

DataflowUser[]

(Leerer Wert) Die Datenflussbenutzerzugriffsdetails. Diese Eigenschaft wird aus der Nutzlastantwort in einer bevorstehenden Version entfernt. Sie können Benutzerinformationen für einen Power BI-Datenfluss abrufen, indem Sie den Get Dataflow Users as Admin API-Aufruf oder den PostWorkspaceInfo API-Aufruf mit dem parameter getArtifactUser verwenden.

Dataflows

Object

OData-Antwortwrapper für eine Datenflussmetadatenliste

Name Typ Beschreibung
@odata.context

string

value

Dataflow[]

Die Datenflussmetadatenliste

DataflowUser

Object

Ein Power BI-Benutzerzugriff für einen Datenfluss

Name Typ Beschreibung
DataflowUserAccessRight

DataflowUserAccessRight

Das Zugriffsrecht, das ein Benutzer für den Datenfluss hat (Berechtigungsstufe)
displayName

string

Anzeigename des Prinzipals
emailAddress

string

E-Mail-Adresse des Benutzers
graphId

string

Bezeichner des Prinzipals in Microsoft Graph. Nur für Administrator-APIs verfügbar.
identifier

string

Bezeichner des Prinzipals
principalType

PrincipalType

Der Prinzipaltyp
profile

ServicePrincipalProfile

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.
userType

string

Typ des Benutzers.

DataflowUserAccessRight

Enumeration

Das Zugriffsrecht, das ein Benutzer für den Datenfluss hat (Berechtigungsstufe)

Wert Beschreibung
None

Entfernt die Berechtigung für Inhalte im Datenfluss.
Owner

Gewährt Lese-, Schreib- und Freigabezugriff auf Inhalte im Datenfluss
Read

Gewährt Lesezugriff auf Inhalte im Datenfluss
ReadReshare

Gewährt Lese- und Freigabezugriff auf Inhalte im Datenfluss
ReadWrite

Gewährt Lese- und Schreibzugriff auf Inhalte im Datenfluss

PrincipalType

Enumeration

Der Prinzipaltyp

Wert Beschreibung
App

Dienstprinzipaltyp
Group

Gruppenprinzipaltyp
None

Kein Prinzipaltyp. Wird für den Zugriff auf ganze Organisationsebene verwendet.
User

Benutzerprinzipaltyp

ServicePrincipalProfile

Object

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.

Name Typ Beschreibung
displayName

string

Der Dienstprinzipalprofilname
id

string

Die Dienstprinzipalprofil-ID