Condividi tramite

Dataflows - Update Refresh Schedule

  • Riferimento
Servizio:
Power BI REST APIs
Versione API:
v1.0

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

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

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 del flusso di dati
groupId
 path True

string

uuid

ID 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

OK

Esempio

Daily refresh schedule example
Disable refresh schedule example
Update refresh schedule times example

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
Corpo della richiesta
{
  "value": {
    "days": [
      "Sunday",
      "Monday",
      "Tuesday",
      "Wednesday",
      "Thursday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "10:00",
      "16:00"
    ],
    "enabled": true,
    "localTimeZoneId": "UTC",
    "notifyOption": "NoNotification"
  }
}

Risposta di esempio

Codice di stato:
200

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
Corpo della richiesta
{
  "value": {
    "enabled": false,
    "times": [],
    "localTimeZoneId": "UTC"
  }
}

Risposta di esempio

Codice di stato:
200

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
Corpo della richiesta
{
  "value": {
    "times": [
      "10:30",
      "16:30"
    ],
    "enabled": true,
    "localTimeZoneId": "UTC"
  }
}

Risposta di esempio

Codice di stato:
200

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

Enumeration

Giorni in cui eseguire l'aggiornamento

Valore Descrizione
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

RefreshSchedule

Object

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 in cui eseguire l'aggiornamento

RefreshScheduleRequest

Object

Richiesta di pianificazione dell'aggiornamento di Power BI

Nome Tipo Descrizione
value

RefreshSchedule

Oggetto contenente i dettagli di una pianificazione dell'aggiornamento

ScheduleNotifyOption

Enumeration

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

Valore Descrizione
MailOnFailure

Una notifica di posta elettronica verrà inviata in caso di errore di aggiornamento
NoNotification

Non verrà inviata alcuna notifica