Freigeben über

Gateways - Add Datasource User

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

Gewährt oder aktualisiert die Berechtigungen, die erforderlich sind, um die angegebene Datenquelle für den angegebenen Benutzer zu verwenden.

Erlaubnisse

Der Benutzer muss über Gatewayadministratorberechtigungen verfügen.

Erforderlicher Bereich

Dataset.ReadWrite.All

Einschränkungen

VNet-Gateways (Virtual Network) werden nicht unterstützt. Das Hinzufügen von Gruppen über die API wird nicht unterstützt. 

POST https://api.powerbi.com/v1.0/myorg/gateways/{gatewayId}/datasources/{datasourceId}/users

URI-Parameter

Name In Erforderlich Typ Beschreibung
datasourceId
 path True

string (uuid)

Die Datenquellen-ID
gatewayId
 path True

string (uuid)

Die Gateway-ID. Bei Verwendung eines Gatewayclusters bezieht sich die Gateway-ID auf das primäre (erste) Gateway im Cluster. In solchen Fällen ähnelt die Gateway-ID der Gatewaycluster-ID.

Anforderungstext

Name Erforderlich Typ Beschreibung
datasourceAccessRight True

DatasourceUserAccessRight

Das Zugriffsrecht (Berechtigungsstufe), über das ein Benutzer in der Datenquelle verfügt
displayName

string

Der Anzeigename des Prinzipals
emailAddress

string

Die E-Mail-Adresse des Benutzers
identifier

string

Die Objekt-ID des Prinzipals
principalType

PrincipalType

Der Prinzipaltyp
profile

ServicePrincipalProfile

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.

Antworten

Name Typ Beschreibung
200 OK

OKAY

Beispiele

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example
Example

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example

Beispielanforderung

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users
Anforderungstext
{
  "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
  "datasourceAccessRight": "ReadOverrideEffectiveIdentity"
}

Beispiel für eine Antwort

Statuscode:
200

Example

Beispielanforderung

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users
Anforderungstext
{
  "emailAddress": "john@contoso.com",
  "datasourceAccessRight": "Read"
}

Beispiel für eine Antwort

Statuscode:
200

Definitionen

Name Beschreibung
DatasourceUser

Ein Power BI-Benutzer mit Zugriff auf die Datenquelle
DatasourceUserAccessRight

Das Zugriffsrecht (Berechtigungsstufe), über das ein Benutzer in der Datenquelle verfügt
PrincipalType

Der Prinzipaltyp
ServicePrincipalProfile

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.

DatasourceUser

Objekt

Ein Power BI-Benutzer mit Zugriff auf die Datenquelle

Name Typ Beschreibung
datasourceAccessRight

DatasourceUserAccessRight

Das Zugriffsrecht (Berechtigungsstufe), über das ein Benutzer in der Datenquelle verfügt
displayName

string

Der Anzeigename des Prinzipals
emailAddress

string

Die E-Mail-Adresse des Benutzers
identifier

string

Die Objekt-ID des Prinzipals
principalType

PrincipalType

Der Prinzipaltyp
profile

ServicePrincipalProfile

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.

DatasourceUserAccessRight

Enumeration

Das Zugriffsrecht (Berechtigungsstufe), über das ein Benutzer in der Datenquelle verfügt

Wert Beschreibung
None

Keine Berechtigung für den Zugriff auf die Datenquelle. Gilt nur beim Aktualisieren von Benutzerberechtigungen.
Read

Datasets im Besitz des Benutzers haben Lesezugriff auf die Datenquelle
ReadOverrideEffectiveIdentity

Der Benutzer kann die effektive Identität für Power BI Embedded außer Kraft setzen. Gilt nur für lokale Analysis Services-Datenquellen.

PrincipalType

Enumeration

Der Prinzipaltyp

Wert Beschreibung
None

Kein Prinzipaltyp. Wird für den Zugriff auf ganze Organisationsebene verwendet.
User

Benutzerprinzipaltyp
Group

Gruppenprinzipaltyp
App

Dienstprinzipaltyp

ServicePrincipalProfile

Objekt

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.

Name Typ Beschreibung
displayName

string

Der Dienstprinzipalprofilname
id

string (uuid)

Die Dienstprinzipalprofil-ID