Dataflows - Refresh Dataflow

Service:: Power BI REST APIs

Version d'API:: v1.0

Déclenche une actualisation pour le flux de données spécifié.

Les options de notification par e-mail prises en charge sont MailOnFailure et NoNotification. MailOnCompletion n’est pas pris en charge.

Permissions

Cet appel d’API peut être appelé par un profil de principal de service. Pour plus d’informations, consultez : Profils de principal de service dans Power BI Embedded.

Étendue requise

Dataflow.ReadWrite.All

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dataflows/{dataflowId}/refreshes

Avec des paramètres facultatifs:

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dataflows/{dataflowId}/refreshes?processType={processType}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
dataflowId	path	True	string (uuid)	ID de flux de données
groupId	path	True	string (uuid)	ID de l’espace de travail
processType	query		string	Type de processus d’actualisation à utiliser.

Corps de la demande

Nom	Obligatoire	Type	Description
notifyOption	True	NotifyOption	Options de notification par courrier électronique

Réponses

Nom	Type	Description
200 OK		Ok

Exemples

Example

Exemple de requête

POST https://api.powerbi.com/v1.0/myorg/groups/51e47fc5-48fd-4826-89f0-021bd3a80abd/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshes?processType=default

Corps de la demande

{
  "notifyOption": "MailOnFailure"
}

Exemple de réponse

Code d’état:: 200

Définitions

Nom	Description
NotifyOption	Options de notification par courrier électronique
RefreshRequest	Demande d’actualisation Power BI

NotifyOption

Énumération

Options de notification par courrier électronique

Valeur	Description
NoNotification	Aucune notification n’est envoyée
MailOnFailure	Une notification par courrier électronique sera envoyée lors de l’échec de l’actualisation
MailOnCompletion	Une notification par courrier indiquant la réussite ou l’échec sera envoyée lors de l’actualisation

RefreshRequest

Object

Demande d’actualisation Power BI

Nom	Type	Description
notifyOption	NotifyOption	Options de notification par courrier électronique

Partager via