Admin - Dataflows GetDataflowsAsAdmin

Référence

Service:: Power BI REST APIs

API Version:: v1.0

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

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows?$filter={$filter}&$top={$top}&$skip={$skip}

Paramètres URI

Nom	Dans	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	AdminDataflows	OK

Exemples

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows

Sample Response

Status code:: 200

{
  "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
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.
AdminDataflows	Wrapper de réponse OData pour une collection de flux de données Power BI Administration
DataflowUser	Entrée de droit d’accès utilisateur Power BI pour un flux de données
DataflowUserAccessRight	Droit d’accès d’un utilisateur au flux de données (niveau d’autorisation)
PrincipalType	Type principal
ServicePrincipalProfile	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	DataflowUser[]	(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 `getArtifactUser` paramètre.
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	AdminDataflow[]	Collection de rapports

DataflowUser

Entrée de droit d’accès utilisateur Power BI pour un flux de données

Nom	Type	Description
DataflowUserAccessRight	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	PrincipalType	Type principal
profile	ServicePrincipalProfile	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

Share via