Dataflows - Refresh Dataflow

Dienst:: 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.

Erlaubnisse

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

Mit optionalen Parametern:

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)	Die Arbeitsbereichs-ID
processType	query		string	Typ des zu verwendenden Aktualisierungsprozesses.

Anforderungstext

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

Antworten

Name	Typ	Beschreibung
200 OK		OKAY

Beispiele

Example

Beispielanforderung

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

Anforderungstext

{
  "notifyOption": "MailOnFailure"
}

Beispiel für eine Antwort

Statuscode:: 200

Definitionen

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

NotifyOption

Enumeration

E-Mail-Benachrichtigungsoptionen

Wert	Beschreibung
NoNotification	Es wird keine Benachrichtigung gesendet.
MailOnFailure	Beim Aktualisierungsfehler wird eine E-Mail-Benachrichtigung gesendet.
MailOnCompletion	Eine E-Mail-Benachrichtigung, die angibt, dass der Aktualisierungsvorgang erfolgreich oder fehlgeschlagen ist

RefreshRequest

Objekt

Power BI-Aktualisierungsanforderung

Name	Typ	Beschreibung
notifyOption	NotifyOption	E-Mail-Benachrichtigungsoptionen

Freigeben über