Admin - Dataflows GetDataflowsAsAdmin
Retourne une liste de flux de données pour l’organisation.
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/dataflows
GET https://api.powerbi.com/v1.0/myorg/admin/dataflows?$filter={$filter}&$top={$top}&$skip={$skip}
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
$filter
|
query |
string |
Filtre les résultats, en fonction d’une condition booléenne |
|
$skip
|
query |
integer int32 |
Ignore les n premiers résultats |
|
$top
|
query |
integer int32 |
Retourne uniquement les n premiers résultats |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
OK |
Exemples
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/dataflows
Sample Response
{
"value": [
{
"objectId": "bd32e5c0-363f-430b-a03b-5535a4804b9b",
"name": "AdventureWorks",
"description": "Our Adventure Works",
"modelUrl": "https://MyDataflowStorageAccount.dfs.core.windows.net/powerbi/contoso/AdventureWorks/model.json",
"configuredBy": "john@contoso.com",
"workspaceId": "6369a442-4bc4-425c-916d-460c42be746b"
}
]
}
Définitions
Nom | Description |
---|---|
Admin |
Métadonnées d’un flux de données retournés par Administration API. Vous trouverez ci-dessous la liste des propriétés qui peuvent être retournées pour un flux de données. Seul un sous-ensemble des propriétés sera retourné en fonction de l’API appelée, des autorisations de l’appelant et de la disponibilité des données dans la base de données Power BI. |
Admin |
Wrapper de réponse OData pour une collection de flux de données Power BI Administration |
Dataflow |
Entrée de droit d’accès utilisateur Power BI pour un flux de données |
Dataflow |
Droit d’accès d’un utilisateur au flux de données (niveau d’autorisation) |
Principal |
Type principal |
Service |
Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire. |
AdminDataflow
Métadonnées d’un flux de données retournés par Administration API. Vous trouverez ci-dessous la liste des propriétés qui peuvent être retournées pour un flux de données. Seul un sous-ensemble des propriétés sera retourné en fonction de l’API appelée, des autorisations de l’appelant et de la disponibilité des données dans la base de données Power BI.
Nom | Type | Description |
---|---|---|
configuredBy |
string |
Propriétaire du flux de données |
description |
string |
Description du flux de données |
modelUrl |
string |
URL du fichier de définition de flux de données (model.json) |
modifiedBy |
string |
L’utilisateur qui a modifié le flux de données |
modifiedDateTime |
string |
Date et heure de la dernière modification du flux de données |
name |
string |
Nom du flux de données |
objectId |
string |
ID de flux de données |
users |
(Valeur vide) Détails de l’accès de l’utilisateur au flux de données. Cette propriété sera supprimée de la réponse de charge utile dans une version à venir. Vous pouvez récupérer des informations utilisateur sur un flux de données Power BI à l’aide de l’appel d’API Get Dataflow Users as Administration, ou de l’appel d’API PostWorkspaceInfo avec le |
|
workspaceId |
string |
ID d’espace de travail de flux de données. |
AdminDataflows
Wrapper de réponse OData pour une collection de flux de données Power BI Administration
Nom | Type | Description |
---|---|---|
odata.context |
string |
Contexte OData |
value |
Collection de rapports |
DataflowUser
Entrée de droit d’accès utilisateur Power BI pour un flux de données
Nom | Type | Description |
---|---|---|
DataflowUserAccessRight |
Droit d’accès d’un utilisateur au flux de données (niveau d’autorisation) |
|
displayName |
string |
Nom d’affichage du principal |
emailAddress |
string |
Adresse e-mail de l’utilisateur |
graphId |
string |
Identificateur du principal dans Microsoft Graph. Disponible uniquement pour les API d’administration. |
identifier |
string |
Identificateur du principal |
principalType |
Type principal |
|
profile |
Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire. |
|
userType |
string |
Type de l’utilisateur. |
DataflowUserAccessRight
Droit d’accès d’un utilisateur au flux de données (niveau d’autorisation)
Nom | Type | Description |
---|---|---|
None |
string |
Supprime l’autorisation d’accès au contenu dans le flux de données |
Owner |
string |
Octroie l’accès en lecture, écriture et repartage au contenu dans le flux de données |
Read |
string |
Octroie l’accès en lecture au contenu dans le flux de données |
ReadReshare |
string |
Octroie l’accès en lecture et repartage au contenu dans le flux de données |
ReadWrite |
string |
Octroie l’accès en lecture et en écriture au contenu dans le flux de données |
PrincipalType
Type principal
Nom | Type | Description |
---|---|---|
App |
string |
Type de principal de service |
Group |
string |
Type de principal de groupe |
None |
string |
Aucun type principal. Utilisez pour l’accès au niveau de l’organisation entière. |
User |
string |
Type de principal d’utilisateur |
ServicePrincipalProfile
Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.
Nom | Type | Description |
---|---|---|
displayName |
string |
Nom du profil principal de service |
id |
string |
ID de profil du principal de service |