Datasets - Get Gateway Datasources

Dienst:: Power BI REST APIs

API-Version:: v1.0

Gibt eine Liste von Gatewaydatenquellen für das angegebene Semantikmodell zurück. Das Semantikmodell kann sich im Arbeitsbereich "Mein Arbeitsbereich" oder in einem anderen Arbeitsbereich befinden, vorausgesetzt, der Aufrufer verfügt über die erforderlichen Berechtigungen.

Wichtig

Dieser API-Aufruf ist veraltet, verwenden Sie stattdessen Get Datasources.

Erforderlicher Bereich

Dataset.ReadWrite.All oder Dataset.Read.All

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/Default.GetBoundGatewayDatasources

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
datasetId	path	True	string	Die Dataset-ID

Antworten

Name	Typ	Beschreibung
200 OK	GatewayDatasources	OKAY

Beispiele

Example

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "id": "16a54ccd-620d-4af3-9197-0b8c779a9a6d",
      "gatewayId": "7f1c4e55-544b-403f-b132-da0d3a024674",
      "datasourceType": "Sql",
      "connectionDetails": "{\"server\":\"MyServer.database.windows.net\",\"database\":\"MyDatabase\"}"
    }
  ]
}

Definitionen

Name	Beschreibung
credentialType	Der Typ der Datenquelle Anmeldeinformationen
GatewayDatasource	Eine Power BI-Gatewaydatenquelle
GatewayDatasourceCredentialDetails	Die Details der Datenquellenanmeldeinformationen
GatewayDatasources	Der OData-Antwortwrapper für eine Power BI-Gateway-Datenquellensammlung

credentialType

Enumeration

Der Typ der Datenquelle Anmeldeinformationen

Wert	Beschreibung
Basic
Windows
Anonymous
OAuth2
Key
SAS
KeyPair

GatewayDatasource

Objekt

Eine Power BI-Gatewaydatenquelle

Name

Typ

Beschreibung

connectionDetails

string

Verbindungsdetails im JSON-Format

credentialDetails

GatewayDatasourceCredentialDetails

Die Verbindungsdetails für die Datenquelle, die aktualisiert werden muss. Die Verbindungsdetails sind obligatorisch, wenn das Dataset mehr als eine Datenquelle aufweist.

credentialType

Der Typ der Datenquelle Anmeldeinformationen

datasourceName

string

Der Name der Datenquelle

datasourceType

string

Der Typ der Datenquelle.

API-Name für die Datenquelle
ActiveDirectory	AdobeAnalytics	AdoDotNet
AnalysisServices	AzureBlobs	AzureDataLakeStorage
AzureMarketplace	AzureTables	BizTalk
CDPA	CustomConnector	CustomHttpApi
DB2	Essbase	EventHub
Excel	Umtausch	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	das Internet

gatewayId

string (uuid)

Die zugeordnete Gateway-ID. Bei Verwendung eines Gatewayclusters bezieht sich die Gateway-ID auf das primäre (erste) Gateway im Cluster und ähnelt der Gatewaycluster-ID.

string (uuid)

Die eindeutige ID für die Datenquelle

GatewayDatasourceCredentialDetails

Objekt

Die Details der Datenquellenanmeldeinformationen

Name	Typ	Beschreibung
useEndUserOAuth2Credentials	boolean	Gibt an, ob die Azure AD-Identität (OAuth 2.0-Anmeldeinformationen) des Endbenutzers beim Herstellen einer Verbindung mit der Datenquelle im DirectQuery-Modus verwendet wird. Wird mit Datenquellen verwendet, die einmaliges Anmelden (Single Sign-On, SSO)unterstützen.

GatewayDatasources

Objekt

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

Name	Typ	Beschreibung
@odata.context	string	OData-Kontext
value	GatewayDatasource[]	Die Liste der Gatewaydatenquellen