Admin - Dataflows GetDataflowsAsAdmin

Referenz

Service:: Power BI REST APIs

API Version:: v1.0

Gibt eine Liste von Dataflows für die Organisation zurück.

Berechtigungen

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

Bei der Ausführung unter dienstprinizipaler 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.

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}

URI-Parameter

Name	In	Typ	Beschreibung
$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	AdminDataflows	OK

Beispiele

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

Definitionen

Name	Beschreibung
AdminDataflow	Die Metadaten eines Dataflows, der von Admin-APIs zurückgegeben wird. Im Folgenden finden Sie eine Liste der Eigenschaften, die für einen Dataflow zurückgegeben werden können. Je nach aufgerufener API, den Aufrufberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank wird nur eine Teilmenge der Eigenschaften zurückgegeben.
AdminDataflows	OData-Antwortwrapper für eine Power BI-Admin-Dataflowsammlung
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 Mehrinstanzenlösung.

AdminDataflow

Die Metadaten eines Dataflows, der von Admin-APIs zurückgegeben wird. Im Folgenden finden Sie eine Liste der Eigenschaften, die für einen Dataflow zurückgegeben werden können. Je nach aufgerufener API, den Aufrufberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank wird nur eine Teilmenge der Eigenschaften zurückgegeben.

Name	Typ	Beschreibung
configuredBy	string	Der Dataflowbesitzer
description	string	Die Dataflowbeschreibung
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 Name des Dataflows
objectId	string	Die Dataflow-ID
users	DataflowUser[]	(Leerer Wert) Die Datenflussbenutzerzugriffsdetails. Diese Eigenschaft wird in einem bevorstehenden Release aus der Nutzlastantwort entfernt. Sie können Benutzerinformationen zu einem Power BI-Dataflow abrufen, indem Sie den Api-Aufruf Get Dataflow Users as Admin oder den PostWorkspaceInfo-API-Aufruf mit dem `getArtifactUser` -Parameter verwenden.
workspaceId	string	Die Dataflow-Arbeitsbereichs-ID.

AdminDataflows

OData-Antwortwrapper für eine Power BI-Admin-Dataflowsammlung

Name	Typ	Beschreibung
odata.context	string	OData-Kontext
value	AdminDataflow[]	Die Berichtssammlung

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 Mehrinstanzenlösung.
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 erneuten Zugriff auf Inhalte im Dataflow
Read	string	Gewährt Lesezugriff auf Inhalte im Dataflow
ReadReshare	string	Gewährt Lese- und Erneuten Freigabezugriff 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 für den Gesamten Zugriff auf Organisationsebene.
User	string	Benutzerprinzipaltyp

ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.

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