Gateways - Get Datasources

Service:

Power BI REST APIs

API Version:

v1.0

Retourne une liste de sources de données à 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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
gatewayId	path	True	string uuid	ID de passerelle. Lors de l’utilisation d’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	GatewayDatasources	Ok

Exemples

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

Définitions

Nom	Description
credentialType	Type d’informations d’identification de source de données
GatewayDatasource	Source de données de passerelle Power BI
GatewayDatasourceCredentialDetails	Détails des informations d’identification de la source de données
GatewayDatasources	Wrapper de réponse OData pour une collection de sources de données de passerelle Power BI

credentialType

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

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

GatewayDatasource

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 de 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 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é. Lors de l’utilisation d’un cluster de passerelle, l’ID de passerelle fait référence à la passerelle primaire (première) du cluster et est similaire à l’ID de cluster de passerelle.
id	string	ID unique pour 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. Utilisez des sources de données qui prennent en charge l’authentification unique (SSO).

GatewayDatasources

Wrapper de réponse OData pour une collection de sources de données de passerelle Power BI

Nom	Type	Description
odata.context	string	Contexte OData
value	GatewayDatasource[]	Liste des sources de données de passerelle