Datasets - Update Refresh Schedule In Group
Aggiorna 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 specificate ore, Power BI userà un'unica ora predefinita al giorno.
Permissions
- 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 entità servizio in Power BI Embedded.
Ambito obbligatorio
Dataset.ReadWrite.All
Limitazioni
Il limite per il numero di fasce orarie 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 |
|---|---|---|---|---|
|
dataset
|
path | True |
string |
ID set di dati |
|
group
|
path | True |
string (uuid) |
ID dell'area di lavoro |
Corpo della richiesta
| Nome | Necessario | Tipo | Descrizione |
|---|---|---|---|
| value | True |
Oggetto contenente i dettagli di una pianificazione dell'aggiornamento |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
Va bene |
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
Esempio di richiesta
PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
"value": {
"days": [
"Sunday",
"Tuesday",
"Friday",
"Saturday"
],
"times": [
"07:00",
"11:30",
"16:00",
"23:30"
],
"localTimeZoneId": "UTC"
}
}
Risposta di esempio
Change the notification option of a refresh schedule example
Esempio di richiesta
PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
"value": {
"notifyOption": "NoNotification"
}
}
Risposta di esempio
Disable a scheduled refresh example
Esempio di richiesta
PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
"value": {
"enabled": false
}
}
Risposta di esempio
Update the times of a refresh schedule example
Esempio di richiesta
PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
"value": {
"times": [
"08:00",
"16:00"
]
}
}
Risposta di esempio
Definizioni
| Nome | Descrizione |
|---|---|
| days |
Giorni in cui eseguire l'aggiornamento |
|
Refresh |
Pianificazione dell'aggiornamento di Power BI per il modello importato |
|
Refresh |
Richiesta di pianificazione dell'aggiornamento di Power BI |
|
Schedule |
Opzione di notifica alla chiusura di un aggiornamento pianificato. Le entità servizio supportano solo il |
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 |
Opzione di notifica alla chiusura di un aggiornamento pianificato. Le entità servizio supportano solo il |
|
| times |
string[] |
Orari del giorno per l'esecuzione dell'aggiornamento |
RefreshScheduleRequest
Richiesta di pianificazione dell'aggiornamento di Power BI
| Nome | Tipo | Descrizione |
|---|---|---|
| value |
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 |