Condividi tramite

Datasets - Update Refresh Schedule

  • Riferimento
Service:
Power BI REST APIs
API Version:
v1.0

Aggiornamenti la pianificazione dell'aggiornamento per il set di dati specificato dall'area di lavoro personale.

Una richiesta che disabilita la pianificazione dell'aggiornamento non deve contenere altre modifiche.

È necessario specificare almeno un giorno. Se non vengono specificati orari, Power BI userà una singola ora predefinita al giorno.

Autorizzazioni

L'utente deve essere il proprietario del set di dati.

Ambito obbligatorio

Dataset.ReadWrite.All

Limitazioni

Il limite per il numero di slot orari al giorno dipende dal fatto che venga usata una capacità Premium o Condivisa. 

PATCH https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshSchedule

Parametri dell'URI

Nome In Necessario Tipo Descrizione
datasetId
 path True

string

ID del set di dati

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

Change the days and times of a refresh schedule example
Change the notification option of a refresh schedule example
Disable a scheduled refresh example
Update the times of a refresh schedule example

Change the days and times of a refresh schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
Request Body
{
  "value": {
    "days": [
      "Sunday",
      "Tuesday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "07:00",
      "11:30",
      "16:00",
      "23:30"
    ],
    "localTimeZoneId": "UTC"
  }
}

Sample Response

Status code:
200

Change the notification option of a refresh schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
Request Body
{
  "value": {
    "notifyOption": "NoNotification"
  }
}

Sample Response

Status code:
200

Disable a scheduled refresh example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
Request Body
{
  "value": {
    "enabled": false
  }
}

Sample Response

Status code:
200

Update the times of a refresh schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
Request Body
{
  "value": {
    "times": [
      "08:00",
      "16:00"
    ]
  }
}

Sample Response

Status code:
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

Giorni in cui eseguire l'aggiornamento

Nome Tipo Descrizione
Friday

string

Monday

string

Saturday

string

Sunday

string

Thursday

string

Tuesday

string

Wednesday

string

RefreshSchedule

Pianificazione dell'aggiornamento di Power BI per il modello importato

Nome Tipo Descrizione
NotifyOption

ScheduleNotifyOption

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

days[]

Giorni in cui eseguire l'aggiornamento
enabled

boolean

Se l'aggiornamento è abilitato
localTimeZoneId

string

ID del fuso orario da usare. Per altre informazioni, vedere Informazioni sul fuso orario.
times

string[]

Orari del giorno per eseguire l'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.

Nome Tipo Descrizione
MailOnFailure

string

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

string

Nessuna notifica verrà inviata