Dataflows - Refresh Dataflow

Service:

Power BI REST APIs

API Version:

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

With optional parameters:

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 uuid	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

Sample Request

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

Request Body

{
  "notifyOption": "MailOnFailure"
}

Sample Response

Status code:

200

Définitions

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

NotifyOption

Options de notification par courrier électronique

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

RefreshRequest

Demande d’actualisation Power BI

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