Admin - Dataflows GetDataflowsAsAdmin

Referenz

Dienst:: Power BI REST APIs

API-Version:: v1.0

Gibt eine Liste der Datenflüsse für die Organisation zurück.

Erlaubnisse

Der Benutzer muss ein Fabric-Administrator sein oder sich mit einem Dienstprinzipal authentifizieren.
Delegierte Berechtigungen werden unterstützt.

Wenn eine App unter der dienst prinicipalen Authentifizierung ausgeführt wird, darf eine App keine erforderlichen Administratorzustimmungen für Power BI im Azure-Portal festlegen.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

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

Begrenzungen

Maximal 200 Anforderungen pro Stunde.

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows

Mit optionalen Parametern:

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	Gibt eine Teilmenge einer Ergebnisse basierend auf Odata- Filterabfrageparameterbedingung zurück.
$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	OKAY

Beispiele

Example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/admin/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",
      "configuredBy": "john@contoso.com",
      "workspaceId": "6369a442-4bc4-425c-916d-460c42be746b"
    }
  ]
}

Definitionen

Name	Beschreibung
AdminDataflow	Die Metadaten eines von Administrator-APIs zurückgegebenen 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.
AdminDataflows	OData-Antwortwrapper für eine Power BI Admin-Datenflusssammlung
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.

AdminDataflow

Die Metadaten eines von Administrator-APIs zurückgegebenen 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)
modifiedBy	string	Der Benutzer, der den Datenfluss geändert hat
modifiedDateTime	string	Datum und Uhrzeit der letzten Änderung des Datenflusses
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.
workspaceId	string	Die Datenflussarbeitsbereichs-ID.

AdminDataflows

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

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

DataflowUser

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

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

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

PrincipalType

Der Prinzipaltyp

Name	Typ	Beschreibung
App	string	Dienstprinzipaltyp
Group	string	Gruppenprinzipaltyp
None	string	Kein Prinzipaltyp. Wird für den Zugriff auf ganze Organisationsebene verwendet.
User	string	Benutzerprinzipaltyp

ServicePrincipalProfile

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

Freigeben über