Freigeben über

Admin - Dataflows GetDataflowUsersAsAdmin

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

Gibt eine Liste von Benutzern zurück, die Zugriff auf den angegebenen Datenfluss haben.

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/{dataflowId}/users

URI-Parameter

Name In Erforderlich Typ Beschreibung
dataflowId
 path True

string (uuid)

Die Datenfluss-ID

Antworten

Name Typ Beschreibung
200 OK

DataflowUsers

OKAY

Beispiele

Example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows/{dataflowId}/users

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "dataflowUserAccessRight": "ReadWrite",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    }
  ]
}

Definitionen

Name Beschreibung
DataflowUser

Ein Power BI-Benutzerzugriff für einen Datenfluss
DataflowUserAccessRight

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

Der OData-Antwortwrapper für eine Liste von Power BI-Benutzern mit Zugriff auf einen Datenfluss
PrincipalType

Der Prinzipaltyp
ServicePrincipalProfile

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

DataflowUser

Objekt

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.
Read

Gewährt Lesezugriff auf Inhalte im Datenfluss
ReadWrite

Gewährt Lese- und Schreibzugriff auf Inhalte im Datenfluss
ReadReshare

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

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

DataflowUsers

Objekt

Der OData-Antwortwrapper für eine Liste von Power BI-Benutzern mit Zugriff auf einen Datenfluss

Name Typ Beschreibung
@odata.context

string

value

DataflowUser[]

Die Liste der Benutzer mit Zugriff auf einen Datenfluss

PrincipalType

Enumeration

Der Prinzipaltyp

Wert Beschreibung
None

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

Benutzerprinzipaltyp
Group

Gruppenprinzipaltyp
App

Dienstprinzipaltyp

ServicePrincipalProfile

Objekt

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

Name Typ Beschreibung
displayName

string

Der Dienstprinzipalprofilname
id

string (uuid)

Die Dienstprinzipalprofil-ID