Freigeben über

Datasets - Put Dataset User

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

Aktualisiert die vorhandenen Datasetberechtigungen des angegebenen Benutzers auf die angegebenen Berechtigungen.

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" . Dieser API-Aufruf kann verwendet werden, um alle Datasetberechtigungen des angegebenen Benutzers mithilfe von datasetUserAccessRight: None

Erforderlicher Bereich

Dataset.ReadWrite.All

Erlaubnisse

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

Einschränkungen

  • Das Aktualisieren von Berechtigungen für Dienstprinzipale (App principalType) wird nicht unterstützt.
  • 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.
  • Diese API kann nicht zum Hinzufügen oder Entfernen von Schreibberechtigungen verwendet werden.
  • Diese API kann nicht verwendet werden, um geerbte Berechtigungen auf Ordnerebene zu entfernen. Für Ordneradministratoren und -mitglieder wird die ReadWriteReshareExplore-Berechtigung für die Datasets des Ordners geerbt. Bei Ordnermitwirkenden wird die ReadWriteExplore-Berechtigung für die Datasets des Ordners geerbt. Bei Ordneranzeigen wird die Lesen-Berechtigung in den Datasets des Ordners geerbt. 

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
datasetId
 path True

string

Die Dataset-ID

Anforderungstext

Name Erforderlich Typ Beschreibung
datasetUserAccessRight True

DatasetUserAccessRight

Die Zugriffsrechte, die dem Benutzer für das Dataset zugewiesen werden sollen (Berechtigungsstufe)
identifier True

string

Geben Sie für den Prinzipaltyp Userden UPN an. Stellen Sie andernfalls die Objekt-ID des Prinzipals bereit.
principalType True

PrincipalType

Der Prinzipaltyp

Antworten

Name Typ Beschreibung
200 OK

OKAY

Beispiele

Example
Example for updating security group dataset permissions to ReadExplore

Example

Beispielanforderung

PUT https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
Anforderungstext
{
  "identifier": "john@contoso.com",
  "principalType": "User",
  "datasetUserAccessRight": "Read"
}

Beispiel für eine Antwort

Statuscode:
200

Example for updating security group dataset permissions to ReadExplore

Beispielanforderung

PUT https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
Anforderungstext
{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

Beispiel für eine Antwort

Statuscode:
200

Definitionen

Name Beschreibung
DatasetUserAccess

Ein Power BI-Prinzipalzugriffsberechtigungseintrag für ein Dataset
DatasetUserAccessRight

Das Zugriffsrecht, das der Benutzer für das Dataset hat (Berechtigungsstufe)
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 Userden 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

PrincipalType

Enumeration

Der Prinzipaltyp

Wert Beschreibung
None

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

Benutzerprinzipaltyp
Group

Gruppenprinzipaltyp
App

Dienstprinzipaltyp