Gateways - Get Datasource

Service:

Power BI REST APIs

API Version:

v1.0

從指定的閘道傳回指定的資料來源。

權限

使用者必須具有閘道管理員許可權。

必要範圍

Dataset.ReadWrite.All 或 Dataset.Read.All

限制

不支援虛擬網路 (VNet) 閘道。

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

URI 參數

名稱	位於	必要	類型	Description
datasourceId	path	True	string uuid	資料來源識別碼
gatewayId	path	True	string uuid	閘道識別碼。 使用閘道叢集時，閘道識別碼是指叢集中第一個) 閘道的主要 (。 在這種情況下，閘道識別碼類似于閘道叢集識別碼。

回應

名稱	類型	Description
200 OK	GatewayDatasource	確定

範例

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

定義

名稱	Description
credentialType	資料來源認證的類型
GatewayDatasource	Power BI 閘道資料來源
GatewayDatasourceCredentialDetails	資料來源認證詳細資料

credentialType

資料來源認證的類型

名稱	類型	Description
Anonymous	string
Basic	string
Key	string
OAuth2	string
SAS	string
Windows	string

GatewayDatasource

Power BI 閘道資料來源

名稱	類型	Description
connectionDetails	string	JSON 格式的連線詳細資料
credentialDetails	GatewayDatasourceCredentialDetails	需要更新之資料來源的連接詳細資料。 當資料集有多個資料來源時，連線詳細資料是必要的。
credentialType	credentialType	資料來源認證的類型
datasourceName	string	資料來源的名稱。
datasourceType	string	資料來源的類型。 資料來源的 API 名稱 ActiveDirectory AdobeAnalytics AdoDotNet AnalysisServices AzureBlobs AzureDataLakeStorage AzureMarketplace AzureTables BizTalk CDPA CustomConnector CustomHttpApi DB2 Essbase EventHub Excel Exchange 副檔名 Facebook 檔案 資料夾 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 Web
gatewayId	string	相關聯的閘道識別碼。 使用閘道叢集時，閘道識別碼是指叢集中第一個) 閘道的主要 (，類似于閘道叢集識別碼。
id	string	資料來源的唯一識別碼

GatewayDatasourceCredentialDetails

資料來源認證詳細資料

名稱	類型	Description
useEndUserOAuth2Credentials	boolean	在 DirectQuery 模式中連接到資料來源時，是否使用終端使用者 Azure AD 身分識別 (OAuth 2.0 認證) 。 搭配支援 單一登入 (SSO) 的資料來源使用。