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 |
---|---|---|---|---|
dataset
|
path | True |
string |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
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 |
Datasource |
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 |
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 |
Collection de sources de données |