Freigeben über

Gateways - Get Datasources

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

Gibt eine Liste von Datenquellen aus dem angegebenen Gateway zurück.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
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

GatewayDatasources

OKAY

Beispiele

Example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "id": "252b9de8-d915-4788-aaeb-ec8c2395f970",
      "gatewayId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
      "datasourceType": "Sql",
      "connectionDetails": "{\"server\":\"localSQL\",\"database\":\"salesDB\"}",
      "credentialType": "Windows",
      "datasourceName": "SQL Datasource"
    },
    {
      "id": "91f8aec2-4b32-476f-909b-3241999620ec",
      "gatewayId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
      "datasourceType": "AnalysisServices",
      "connectionDetails": "{\"server\":\"localAS\",\"database\":\"marketingDB\"}",
      "credentialType": "Windows",
      "datasourceName": "AS Datasource"
    }
  ]
}

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

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

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