Datasets - Update Refresh Schedule
Aktualizuje harmonogram odświeżania dla określonego zestawu danych z obszaru Mój obszar roboczy.
Żądanie wyłączające harmonogram odświeżania nie powinno zawierać żadnych innych zmian.
Należy określić co najmniej jeden dzień. Jeśli nie określono żadnych godzin, usługa Power BI będzie używać domyślnego pojedynczego czasu dziennie.
Permissions
Użytkownik musi być właścicielem zestawu danych.
Wymagany zakres
Dataset.ReadWrite.All
Ograniczenia
Limit liczby przedziałów czasu na dzień zależy od tego, czy jest używana pojemność Premium , czy Współdzielona.
PATCH https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshSchedule
Parametry identyfikatora URI
| Nazwa | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
dataset
|
path | True |
string |
Identyfikator zestawu danych |
Treść żądania
| Nazwa | Wymagane | Typ | Opis |
|---|---|---|---|
| value | True |
Obiekt zawierający szczegóły harmonogramu odświeżania |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
OK |
Przykłady
| 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
Przykładowe żądanie
PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
"value": {
"days": [
"Sunday",
"Tuesday",
"Friday",
"Saturday"
],
"times": [
"07:00",
"11:30",
"16:00",
"23:30"
],
"localTimeZoneId": "UTC"
}
}
Przykładowa odpowiedź
Change the notification option of a refresh schedule example
Przykładowe żądanie
PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
"value": {
"notifyOption": "NoNotification"
}
}
Przykładowa odpowiedź
Disable a scheduled refresh example
Przykładowe żądanie
PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
"value": {
"enabled": false
}
}
Przykładowa odpowiedź
Update the times of a refresh schedule example
Przykładowe żądanie
PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
"value": {
"times": [
"08:00",
"16:00"
]
}
}
Przykładowa odpowiedź
Definicje
| Nazwa | Opis |
|---|---|
| days |
Dni, w których należy wykonać odświeżanie |
|
Refresh |
Harmonogram odświeżania usługi Power BI dla zaimportowanego modelu |
|
Refresh |
Żądanie harmonogramu odświeżania usługi Power BI |
|
Schedule |
Opcja powiadomienia po zakończeniu zaplanowanego odświeżania. Jednostki usługi obsługują |
days
Dni, w których należy wykonać odświeżanie
| Wartość | Opis |
|---|---|
| Monday | |
| Tuesday | |
| Wednesday | |
| Thursday | |
| Friday | |
| Saturday | |
| Sunday |
RefreshSchedule
Harmonogram odświeżania usługi Power BI dla zaimportowanego modelu
| Nazwa | Typ | Opis |
|---|---|---|
| days |
days[] |
Dni, w których należy wykonać odświeżanie |
| enabled |
boolean |
Czy odświeżanie jest włączone |
| localTimeZoneId |
string |
Identyfikator strefy czasowej do użycia. Aby uzyskać więcej informacji, zobacz Informacje o strefie czasowej. |
| notifyOption |
Opcja powiadomienia po zakończeniu zaplanowanego odświeżania. Jednostki usługi obsługują |
|
| times |
string[] |
Czasy dnia do wykonania odświeżania |
RefreshScheduleRequest
Żądanie harmonogramu odświeżania usługi Power BI
| Nazwa | Typ | Opis |
|---|---|---|
| value |
Obiekt zawierający szczegóły harmonogramu odświeżania |
ScheduleNotifyOption
Opcja powiadomienia po zakończeniu zaplanowanego odświeżania. Jednostki usługi obsługują NoNotification tylko wartość .
| Wartość | Opis |
|---|---|
| NoNotification |
Powiadomienie nie zostanie wysłane |
| MailOnFailure |
Powiadomienie e-mail zostanie wysłane po niepowodzeniu odświeżania |