Gateways - Get Datasource
Gibt die angegebene Datenquelle vom angegebenen Gateway zurück.
Erlaubnisse
Der Benutzer muss über Gatewayadministratorberechtigungen verfügen.
Erforderlicher Bereich
Dataset.ReadWrite.All oder Dataset.Read.All
Einschränkungen
VNet-Gateways (Virtual Network) werden nicht unterstützt.
GET https://api.powerbi.com/v1.0/myorg/gateways/{gatewayId}/datasources/{datasourceId}
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
datasource
|
path | True |
string (uuid) |
Die Datenquellen-ID |
|
gateway
|
path | True |
string (uuid) |
Die Gateway-ID. Bei Verwendung eines Gatewayclusters bezieht sich die Gateway-ID auf das primäre (erste) Gateway im Cluster. In solchen Fällen ähnelt die Gateway-ID der Gatewaycluster-ID. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
OKAY |
Beispiele
Example
Beispielanforderung
GET https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970
Beispiel für eine Antwort
{
"id": "252b9de8-d915-4788-aaeb-ec8c2395f970",
"gatewayId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
"datasourceType": "Sql",
"connectionDetails": "{\"server\":\"MyServer\",\"database\":\"MyDatabase\"}",
"credentialType": "Windows",
"datasourceName": "Sample Datasource"
}
Definitionen
| Name | Beschreibung |
|---|---|
|
credential |
Der Typ der Datenquelle Anmeldeinformationen |
|
Gateway |
Eine Power BI-Gatewaydatenquelle |
|
Gateway |
Die Details der Datenquellenanmeldeinformationen |
credentialType
Der Typ der Datenquelle Anmeldeinformationen
| Wert | Beschreibung |
|---|---|
| Basic | |
| Windows | |
| Anonymous | |
| OAuth2 | |
| Key | |
| SAS |
GatewayDatasource
Eine Power BI-Gatewaydatenquelle
| Name | Typ | Beschreibung | |||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| connectionDetails |
string |
Verbindungsdetails im JSON-Format |
|||||||||||||||||||||||||||||||||||||||||||||||||||
| credentialDetails |
Die Verbindungsdetails für die Datenquelle, die aktualisiert werden muss. Die Verbindungsdetails sind obligatorisch, wenn das Dataset mehr als eine Datenquelle aufweist. |
||||||||||||||||||||||||||||||||||||||||||||||||||||
| credentialType |
Der Typ der Datenquelle Anmeldeinformationen |
||||||||||||||||||||||||||||||||||||||||||||||||||||
| datasourceName |
string |
Der Name der Datenquelle |
|||||||||||||||||||||||||||||||||||||||||||||||||||
| datasourceType |
string |
Der Typ der Datenquelle.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
| gatewayId |
string (uuid) |
Die zugeordnete Gateway-ID. Bei Verwendung eines Gatewayclusters bezieht sich die Gateway-ID auf das primäre (erste) Gateway im Cluster und ähnelt der Gatewaycluster-ID. |
|||||||||||||||||||||||||||||||||||||||||||||||||||
| id |
string (uuid) |
Die eindeutige ID für die Datenquelle |
GatewayDatasourceCredentialDetails
Die Details der Datenquellenanmeldeinformationen
| Name | Typ | Beschreibung |
|---|---|---|
| useEndUserOAuth2Credentials |
boolean |
Gibt an, ob die Azure AD-Identität (OAuth 2.0-Anmeldeinformationen) des Endbenutzers beim Herstellen einer Verbindung mit der Datenquelle im DirectQuery-Modus verwendet wird. Wird mit Datenquellen verwendet, die einmaliges Anmelden (Single Sign-On, SSO)unterstützen. |