共用方式為

Gateways - Get Datasources

服務:
Power BI REST APIs
API 版本:
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

範例要求

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

範例回覆

狀態碼:
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
Basic
Windows
Anonymous
OAuth2
Key
SAS

GatewayDatasource

Object

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 交換 擴充套件
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 網路
gatewayId

string (uuid)

相關聯的閘道標識碼。 使用閘道叢集時，閘道標識碼是指叢集中的主要（第一個）網關，類似於閘道叢集標識碼。
id

string (uuid)

數據源的唯一標識碼

GatewayDatasourceCredentialDetails

Object

數據源認證詳細數據

名稱 類型 Description
useEndUserOAuth2Credentials

boolean

在 DirectQuery 模式中連接到數據源時，是否使用使用者 Azure AD 身分識別 （OAuth 2.0 認證）。 與支援 單一登錄 （SSO）的數據源搭配使用。

GatewayDatasources

Object

Power BI 閘道數據源集合的 OData 回應包裝函式

名稱 類型 Description
@odata.context

string

OData 內容
value

GatewayDatasource[]

閘道資料源的清單