Admin - Datasets GetDatasourcesAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Gibt eine Liste der Datenquellen für das angegebene Dataset zurück.

Die Verarbeitung jeder Anforderung dauert 0,5 Sekunden, während der andere Anforderungen in die Warteschlange eingereiht werden.

Berechtigungen

• Der Benutzer muss über Administratorrechte (z. B. Office 365 globalen Administrator oder Power BI-Dienstadministrator) verfügen oder sich mithilfe eines Dienstprinzipals authentifizieren.
• Delegierte Berechtigungen werden unterstützt.

Bei der Ausführung unter dienstprinizipaler Authentifizierung dürfen für eine App keine erforderlichen Administratoreinwilligungsvoreinstellungen für Power BI im Azure-Portal festgelegt sein.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

Nur bei der Authentifizierung über ein standardmäßiges delegiertes Administratorzugriffstoken relevant. Darf nicht vorhanden sein, wenn die Authentifizierung über einen Dienstprinzipal verwendet wird.

GET https://api.powerbi.com/v1.0/myorg/admin/datasets/{datasetId}/datasources

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
datasetId	path	True	string

Antworten

Name	Typ	Beschreibung
200 OK	Datasources	OK

Beispiele

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/datasources

Sample Response

Status code:

200

{
  "value": [
    {
      "name": "301",
      "connectionString": "data source=MyServer.database.windows.net;initial catalog=MyDatabase;persist security info=True;encrypt=True;trustservercertificate=False",
      "datasourceType": "Sql",
      "datasourceId": "16a54ccd-620d-4af3-9197-0b8c779a9a6d",
      "gatewayId": "7f1c4e55-544b-403f-b132-da0d3a024674",
      "connectionDetails": {
        "server": "MyServer.database.windows.net",
        "database": "MyDatabase"
      }
    }
  ]
}

Definitionen

Name	Beschreibung
Datasource	Eine Power BI-Datenquelle
DatasourceConnectionDetails	Die Verbindungsdetails der Power BI-Datenquelle. Beispiele finden Sie unter Abrufen von Datenquellen oder Abrufen von Datenquellen in Gruppe.
Datasources	Der OData-Antwortwrapper für eine Power BI-Datenquellensammlung

Datasource

Eine Power BI-Datenquelle

Name	Typ	Beschreibung
connectionDetails	DatasourceConnectionDetails	Details zur Datenquellenverbindung
connectionString	string	(Veraltet) Die Datenquellenverbindungszeichenfolge. Nur für DirectQuery verfügbar.
datasourceId	string	Die gebundene Datenquellen-ID, die leer ist, wenn sie nicht an ein Gateway gebunden ist
datasourceType	string	Der Datenquellentyp
gatewayId	string	Die gebundene Gateway-ID, die leer ist, wenn sie nicht an ein Gateway gebunden ist. Bei Verwendung eines Gatewayclusters bezieht sich die Gateway-ID auf das primäre (erste) Gateway im Cluster und ähnelt der Gatewaycluster-ID.
name	string	(Veraltet) Der Name der Datenquelle. Nur für DirectQuery verfügbar.

DatasourceConnectionDetails

Die Verbindungsdetails der Power BI-Datenquelle. Beispiele finden Sie unter Abrufen von Datenquellen oder Abrufen von Datenquellen in Gruppe.

Name	Typ	Beschreibung
account	string	Das Verbindungskonto
classInfo	string	Informationen zur Verbindungsklasse
database	string	Die Verbindungsdatenbank
domain	string	Die Verbindungsdomäne
emailAddress	string	Die Verbindungs-E-Mail-Adresse
kind	string	Die Verbindungsart
loginServer	string	Verbindungsanmeldungsserver
path	string	Der Verbindungspfad
server	string	Der Verbindungsserver
url	string	Die Verbindungs-URL

Datasources

Der OData-Antwortwrapper für eine Power BI-Datenquellensammlung

Name	Typ	Beschreibung
odata.context	string	OData-Kontext
value	Datasource[]	Die Datenquellensammlung