Gateways - Get Datasource

Service:

Power BI REST APIs

API Version:

v1.0

Gibt die angegebene Datenquelle aus dem angegebenen Gateway zurück.

Berechtigungen

Der Benutzer muss über Gatewayadministratorberechtigungen verfügen.

Erforderlicher Bereich

Dataset.ReadWrite.All oder Dataset.Read.All

Einschränkungen

Virtuelle Netzwerk-Gateways (VNet) werden nicht unterstützt.

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

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 verweist 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	GatewayDatasource	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

Sample Response

Status code:

200

{
  "id": "252b9de8-d915-4788-aaeb-ec8c2395f970",
  "gatewayId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "datasourceType": "Sql",
  "connectionDetails": "{\"server\":\"MyServer\",\"database\":\"MyDatabase\"}",
  "credentialType": "Windows",
  "datasourceName": "Sample Datasource"
}

Definitionen

Name	Beschreibung
credentialType	Der Datentyp der Datenquellenanmeldeinformationen
GatewayDatasource	Eine Power BI-Gateway-Datenquelle
GatewayDatasourceCredentialDetails	Details zu den Anmeldeinformationen der Datenquelle

credentialType

Der Datentyp der Datenquellenanmeldeinformationen

Name	Typ	Beschreibung
Anonymous	string
Basic	string
Key	string
OAuth2	string
SAS	string
Windows	string

GatewayDatasource

Eine Power BI-Gateway-Datenquelle

Name	Typ	Beschreibung
connectionDetails	string	Verbindungsdetails im JSON-Format
credentialDetails	GatewayDatasourceCredentialDetails	Die Verbindungsdetails für die Datenquelle, die Aktualisierung benötigt. Die Verbindungsdetails sind obligatorisch, wenn das Dataset mehr als eine Datenquelle aufweist.
credentialType	credentialType	Der Datentyp der Datenquellenanmeldeinformationen
datasourceName	string	Der Name der Datenquelle.
datasourceType	string	Der Datentyp der Datenquelle. API-Name für die Datenquelle ActiveDirectory AdobeAnalytics AdoDotNet AnalysisServices AzureBlobs AzureDataLakeStorage AzureMarketplace AzureTables BizTalk CDPA CustomConnector CustomHttpApi DB2 Essbase EventHub Excel Exchange Erweiterung Facebook Datei Ordner GoogleAnalytics Hdfs HDInsight Informix MQ MySQL OData ODBC OLEDB Oracle PostgreSQL PowerQueryMashup PubNub Salesforce SAPBW SAPBWMessageServer SapErp SAPHana SharePoint SharePointDocLib SharePointList Sql Sybase Teradata UIFlow Web
gatewayId	string	Die zugeordnete Gateway-ID. Bei Verwendung eines Gatewayclusters verweist die Gateway-ID auf das primäre (erste) Gateway im Cluster und ähnelt der Gatewaycluster-ID.
id	string	Die eindeutige ID für die Datenquelle

GatewayDatasourceCredentialDetails

Details zu den Anmeldeinformationen der Datenquelle

Name	Typ	Beschreibung
useEndUserOAuth2Credentials	boolean	Ob die Azure AD-Identität (OAuth 2.0-Anmeldeinformationen) beim Herstellen einer Verbindung mit der Datenquelle im DirectQuery-Modus verwendet wird. Verwenden Sie mit Datenquellen, die single sign-on (SSO) unterstützen.