Datasets - Update Refresh Schedule In Group

Service:

Power BI REST APIs

API Version:

v1.0

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

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.
• Questa chiamata API può essere chiamata da un profilo dell'entità servizio. Per altre informazioni, vedere: Profili dell'entità servizio in Power BI Embedded.

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/groups/{groupId}/datasets/{datasetId}/refreshSchedule

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
datasetId	path	True	string	ID del set 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

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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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