Gateways - Get Datasource Users

Service:

Power BI REST APIs

API Version:

v1.0

Gibt eine Liste der Benutzer zurück, die Zugriff auf die angegebene Datenquelle haben.

Berechtigungen

Der Benutzer muss über Gatewayadministratorberechtigungen verfügen.

Erforderlicher Bereich

Dataset.ReadWrite.All oder Dataset.Read.All

Einschränkungen

Gateways für virtuelle Netzwerke (VNET) werden nicht unterstützt.

GET 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.

Antworten

Name	Typ	Beschreibung
200 OK	DatasourceUsers	OK

Beispiele

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users

Sample Response

Status code:

200

{
  "value": [
    {
      "datasourceAccessRight": "Read",
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "identifier": "john@contoso.com",
      "principalType": "User"
    },
    {
      "datasourceAccessRight": "ReadOverrideEffectiveIdentity",
      "displayName": "ContosoTestApp",
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App"
    }
  ]
}

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
DatasourceUsers	Der OData-Antwortwrapper für eine Liste von Power BI-Benutzern mit Zugriff auf eine Datenquelle
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.

DatasourceUsers

Der OData-Antwortwrapper für eine Liste von Power BI-Benutzern mit Zugriff auf eine Datenquelle

Name	Typ	Beschreibung
odata.context	string
value	DatasourceUser[]	Die Liste der Benutzer mit Zugriff auf eine Datenquelle

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