Datasets - Post Dataset User

Dienst:: Power BI REST APIs

API-Version:: v1.0

Gewährt dem angegebenen Semantikmodell die Berechtigungen des angegebenen Benutzers. Das Semantikmodell kann sich im Arbeitsbereich "Mein Arbeitsbereich" oder in einem anderen Arbeitsbereich befinden, vorausgesetzt, der Aufrufer verfügt über die erforderlichen 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" .

Erforderlicher Bereich

Dataset.ReadWrite.All

Einschränkungen

Das Hinzufügen von Berechtigungen zu Dienstprinzipalen (App principalType) wird nicht unterstützt.
Der Aufrufer muss über ReadReshare-Berechtigungen für das Dataset verfügen.
Dieser API-Aufruf kann nicht verwendet werden, um dataset-Schreibberechtigungen für das Dataset zu erteilen.

POST 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	DatasetUserAccessRightEntry	Erforderlich. Das Zugriffsrecht, dem Benutzer für das Dataset zu gewähren.
identifier	True	string	Geben Sie für den Prinzipaltyp `User`den 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 granting ReadExplore right to a security group

Example

Beispielanforderung

POST 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 granting ReadExplore right to a security group

Beispielanforderung

POST 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
DatasetUserAccessRightEntry	Erforderlich. Das Zugriffsrecht, dem Benutzer für das Dataset zu gewähren.
PostDatasetUserAccess	Ein Power BI-Benutzerzugriff für ein Dataset
PrincipalType	Der Prinzipaltyp

DatasetUserAccessRightEntry

Enumeration

Erforderlich. Das Zugriffsrecht, dem Benutzer für das Dataset zu gewähren.

Wert	Beschreibung
Read	Gewährt Lesezugriff auf den Inhalt im Dataset
ReadReshare	Gewährt Lese- 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

PostDatasetUserAccess

Objekt

Ein Power BI-Benutzerzugriff für ein Dataset

Name	Typ	Beschreibung
datasetUserAccessRight	DatasetUserAccessRightEntry	Erforderlich. Das Zugriffsrecht, dem Benutzer für das Dataset zu gewähren.
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

PrincipalType

Enumeration

Der Prinzipaltyp

Wert	Beschreibung
None	Kein Prinzipaltyp. Wird für den Zugriff auf ganze Organisationsebene verwendet.
User	Benutzerprinzipaltyp
Group	Gruppenprinzipaltyp
App	Dienstprinzipaltyp