Admin - Dataflows GetDataflowsAsAdmin

Référence

Service:: Power BI REST APIs

Version d'API:: v1.0

Retourne une liste de dataflows pour l’organisation.

Autorisations

L’utilisateur doit être un administrateur Fabric 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 du service, une application ne doit pas disposer de prémissions requises par l’administrateur pour Power BI définies sur celui-ci dans le portail Azure.

Étendue requise

Tenant.Read.All ou Tenant.ReadWrite.All

Applicable uniquement lors de l’authentification via un jeton d’accès administrateur délégué standard. Ne doit pas être présent lorsque l’authentification via un principal de service est utilisée.

Limites

Maximum 200 requêtes par heure.

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

Avec des paramètres facultatifs:

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	Retourne un sous-ensemble de résultats basés sur condition de paramètre de requête de filtre Odata.
$skip	query	integer int32	Ignore les premiers n résultats
$top	query	integer int32	Retourne uniquement les premiers n résultats

Réponses

Nom	Type	Description
200 OK	AdminDataflows	D’ACCORD

Exemples

Example

Exemple de requête

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

Exemple de réponse

Code d’état:: 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 dataflow retourné par les API d’administration. Vous trouverez ci-dessous une liste de propriétés qui peuvent être retournées pour un dataflow. Seul un sous-ensemble des propriétés est 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 dataflows d’administration Power BI
DataflowUser	Entrée de droit d’accès utilisateur Power BI pour un dataflow
DataflowUserAccessRight	Droit d’accès dont dispose un utilisateur pour le dataflow (niveau d’autorisation)
PrincipalType	Type de principal
ServicePrincipalProfile	Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.

AdminDataflow

Métadonnées d’un dataflow retourné par les API d’administration. Vous trouverez ci-dessous une liste de propriétés qui peuvent être retournées pour un dataflow. Seul un sous-ensemble des propriétés est 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	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 dataflow
objectId	string	ID de flux de données
users	DataflowUser[]	(Valeur vide) Détails de l’accès de l’utilisateur du flux de données. Cette propriété sera supprimée de la réponse de charge utile dans une prochaine version. Vous pouvez récupérer des informations utilisateur sur un dataflow Power BI à l’aide de l'Obtenir des utilisateurs de dataflow en tant qu’appel d’API administrateur, ou l’appel d’API PostWorkspaceInfo avec le paramètre `getArtifactUser`.
workspaceId	string	ID de l’espace de travail dataflow.

AdminDataflows

Wrapper de réponse OData pour une collection de dataflows d’administration Power BI

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 dataflow

Nom	Type	Description
DataflowUserAccessRight	DataflowUserAccessRight	Droit d’accès dont dispose un utilisateur pour le dataflow (niveau d’autorisation)
displayName	string	Nom complet 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 de principal
profile	ServicePrincipalProfile	Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.
userType	string	Type de l’utilisateur.

DataflowUserAccessRight

Droit d’accès dont dispose un utilisateur pour le dataflow (niveau d’autorisation)

Nom	Type	Description
None	string	Supprime l’autorisation de contenu dans le flux de données
Owner	string	Accorde l’accès en lecture, écriture et partage à nouveau 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	Accorde l’accès en lecture et repartage au contenu dans le flux de données
ReadWrite	string	Octroie l’accès en lecture et écriture au contenu dans le flux de données

PrincipalType

Type de principal

Nom	Type	Description
App	string	Type de principal de service
Group	string	Type de principal de groupe
None	string	Aucun type de principal. Utiliser pour l’ensemble de l’accès au niveau de l’organisation.
User	string	Type de principal de l’utilisateur

ServicePrincipalProfile

Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.

Nom	Type	Description
displayName	string	Nom du profil du principal de service
id	string	ID de profil du principal de service

Partager via