Freigeben über

Admin - Datasets GetDatasetUsersAsAdmin

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

Gibt eine Liste von Benutzern zurück, die Zugriff auf das angegebene Dataset haben.

Erlaubnisse

  • Der Benutzer muss ein Fabric-Administrator sein oder sich mit einem Dienstprinzipal authentifizieren.
  • Delegierte Berechtigungen werden unterstützt.
  • Die Berechtigungen für diesen API-Aufruf werden in Datasets-Berechtigungenaufgeführt.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
datasetId
 path True

string (uuid)

Die Dataset-ID

Antworten

Name Typ Beschreibung
200 OK

DatasetUsers

OKAY

Beispiele

Example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/admin/datasets/{datasetId}/users

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
DatasetUser

Ein Power BI-Benutzerzugriff für ein Dataset
DatasetUserAccessRight

Das Zugriffsrecht, das der Benutzer für das Dataset hat (Berechtigungsstufe)
DatasetUsers

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

Der Prinzipaltyp
ServicePrincipalProfile

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

DatasetUser

Objekt

Ein Power BI-Benutzerzugriff für ein Dataset

Name Typ Beschreibung
datasetUserAccessRight

DatasetUserAccessRight

Das Zugriffsrecht, das der Benutzer für das Dataset 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.

DatasetUserAccessRight

Enumeration

Das Zugriffsrecht, das der Benutzer für das Dataset hat (Berechtigungsstufe)

Wert Beschreibung
None

Entfernt die Berechtigung für den Inhalt im Dataset.
Read

Gewährt Lesezugriff auf den Inhalt im Dataset
ReadWrite

Gewährt Lese- und Schreibzugriff auf den Inhalt im Dataset
ReadReshare

Gewährt Lese- und Freigabezugriff auf den Inhalt im Dataset
ReadWriteReshare

Gewährt Lese-, Schreib- und Freigabezugriff auf den Inhalt im Dataset
ReadExplore

Gewährt Lese- und Erkundungszugriff auf den Inhalt im Dataset
ReadReshareExplore

Gewährt Lese-, Freigabe- und Erkunden des Zugriffs auf den Inhalt im Dataset
ReadWriteExplore

Gewährt Lese-, Schreib- und Erkunden des Zugriffs auf den Inhalt im Dataset
ReadWriteReshareExplore

Gewährt Lese-, Schreib-, Refreigabe- und Erkunden des Zugriffs auf den Inhalt im Dataset

DatasetUsers

Objekt

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

Name Typ Beschreibung
@odata.context

string

value

DatasetUser[]

Die Liste der Benutzer mit Zugriff auf ein Dataset

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