Gateways - Get Datasources

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

URI 參數

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

回應

名稱	類型	Description
200 OK	GatewayDatasources	確定

範例

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

定義

名稱	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[]	閘道資料來源的清單