Gateways - Get Datasources

Usługa:

Power BI REST APIs

Wersja interfejsu API:

v1.0

Zwraca listę źródeł danych z określonej bramy.

Uprawnienia

Użytkownik musi mieć uprawnienia administratora bramy.

Wymagany zakres

Dataset.ReadWrite.All lub Dataset.Read.All

Ograniczenia

Bramy sieci wirtualnej nie są obsługiwane.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
gatewayId	path	True	string (uuid)	Identyfikator bramy. W przypadku korzystania z klastra bramy identyfikator bramy odwołuje się do bramy podstawowej (pierwszej) w klastrze. W takich przypadkach identyfikator bramy jest podobny do identyfikatora klastra bramy.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	GatewayDatasources	OK

Przykłady

Example

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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"
    }
  ]
}

Definicje

Nazwa	Opis
credentialType	Typ źródła danych poświadczeń
GatewayDatasource	Źródło danych bramy usługi Power BI
GatewayDatasourceCredentialDetails	Szczegóły poświadczeń źródła danych
GatewayDatasources	Otoka odpowiedzi OData dla kolekcji źródeł danych bramy usługi Power BI

credentialType

Wyliczanie

Typ źródła danych poświadczeń

Wartość	Opis
Basic
Windows
Anonymous
OAuth2
Key
SAS

GatewayDatasource

Objekt

Źródło danych bramy usługi Power BI

Nazwa	Typ	Opis
connectionDetails	string	Szczegóły połączenia w formacie JSON
credentialDetails	GatewayDatasourceCredentialDetails	Szczegóły połączenia dla źródła danych, które wymaga aktualizacji. Szczegóły połączenia są obowiązkowe, gdy zestaw danych ma więcej niż jedno źródło danych.
credentialType	credentialType	Typ źródła danych poświadczeń
datasourceName	string	Nazwa źródła danych
datasourceType	string	Typ źródła danych . Nazwa interfejsu API dla źródła danych ActiveDirectory AdobeAnalytics AdoDotNet AnalysisServices AzureBlobs AzureDataLakeStorage AzureMarketplace AzureTables BizTalk CDPA CustomConnector CustomHttpApi DB2 Essbase EventHub Excel Wymiana Rozszerzenie Facebook Plik Folder GoogleAnalytics Hdfs HDInsight Informix MQ MySql OData ODBC OleDb Oracle PostgreSql PowerQueryMashup PubNub Salesforce SAPBW SAPBWMessageServer SapErp SAPHana SharePoint SharePointDocLib Lista programu SharePoint SQL Sybase Teradata UIFlow sieć Web
gatewayId	string (uuid)	Skojarzony identyfikator bramy. W przypadku korzystania z klastra bramy identyfikator bramy odnosi się do bramy podstawowej (pierwszej) w klastrze i jest podobny do identyfikatora klastra bramy.
id	string (uuid)	Unikatowy identyfikator źródła danych

GatewayDatasourceCredentialDetails

Objekt

Szczegóły poświadczeń źródła danych

Nazwa	Typ	Opis
useEndUserOAuth2Credentials	boolean	Określa, czy tożsamość usługi Azure AD użytkownika końcowego (poświadczenia OAuth 2.0) jest używana podczas nawiązywania połączenia ze źródłem danych w trybie DirectQuery. Używanie z źródłami danych obsługującymi logowanie jednokrotne (SSO).

GatewayDatasources

Objekt

Otoka odpowiedzi OData dla kolekcji źródeł danych bramy usługi Power BI

Nazwa	Typ	Opis
@odata.context	string	Kontekst OData
value	GatewayDatasource[]	Lista źródeł danych bramy