Gateways - Get Datasources

Service:

Power BI REST APIs

API Version:

v1.0

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

Uprawnienia

Użytkownik musi mieć uprawnienia administratora bramy.

Zakres wymagany

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

Sample Request

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

Sample Response

Status code:

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 poświadczeń źródła danych
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

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

Nazwa	Typ	Opis
Anonymous	string
Basic	string
Key	string
OAuth2	string
SAS	string
Windows	string

GatewayDatasource

Ź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 poświadczeń źródła danych
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 Exchange Wewnętrzny 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 Internet
gatewayId	string	Skojarzony identyfikator bramy. W przypadku korzystania z klastra bramy identyfikator bramy odwołuje się do podstawowej (pierwszej) bramy w klastrze i jest podobny do identyfikatora klastra bramy.
id	string	Unikatowy identyfikator źródła danych

GatewayDatasourceCredentialDetails

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

Nazwa	Typ	Opis
useEndUserOAuth2Credentials	boolean	Określa, czy tożsamość użytkownika końcowego Azure AD (poświadczenia protokołu 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, które obsługują logowanie jednokrotne.

GatewayDatasources

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