Freigeben über

Datasets - Post Dataset User

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

Gewährt den angegebenen Benutzern Berechtigungen für das angegebene Dataset.

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