Dataflows - Refresh Dataflow

Service:

Power BI REST APIs

API Version:

v1.0

Löst eine Aktualisierung für den angegebenen Datenfluss aus.

Unterstützte E-Mail-Benachrichtigungsoptionen sind MailOnFailure und NoNotification. MailOnCompletion wird nicht unterstützt.

Berechtigungen

Dieser API-Aufruf kann von einem Dienstprinzipalprofil aufgerufen werden. Weitere Informationen finden Sie unter: Dienstprinzipalprofile in Power BI Embedded.

Erforderlicher Bereich

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}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
dataflowId	path	True	string uuid	Die Datenfluss-ID
groupId	path	True	string uuid	Arbeitsbereich-ID
processType	query		string uuid	Typ des zu verwendenden Aktualisierungsprozesses.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
notifyOption	True	NotifyOption	E-Mail-Benachrichtigungsoptionen

Antworten

Name	Typ	Beschreibung
200 OK		OK

Beispiele

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

Definitionen

Name	Beschreibung
NotifyOption	E-Mail-Benachrichtigungsoptionen
RefreshRequest	Power BI-Aktualisierungsanforderung

NotifyOption

E-Mail-Benachrichtigungsoptionen

Name	Typ	Beschreibung
MailOnCompletion	string	Eine E-Mail-Benachrichtigung, die den Erfolg oder Fehler angibt, wird nach Abschluss der Aktualisierung gesendet.
MailOnFailure	string	Eine E-Mail-Benachrichtigung wird auf Aktualisierungsfehler gesendet.
NoNotification	string	Keine Benachrichtigung wird gesendet.

RefreshRequest

Power BI-Aktualisierungsanforderung

Name	Typ	Beschreibung
notifyOption	NotifyOption	E-Mail-Benachrichtigungsoptionen