Leggere in inglese

Condividi tramite


Dataflows - Update Refresh Schedule

Crea o aggiorna la pianificazione dell'aggiornamento per un flusso di dati specificato.

Permissions

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

Ambito obbligatorio

Dataflow.ReadWrite.All

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
dataflowId
path True

string (uuid)

ID flusso di dati

groupId
path True

string (uuid)

ID dell'area di lavoro

Corpo della richiesta

Nome Necessario Tipo Descrizione
value True

RefreshSchedule

Oggetto contenente i dettagli di una pianificazione dell'aggiornamento

Risposte

Nome Tipo Descrizione
200 OK

Va bene

Esempio

Daily refresh schedule example

Esempio di richiesta

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshSchedule
{
  "value": {
    "days": [
      "Sunday",
      "Monday",
      "Tuesday",
      "Wednesday",
      "Thursday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "10:00",
      "16:00"
    ],
    "enabled": true,
    "localTimeZoneId": "UTC",
    "notifyOption": "NoNotification"
  }
}

Risposta di esempio

Disable refresh schedule example

Esempio di richiesta

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshSchedule
{
  "value": {
    "enabled": false,
    "times": [],
    "localTimeZoneId": "UTC"
  }
}

Risposta di esempio

Update refresh schedule times example

Esempio di richiesta

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshSchedule
{
  "value": {
    "times": [
      "10:30",
      "16:30"
    ],
    "enabled": true,
    "localTimeZoneId": "UTC"
  }
}

Risposta di esempio

Definizioni

Nome Descrizione
days

Giorni in cui eseguire l'aggiornamento

RefreshSchedule

Pianificazione dell'aggiornamento di Power BI per il modello importato

RefreshScheduleRequest

Richiesta di pianificazione dell'aggiornamento di Power BI

ScheduleNotifyOption

Opzione di notifica alla chiusura di un aggiornamento pianificato. Le entità servizio supportano solo il NoNotification valore .

days

Giorni in cui eseguire l'aggiornamento

Valore Descrizione
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday

RefreshSchedule

Pianificazione dell'aggiornamento di Power BI per il modello importato

Nome Tipo Descrizione
days

days[]

Giorni in cui eseguire l'aggiornamento

enabled

boolean

Indica se l'aggiornamento è abilitato

localTimeZoneId

string

ID del fuso orario da utilizzare. Per altre informazioni, vedi Informazioni sul fuso orario.

notifyOption

ScheduleNotifyOption

Opzione di notifica alla chiusura di un aggiornamento pianificato. Le entità servizio supportano solo il NoNotification valore .

times

string[]

Orari del giorno per l'esecuzione dell'aggiornamento

RefreshScheduleRequest

Richiesta di pianificazione dell'aggiornamento di Power BI

Nome Tipo Descrizione
value

RefreshSchedule

Oggetto contenente i dettagli di una pianificazione dell'aggiornamento

ScheduleNotifyOption

Opzione di notifica alla chiusura di un aggiornamento pianificato. Le entità servizio supportano solo il NoNotification valore .

Valore Descrizione
NoNotification

Non verrà inviata alcuna notifica

MailOnFailure

Verrà inviata una notifica di posta elettronica in caso di errore di aggiornamento