Gateways - Get Datasource
從指定的閘道傳回指定的數據來源。
權限
用戶必須具有閘道管理員許可權。
必要範圍
Dataset.ReadWrite.All 或 Dataset.Read.All
局限性
不支援虛擬網路 (VNet) 閘道。
GET https://api.powerbi.com/v1.0/myorg/gateways/{gatewayId}/datasources/{datasourceId}
URI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
datasource
|
path | True |
string (uuid) |
數據源標識碼 |
|
gateway
|
path | True |
string (uuid) |
閘道識別碼。 使用閘道叢集時,閘道標識碼是指叢集中的主要 (第一個) 網關。 在這種情況下,閘道標識碼類似於閘道叢集標識碼。 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 200 OK |
還行 |
範例
Example
範例要求
GET https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970
範例回覆
{
"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 |
|---|---|
|
credential |
數據源類型 認證 |
|
Gateway |
Power BI 閘道數據源 |
|
Gateway |
數據源認證詳細數據 |
credentialType
數據源類型 認證
| 值 | Description |
|---|---|
| Basic | |
| Windows | |
| Anonymous | |
| OAuth2 | |
| Key | |
| SAS |
GatewayDatasource
Power BI 閘道數據源
| 名稱 | 類型 | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| connectionDetails |
string |
JSON 格式的連線詳細數據 |
|||||||||||||||||||||||||||||||||||||||||||||||||||
| credentialDetails |
需要更新之數據源的連接詳細數據。 當數據集有多個數據源時,連線詳細數據是必要的。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||
| credentialType |
數據源類型 認證 |
||||||||||||||||||||||||||||||||||||||||||||||||||||
| datasourceName |
string |
數據源的名稱 |
|||||||||||||||||||||||||||||||||||||||||||||||||||
| datasourceType |
string |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
| gatewayId |
string (uuid) |
相關聯的閘道標識碼。 使用閘道叢集時,閘道標識碼是指叢集中的主要(第一個)網關,類似於閘道叢集標識碼。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||
| id |
string (uuid) |
數據源的唯一標識碼 |
GatewayDatasourceCredentialDetails
數據源認證詳細數據
| 名稱 | 類型 | Description |
|---|---|---|
| useEndUserOAuth2Credentials |
boolean |
在 DirectQuery 模式中連接到數據源時,是否使用使用者 Azure AD 身分識別 (OAuth 2.0 認證)。 與支援 單一登錄 (SSO)的數據源搭配使用。 |