Freigeben über

Gateways - Get Datasource Users

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

Gibt eine Liste von Benutzern zurück, die Zugriff auf die angegebene Datenquelle haben.

Erlaubnisse

Der Benutzer muss über Gatewayadministratorberechtigungen verfügen.

Erforderlicher Bereich

Dataset.ReadWrite.All oder Dataset.Read.All

Einschränkungen

VNet-Gateways (Virtual Network) 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

OKAY

Beispiele

Example

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
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 in der 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-Dienstprinzipalprofil. Nur für Power BI Embedded Mandantenlösung relevant.

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 Mandantenlösung relevant.

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.

DatasourceUsers

Objekt

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

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 Mandantenlösung relevant.

Name Typ Beschreibung
displayName

string

Der Dienstprinzipalprofilname
id

string (uuid)

Die Dienstprinzipalprofil-ID