Gateways - Add Datasource User

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

Gewährt oder aktualisiert die Berechtigungen, die für die Verwendung der angegebenen Datenquelle für den angegebenen Benutzer erforderlich sind.

Berechtigungen

Der Benutzer muss über Gatewayadministratorberechtigungen verfügen.

Erforderlicher Bereich

Dataset.ReadWrite.All

Einschränkungen

Gateways für virtuelle Netzwerke (VNET) 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 für die 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-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.

Antworten

Name Typ Beschreibung
200 OK

OK

Beispiele

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

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example

Sample Request

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

Sample Response

Status code:
200

Example

Sample Request

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

Sample Response

Status code:
200

Definitionen

Name Beschreibung
DatasourceUser

Ein Power BI-Benutzer mit Zugriff auf die Datenquelle
DatasourceUserAccessRight

Das Zugriffsrecht (Berechtigungsstufe), über das ein Benutzer für die Datenquelle verfügt
PrincipalType

Der Prinzipaltyp
ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.

DatasourceUser

Ein Power BI-Benutzer mit Zugriff auf die Datenquelle

Name Typ Beschreibung
datasourceAccessRight

DatasourceUserAccessRight

Das Zugriffsrecht (Berechtigungsstufe), über das ein Benutzer für die 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-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.

DatasourceUserAccessRight

Das Zugriffsrecht (Berechtigungsstufe), über das ein Benutzer für die Datenquelle verfügt

Name Typ Beschreibung
None

string

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

string

Datasets im Besitz des Benutzers haben Lesezugriff auf die Datenquelle.
ReadOverrideEffectiveIdentity

string

Der Benutzer kann die effektive Identität für Power BI Embedded überschreiben. Gilt nur für lokale Analysis Services-Datenquellen.

PrincipalType

Der Prinzipaltyp

Name Typ Beschreibung
App

string

Dienstprinzipaltyp
Group

string

Gruppenprinzipaltyp
None

string

Kein Prinzipaltyp. Verwenden Sie für den Zugriff auf die gesamte organization ebene.
User

string

Benutzerprinzipaltyp

ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.

Name Typ Beschreibung
displayName

string

Der Dienstprinzipalprofilname
id

string

Die Dienstprinzipalprofil-ID