Partager via

Gateways - Get Datasources

Service:
Power BI REST APIs
Version d'API:
v1.0

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

D’ACCORD

Exemples

Example

Exemple de requête

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

Exemple de réponse

Code d’état:
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 de source de données informations d’identification
GatewayDatasource

Une 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

Énumération

Type de source de données informations d’identification

Valeur Description
Basic
Windows
Anonymous
OAuth2
Key
SAS

GatewayDatasource

Object

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 de la source de données qui a besoin de la mise à jour. Les détails de connexion sont obligatoires lorsque le jeu de données possède plusieurs sources de données.
credentialType

credentialType

Type de source de données informations d’identification
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
ActiveDirectory AdobeAnalytics AdoDotNet
AnalysisServices AzureBlobs AzureDataLakeStorage
AzureMarketplace AzureTables BizTalk
CDPA CustomConnector CustomHttpApi
DB2 Essbase EventHub
Excel Échange 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 le Web
gatewayId

string (uuid)

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 (uuid)

ID unique de la source de données

GatewayDatasourceCredentialDetails

Object

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 'authentification unique (SSO).

GatewayDatasources

Object

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