Admin - Datasets GetDatasetUsersAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Gibt eine Liste der Benutzer zurück, die Zugriff auf das angegebene Dataset haben.

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.
• Die Berechtigungen für diesen API-Aufruf sind unter Datasets-Berechtigungen aufgeführt.

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/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	OK

Beispiele

Example

Sample Request

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

Sample Response

Status code:

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-Benutzerzugriffsrechteintrag für ein Dataset
DatasetUserAccessRight	Das Zugriffsrecht, das der Benutzer für das Dataset hat (Berechtigungsstufe)
DatasetUsers	Der OData-Antwort-Wrapper für eine Liste von Power BI-Benutzern mit Zugriff auf ein Dataset
PrincipalType	Der Prinzipaltyp
ServicePrincipalProfile	Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.

DatasetUser

Ein Power BI-Benutzerzugriffsrechteintrag 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-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.
userType	string	Typ des Benutzers.

DatasetUserAccessRight

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

Name	Typ	Beschreibung
None	string	Entfernt die Berechtigung für den Inhalt im Dataset.
Read	string	Gewährt Lesezugriff auf den Inhalt im Dataset
ReadExplore	string	Gewährt Lese- und Erkundungszugriff auf den Inhalt im Dataset
ReadReshare	string	Gewährt Lese- und Freigabezugriff auf den Inhalt im Dataset
ReadReshareExplore	string	Gewährt Lese-, Freigabe- und Erkundenzugriff auf den Inhalt im Dataset
ReadWrite	string	Gewährt Lese- und Schreibzugriff auf den Inhalt im Dataset
ReadWriteExplore	string	Gewährt Lese-, Schreib- und Erkundungszugriff auf den Inhalt im Dataset
ReadWriteReshare	string	Gewährt Lese-, Schreib- und Wiederfreigabezugriff auf den Inhalt im Dataset
ReadWriteReshareExplore	string	Gewährt Lese-, Schreib-, Weiterfreigabe- und Erkundenzugriff auf den Inhalt im Dataset

DatasetUsers

Der OData-Antwort-Wrapper 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

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