Freigeben über

Datasets - Put Dataset User In Group

  • 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. Um Benutzerberechtigungen zu aktualisieren, verwenden Sie den API-Aufruf der Aktualisierung von Benutzerberechtigungen . 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 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.
  • 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 Ordnermitwirkende 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/groups/{groupId}/datasets/{datasetId}/users

URI-Parameter

Name In Erforderlich Typ Beschreibung
datasetId
 path True

string

Die Dataset-ID
groupId
 path True

string

uuid

Arbeitsbereich-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

Stellen Sie für den Prinzipaltyp Userden UPN bereit. Geben Sie andernfalls die Objekt-ID des Prinzipals an.
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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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-Prinzipalzugriff für ein Dataset
DatasetUserAccessRight

Der Zugriffsrecht, über den der Benutzer für das Dataset verfügt (Berechtigungsstufe)
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 Userden 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

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