Datasets - Post Dataset User

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

Gewährt den berechtigungen des angegebenen Benutzers für das angegebene Dataset.

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 .

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

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

Example

Sample Request

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

Sample Request

POST 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
DatasetUserAccessRightEntry

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

Ein Power BI-Benutzer greift auf den richtigen Eintrag für ein Dataset zu
PrincipalType

Der Prinzipaltyp

DatasetUserAccessRightEntry

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

Name Typ Beschreibung
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

PostDatasetUserAccess

Ein Power BI-Benutzer greift auf den richtigen Eintrag für ein Dataset zu

Name Typ Beschreibung
datasetUserAccessRight

DatasetUserAccessRightEntry

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

string

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

PrincipalType

Der Prinzipaltyp

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