Freigeben über

Datasets - Put Dataset User

  • Referenz
Service:
Power BI REST APIs
API Version:
v1.0

Aktualisierungen die vorhandenen Datasetberechtigungen des angegebenen Benutzers an die angegebenen Berechtigungen.

Wenn Benutzerberechtigungen für ein Dataset kürzlich aktualisiert wurden, sind die neuen Berechtigungen möglicherweise nicht sofort über API-Aufrufe verfügbar. 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

Berechtigungen

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 Anrufer muss über ReadWriteReshare-Berechtigungen im Dataset verfügen. Das heißt, Ordneradministratoren, Mitglieder und Mitwirkende mit Freigabeberechtigungen oder Datasetbesitzern.
  • Diese API kann nicht zum Hinzufügen oder Entfernen der Schreibberechtigung 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. Für Ordner-Mitwirkende wird die ReadWriteExplore-Berechtigung für die Datasets des Ordners geerbt. Für Ordneranzeigen wird die Leseberechtigung für die 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 zum Zuweisen des Benutzers für das Dataset (Berechtigungsstufe)
identifier True

string

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

PrincipalType

Der Prinzipaltyp

Antworten

Name Typ Beschreibung
200 OK

OK

Beispiele

Example
Example for updating security group dataset permissions to ReadExplore

Example

Sample Request

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

Sample Response

Status code:
200

Example for updating security group dataset permissions to ReadExplore

Sample Request

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

Sample Response

Status code:
200

Definitionen

Name Beschreibung
DatasetUserAccess

Ein Power BI-Prinzipalzugriffsrechteintrag für ein Dataset
DatasetUserAccessRight

Der Zugriffsrecht, über das der Benutzer für das Dataset verfügt (Berechtigungsstufe)
PrincipalType

Der Prinzipaltyp

DatasetUserAccess

Ein Power BI-Prinzipalzugriffsrechteintrag für ein Dataset

Name Typ Beschreibung
datasetUserAccessRight

DatasetUserAccessRight

Die Zugriffsrechte zum Zuweisen des Benutzers für das Dataset (Berechtigungsstufe)
identifier

string

Geben Sie für den Prinzipaltyp Userden UPN an. Andernfalls stellen Sie die Objekt-ID des Prinzipals bereit.
principalType

PrincipalType

Der Prinzipaltyp

DatasetUserAccessRight

Der Zugriffsrecht, über das der Benutzer für das Dataset verfügt (Berechtigungsstufe)

Name Typ Beschreibung
None

string

Entfernt die Berechtigung zum Inhalt im Dataset
Read

string

Gewährt Lesezugriff auf den Inhalt im Dataset
ReadExplore

string

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

string

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

string

Gewährt Lese-, Reshare- 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 Erkunden des Zugriffs auf den Inhalt im Dataset
ReadWriteReshare

string

Gewährt Lese-, Schreib- und Wiederfreigabezugriff auf den Inhalt im Dataset
ReadWriteReshareExplore

string

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

PrincipalType

Der Prinzipaltyp

Name Typ Beschreibung
App

string

Dienstprinzipaltyp
Group

string

Gruppenprinzipaltyp
None

string

Kein Prinzipaltyp. Verwenden Sie den Gesamten Zugriff auf Organisationsebene.
User

string

Benutzerprinzipaltyp