Datasets - Get Dataset Users

Dienst:: Power BI REST APIs

API-Version:: v1.0

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

Wenn Benutzerberechtigungen für ein Dataset kürzlich aktualisiert wurden, stehen die neuen Berechtigungen möglicherweise nicht sofort über API-Aufrufe zur Verfügung. Verwenden Sie zum Aktualisieren von Benutzerberechtigungen den API-Aufruf " Benutzerberechtigungen aktualisieren" .

Erlaubnisse

Die Berechtigungen für diesen API-Aufruf werden in Datasets-Berechtigungen aufgeführt.

Erforderlicher Bereich

Dataset.Read.All oder Dataset.ReadWrite.All

Einschränkungen

Der Aufrufer muss über ReadWriteReshare-Berechtigungen für das Dataset verfügen. Das heißt, Ordneradministratoren, Mitglieder und Mitwirkende mit Berechtigungen zum Erneuten Freigeben oder Datasetbesitzern.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
datasetId	path	True	string	Die Dataset-ID

Antworten

Name	Typ	Beschreibung
200 OK	DatasetUsersAccess	OKAY

Beispiele

Example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "identifier": "john@contoso.com",
      "principalType": "User",
      "datasetUserAccessRight": "Read"
    },
    {
      "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
      "principalType": "Group",
      "datasetUserAccessRight": "ReadReshare"
    },
    {
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App",
      "datasetUserAccessRight": "ReadWriteReshareExplore"
    }
  ]
}

Definitionen

Name	Beschreibung
DatasetUserAccess	Ein Power BI-Prinzipalzugriffsberechtigungseintrag für ein Dataset
DatasetUserAccessRight	Das Zugriffsrecht, das der Benutzer für das Dataset hat (Berechtigungsstufe)
DatasetUsersAccess	Der OData-Antwortwrapper für eine Liste von Power BI-Prinzipalen mit Zugriff auf ein Dataset
PrincipalType	Der Prinzipaltyp

DatasetUserAccess

Objekt

Ein Power BI-Prinzipalzugriffsberechtigungseintrag für ein Dataset

Name	Typ	Beschreibung
datasetUserAccessRight	DatasetUserAccessRight	Die Zugriffsrechte, die dem Benutzer für das Dataset zugewiesen werden sollen (Berechtigungsstufe)
identifier	string	Geben Sie für den Prinzipaltyp `User`den UPN an. Stellen Sie andernfalls die Objekt-ID des Prinzipals bereit.
principalType	PrincipalType	Der Prinzipaltyp

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

DatasetUsersAccess