Dataflows - Refresh Dataflow

Référence

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.

Autorisations

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	L’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

Enumeration

Options de notification par courrier électronique

Valeur	Description
MailOnCompletion	Une notification par courrier indiquant que la réussite ou l’échec est envoyé à la fin de l’actualisation
MailOnFailure	Une notification par courrier électronique est envoyée en cas d’échec de l’actualisation
NoNotification	Aucune notification n’est envoyée

RefreshRequest

Object

Demande d’actualisation Power BI

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

Partager via