Admin - Datasets GetDatasourcesAsAdmin

Retourne une liste de sources de données pour le jeu de données spécifié.

Le traitement de chaque requête prend 0,5 seconde, période pendant laquelle d’autres demandes sont mises en file d’attente.

Autorisations

  • L’utilisateur doit disposer de droits d’administrateur (tels que Office 365 administrateur général ou administrateur de service Power BI) ou s’authentifier à l’aide d’un principal de service.
  • Les autorisations déléguées sont prises en charge.

Lors de l’exécution sous l’authentification prinicipal de service, une application ne doit pas avoir de prémissions requises de consentement administrateur pour Power BI définies sur elle dans le Portail Azure.

Étendue requise

Tenant.Read.All ou Tenant.ReadWrite.All

Pertinent uniquement lors de l’authentification via un jeton d’accès administrateur délégué standard. Ne doit pas être présent lors de l’utilisation de l’authentification via un principal de service.

GET https://api.powerbi.com/v1.0/myorg/admin/datasets/{datasetId}/datasources

Paramètres URI

Nom Dans Obligatoire Type Description
datasetId
path True

string

Réponses

Nom Type Description
200 OK

Datasources

OK

Exemples

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/datasources

Sample Response

{
  "value": [
    {
      "name": "301",
      "connectionString": "data source=MyServer.database.windows.net;initial catalog=MyDatabase;persist security info=True;encrypt=True;trustservercertificate=False",
      "datasourceType": "Sql",
      "datasourceId": "16a54ccd-620d-4af3-9197-0b8c779a9a6d",
      "gatewayId": "7f1c4e55-544b-403f-b132-da0d3a024674",
      "connectionDetails": {
        "server": "MyServer.database.windows.net",
        "database": "MyDatabase"
      }
    }
  ]
}

Définitions

Nom Description
Datasource

Une source de données Power BI

DatasourceConnectionDetails

Détails de connexion à la source de données Power BI. Consultez des exemples dans Obtenir des sources de données ou Obtenir des sources de données dans un groupe.

Datasources

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

Datasource

Une source de données Power BI

Nom Type Description
connectionDetails

DatasourceConnectionDetails

Détails de connexion à la source de données

connectionString

string

(Déconseillé) Chaîne de connexion à la source de données. Disponible uniquement pour DirectQuery.

datasourceId

string

ID de source de données liée, qui est vide lorsqu’il n’est pas lié à une passerelle

datasourceType

string

Type de source de données

gatewayId

string

ID de passerelle liée, qui est vide lorsqu’il n’est pas lié à une 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 et est similaire à l’ID de cluster de passerelle.

name

string

(Déconseillé) Nom de la source de données. Disponible uniquement pour DirectQuery.

DatasourceConnectionDetails

Détails de connexion à la source de données Power BI. Consultez des exemples dans Obtenir des sources de données ou Obtenir des sources de données dans un groupe.

Nom Type Description
account

string

Compte de connexion

classInfo

string

Informations sur la classe de connexion

database

string

Base de données de connexion

domain

string

Domaine de connexion

emailAddress

string

Adresse e-mail de connexion

kind

string

Type de connexion

loginServer

string

Serveur de connexion

path

string

Chemin de connexion

server

string

Serveur de connexion

url

string

URL de connexion

Datasources

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

Nom Type Description
odata.context

string

Contexte OData

value

Datasource[]

Collection de sources de données