Gateways - Get Datasource

Service:

Power BI REST APIs

API Version:

v1.0

Zwraca określone źródło 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/{datasourceId}

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
datasourceId	path	True	string uuid	Identyfikator źródła danych
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	GatewayDatasource	OK

Przykłady

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

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

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.