Gateways - Get Datasource

Service:

Power BI REST APIs

API Version:

v1.0

Retourne la source de données spécifiée à partir de la passerelle spécifiée.

Autorisations

L’utilisateur doit disposer d’autorisations d’administrateur de passerelle.

Étendue requise

Dataset.ReadWrite.All ou Dataset.Read.All

Limites

Les passerelles de réseau virtuel (VNet) ne sont pas prises en charge.

GET https://api.powerbi.com/v1.0/myorg/gateways/{gatewayId}/datasources/{datasourceId}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
datasourceId	path	True	string uuid	ID de source de données
gatewayId	path	True	string uuid	ID de passerelle. Lorsque vous utilisez un cluster de passerelle, l’ID de passerelle fait référence à la passerelle principale (première) du cluster. Dans ce cas, l’ID de passerelle est similaire à l’ID de cluster de passerelle.

Réponses

Nom	Type	Description
200 OK	GatewayDatasource	Ok

Exemples

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970

Sample Response

Status code:

200

{
  "id": "252b9de8-d915-4788-aaeb-ec8c2395f970",
  "gatewayId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "datasourceType": "Sql",
  "connectionDetails": "{\"server\":\"MyServer\",\"database\":\"MyDatabase\"}",
  "credentialType": "Windows",
  "datasourceName": "Sample Datasource"
}

Définitions

Nom	Description
credentialType	Type d’informations d’identification de la source de données
GatewayDatasource	Une source de données de passerelle Power BI
GatewayDatasourceCredentialDetails	Détails des informations d’identification de la source de données

credentialType

Type d’informations d’identification de la source de données

Nom	Type	Description
Anonymous	string
Basic	string
Key	string
OAuth2	string
SAS	string
Windows	string

GatewayDatasource

Une source de données de passerelle Power BI

Nom	Type	Description
connectionDetails	string	Détails de connexion au format JSON
credentialDetails	GatewayDatasourceCredentialDetails	Détails de connexion pour la source de données qui a besoin d’une mise à jour. Les détails de connexion sont obligatoires lorsque le jeu de données a plusieurs sources de données.
credentialType	credentialType	Type d’informations d’identification de la source de données
datasourceName	string	Nom de la source de données.
datasourceType	string	Type de source de données. Nom de l’API pour la source de données Active Directory AdobeAnalytics AdoDotNet AnalysisServices AzureBlobs AzureDataLakeStorage AzureMarketplace AzureTables BizTalk CDPA CustomConnector CustomHttpApi DB2 Essbase Event Hub Excel Exchange Extension Facebook Fichier Dossier 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 de passerelle associé. Lorsque vous utilisez un cluster de passerelle, l’ID de passerelle fait référence à la passerelle principale (première) du cluster et est similaire à l’ID de cluster de passerelle.
id	string	ID unique de la source de données

GatewayDatasourceCredentialDetails

Détails des informations d’identification de la source de données

Nom	Type	Description
useEndUserOAuth2Credentials	boolean	Indique si l’identité Azure AD de l’utilisateur final (informations d’identification OAuth 2.0) est utilisée lors de la connexion à la source de données en mode DirectQuery. Utiliser avec des sources de données qui prennent en charge l’authentification unique (SSO).