Dataflows - Refresh Dataflow

Service:

Power BI REST APIs

API Version:

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

With optional parameters:

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

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

Definizioni

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

NotifyOption

Opzioni di notifica tramite posta elettronica

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

RefreshRequest

Richiesta di aggiornamento di Power BI

Nome	Tipo	Descrizione
notifyOption	NotifyOption	Opzioni di notifica tramite posta elettronica