Datasets - Update Refresh Schedule
Aktualisiert den Aktualisierungszeitplan für das angegebene Dataset aus meinem Arbeitsbereich.
Eine Anforderung, die den Aktualisierungszeitplan deaktiviert, sollte keine anderen Änderungen enthalten.
Es muss mindestens ein Tag angegeben werden. Wenn keine Uhrzeiten angegeben werden, verwendet Power BI eine Standardzeit pro Tag.
Erlaubnisse
Der Benutzer muss der Datasetbesitzer sein.
Erforderlicher Bereich
Dataset.ReadWrite.All
Einschränkungen
Der Grenzwert für die Anzahl der Zeitfenster pro Tag hängt davon ab, ob eine Premium- oder freigegebene Kapazität verwendet wird.
PATCH https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshSchedule
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
dataset
|
path | True |
string |
Die Dataset-ID |
Anforderungstext
| Name | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
| value | True |
Ein Objekt, das die Details eines Aktualisierungszeitplans enthält |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
OKAY |
Beispiele
| 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
Beispielanforderung
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"
}
}
Beispiel für eine Antwort
Change the notification option of a refresh schedule example
Beispielanforderung
PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
"value": {
"notifyOption": "NoNotification"
}
}
Beispiel für eine Antwort
Disable a scheduled refresh example
Beispielanforderung
PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
"value": {
"enabled": false
}
}
Beispiel für eine Antwort
Update the times of a refresh schedule example
Beispielanforderung
PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
"value": {
"times": [
"08:00",
"16:00"
]
}
}
Beispiel für eine Antwort
Definitionen
| Name | Beschreibung |
|---|---|
| days |
Die Tage, an denen die Aktualisierung ausgeführt werden soll |
|
Refresh |
Ein Power BI-Aktualisierungszeitplan für importiertes Modell |
|
Refresh |
Power BI-Aktualisierungszeitplananforderung |
|
Schedule |
Die Benachrichtigungsoption beim Beenden einer geplanten Aktualisierung. Dienstprinzipale unterstützen nur den |
days
Die Tage, an denen die Aktualisierung ausgeführt werden soll
| Wert | Beschreibung |
|---|---|
| Monday | |
| Tuesday | |
| Wednesday | |
| Thursday | |
| Friday | |
| Saturday | |
| Sunday |
RefreshSchedule
Ein Power BI-Aktualisierungszeitplan für importiertes Modell
| Name | Typ | Beschreibung |
|---|---|---|
| days |
days[] |
Die Tage, an denen die Aktualisierung ausgeführt werden soll |
| enabled |
boolean |
Gibt an, ob die Aktualisierung aktiviert ist. |
| localTimeZoneId |
string |
Die ID der zu verwendenden Zeitzone. Weitere Informationen finden Sie unter Zeitzoneninformationen. |
| notifyOption |
Die Benachrichtigungsoption beim Beenden einer geplanten Aktualisierung. Dienstprinzipale unterstützen nur den |
|
| times |
string[] |
Die Tageszeiten, um die Aktualisierung auszuführen |
RefreshScheduleRequest
Power BI-Aktualisierungszeitplananforderung
| Name | Typ | Beschreibung |
|---|---|---|
| value |
Ein Objekt, das die Details eines Aktualisierungszeitplans enthält |
ScheduleNotifyOption
Die Benachrichtigungsoption beim Beenden einer geplanten Aktualisierung. Dienstprinzipale unterstützen nur den NoNotification Wert.
| Wert | Beschreibung |
|---|---|
| NoNotification |
Es wird keine Benachrichtigung gesendet. |
| MailOnFailure |
Beim Aktualisierungsfehler wird eine E-Mail-Benachrichtigung gesendet. |