Datasets - Get Dataset Users

Referenz

Service:: Power BI REST APIs

API Version:: v1.0

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

Wenn Benutzerberechtigungen für ein Dataset kürzlich aktualisiert wurden, sind die neuen Berechtigungen möglicherweise nicht sofort über API-Aufrufe verfügbar. Um Benutzerberechtigungen zu aktualisieren, verwenden Sie den API-Aufruf der Aktualisierung von Benutzerberechtigungen .

Berechtigungen

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 für erneute Freigaben oder Datasetbesitzer.

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	OK

Beispiele

Example

Sample Request

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

Sample Response

Status code:: 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-Prinzipalzugriff für ein Dataset
DatasetUserAccessRight	Der Zugriffsrecht, über den der Benutzer für das Dataset verfügt (Berechtigungsstufe)
DatasetUsersAccess	Der OData-Antwortwrapper für eine Liste von Power BI-Prinzipalen mit Zugriff auf ein Dataset
PrincipalType	Der Prinzipaltyp

DatasetUserAccess

Ein Power BI-Prinzipalzugriff für ein Dataset

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

DatasetUserAccessRight

Der Zugriffsrecht, über den der Benutzer für das Dataset verfügt (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-, Refreigabe- und Erkunden des Zugriffs auf den Inhalt im Dataset
ReadWrite	string	Gewährt Lese- und Schreibzugriff auf den Inhalt im Dataset
ReadWriteExplore	string	Gewährt Lese-, Schreib- und Erkundenzugriff auf den Inhalt im Dataset
ReadWriteReshare	string	Gewährt Lese-, Schreib- und Freigabezugriff auf den Inhalt im Dataset
ReadWriteReshareExplore	string	Gewährt Lese-, Schreib-, Refreigabe- und Erkunden des Zugriffs auf den Inhalt im Dataset

DatasetUsersAccess

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

Name	Typ	Beschreibung
odata.context	string
value	DatasetUserAccess[]	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. Wird für den gesamten Zugriff auf Organisationsebene verwendet.
User	string	Benutzerprinzipaltyp

Freigeben über