Admin - Dataflows GetDataflowsInGroupAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Gibt eine Liste von Dataflows aus dem angegebenen Arbeitsbereich zurück.

Berechtigungen

• Der Benutzer muss über Administratorrechte (z. B. Office 365 globalen Administrator oder Power BI-Dienstadministrator) verfügen oder sich mit einem Dienstprinzipal authentifizieren.
• Delegierte Berechtigungen werden unterstützt.

Bei der Ausführung unter dienstprinicipaler Authentifizierung dürfen für eine App keine erforderlichen Administratoreinwilligungsvoreinstellungen für Power BI im Azure-Portal festgelegt sein.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

Nur bei der Authentifizierung über ein standardmäßiges delegiertes Administratorzugriffstoken relevant. Darf nicht vorhanden sein, wenn die Authentifizierung über einen Dienstprinzipal verwendet wird.

Einschränkungen

Maximal 200 Anforderungen pro Stunde.

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

With optional parameters:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
groupId	path	True	string uuid	Arbeitsbereich-ID
$filter	query		string	Filtert die Ergebnisse basierend auf einer booleschen Bedingung
$skip	query		integer int32	Überspringt die ersten n-Ergebnisse
$top	query		integer int32	Gibt nur die ersten n-Ergebnisse zurück.

Antworten

Name	Typ	Beschreibung
200 OK	Dataflows	OK

Beispiele

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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"
    }
  ]
}

Definitionen

Name	Beschreibung
Dataflow	Die Metadaten eines Dataflows. Im Folgenden finden Sie eine Liste der Eigenschaften, die für einen Dataflow zurückgegeben werden können. Nur eine Teilmenge der Eigenschaften wird abhängig von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank zurückgegeben.
Dataflows	OData-Antwort wrapper für eine Dataflowmetadatenliste
DataflowUser	Ein Power BI-Benutzerzugriffsrechteintrag für einen Dataflow
DataflowUserAccessRight	Das Zugriffsrecht, das ein Benutzer für den Dataflow hat (Berechtigungsstufe)
PrincipalType	Der Prinzipaltyp
ServicePrincipalProfile	Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.

Dataflow

Die Metadaten eines Dataflows. Im Folgenden finden Sie eine Liste der Eigenschaften, die für einen Dataflow zurückgegeben werden können. Nur eine Teilmenge der Eigenschaften wird abhängig von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank zurückgegeben.

Name	Typ	Beschreibung
configuredBy	string	Der Dataflowbesitzer
description	string	Beschreibung des Dataflows
modelUrl	string	Eine URL zur Dataflowdefinitionsdatei (model.json)
modifiedBy	string	Der Benutzer, der den Dataflow geändert hat
modifiedDateTime	string	Datum und Uhrzeit der letzten Änderung des Dataflows
name	string	Der Dataflowname
objectId	string	Die Dataflow-ID
users	DataflowUser[]	(Leerer Wert) Die Datenflussbenutzerzugriffsdetails. Diese Eigenschaft wird in einer bevorstehenden Version aus der Nutzlastantwort entfernt. Sie können Benutzerinformationen zu einem Power BI-Dataflow abrufen, indem Sie dataflow-Benutzer als Admin API-Aufruf oder den PostWorkspaceInfo-API-Aufruf mit dem getArtifactUser Parameter verwenden.

Dataflows

OData-Antwort wrapper für eine Dataflowmetadatenliste

Name	Typ	Beschreibung
odata.context	string
value	Dataflow[]	Dataflowmetadatenliste

DataflowUser

Ein Power BI-Benutzerzugriffsrechteintrag für einen Dataflow

Name	Typ	Beschreibung
DataflowUserAccessRight	DataflowUserAccessRight	Das Zugriffsrecht, das ein Benutzer für den Dataflow 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-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.
userType	string	Typ des Benutzers.

DataflowUserAccessRight

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

Name	Typ	Beschreibung
None	string	Entfernt die Berechtigung für Inhalte im Dataflow
Owner	string	Gewährt Lese-, Schreib- und Wiederfreigabezugriff auf Inhalte im Dataflow
Read	string	Gewährt Lesezugriff auf Inhalte im Dataflow
ReadReshare	string	Gewährt Lese- und Weiterfreigabezugriff auf Inhalte im Dataflow
ReadWrite	string	Gewährt Lese- und Schreibzugriff auf Inhalte im Dataflow

PrincipalType

Der Prinzipaltyp

Name	Typ	Beschreibung
App	string	Dienstprinzipaltyp
Group	string	Gruppenprinzipaltyp
None	string	Kein Prinzipaltyp. Verwenden Sie dies für den gesamten Zugriff auf Organisationsebene.
User	string	Benutzerprinzipaltyp

ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.

Name	Typ	Beschreibung
displayName	string	Der Dienstprinzipalprofilname
id	string	Die Dienstprinzipalprofil-ID