Dataflows - Refresh Dataflow

Servizio:

Power BI REST APIs

Versione API:

v1.0

Attiva un aggiornamento per il flusso di dati specificato.

Le opzioni di notifica tramite posta elettronica supportate sono MailOnFailure e NoNotification. MailOnCompletion non è supportato.

Autorizzazioni

Questa chiamata API può essere chiamata da un profilo entità servizio. Per altre informazioni, vedere Profili entità servizio in Power BI Embedded.

Ambito obbligatorio

Dataflow.ReadWrite.All

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dataflows/{dataflowId}/refreshes

Con parametri facoltativi:

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dataflows/{dataflowId}/refreshes?processType={processType}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
dataflowId	path	True	string uuid	ID del flusso di dati
groupId	path	True	string uuid	ID area di lavoro
processType	query		string	Tipo di processo di aggiornamento da usare.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
notifyOption	True	NotifyOption	Opzioni di notifica tramite posta elettronica

Risposte

Nome	Tipo	Descrizione
200 OK		OK

Esempio

Example

Esempio di richiesta

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

Corpo della richiesta

{
  "notifyOption": "MailOnFailure"
}

Risposta di esempio

Codice di stato:

200

Definizioni

Nome	Descrizione
NotifyOption	Opzioni di notifica tramite posta elettronica
RefreshRequest	Richiesta di aggiornamento di Power BI

NotifyOption

Enumeration

Opzioni di notifica tramite posta elettronica

Valore	Descrizione
MailOnCompletion	Una notifica di posta elettronica che indica l'esito positivo o negativo verrà inviato al completamento dell'aggiornamento
MailOnFailure	Una notifica di posta elettronica verrà inviata in caso di errore di aggiornamento
NoNotification	Non verrà inviata alcuna notifica

RefreshRequest

Object

Richiesta di aggiornamento di Power BI

Nome	Tipo	Descrizione
notifyOption	NotifyOption	Opzioni di notifica tramite posta elettronica