Partager via


Dataflows - Refresh Dataflow

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
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
{
  "notifyOption": "MailOnFailure"
}

Sample Response

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