Datasets - Get Gateway Datasources

Service:

Power BI REST APIs

API Version:

v1.0

從 [ 我的工作區] 傳回指定資料集的閘道資料來源清單。

重要

此 API 呼叫已被取代，請改用 Get Datasources 。

必要範圍

Dataset.ReadWrite.All 或 Dataset.Read.All

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/Default.GetBoundGatewayDatasources

URI 參數

名稱	位於	必要	類型	Description
datasetId	path	True	string	資料集識別碼

回應

名稱	類型	Description
200 OK	GatewayDatasources	確定

範例

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.GetBoundGatewayDatasources

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "16a54ccd-620d-4af3-9197-0b8c779a9a6d",
      "gatewayId": "7f1c4e55-544b-403f-b132-da0d3a024674",
      "datasourceType": "Sql",
      "connectionDetails": "{\"server\":\"MyServer.database.windows.net\",\"database\":\"MyDatabase\"}"
    }
  ]
}

定義

名稱	Description
credentialType	資料來源認證的類型
GatewayDatasource	Power BI 閘道資料來源
GatewayDatasourceCredentialDetails	資料來源認證詳細資料
GatewayDatasources	Power BI 閘道資料來源集合的 OData 回應包裝函式

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) 。

GatewayDatasources

Power BI 閘道資料來源集合的 OData 回應包裝函式

名稱	類型	Description
odata.context	string	OData 內容
value	GatewayDatasource[]	閘道資料來源的清單