Freigeben über


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
datasetId
path True

string

Die Dataset-ID

Anforderungstext

Name Erforderlich Typ Beschreibung
value True

RefreshSchedule

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

RefreshSchedule

Ein Power BI-Aktualisierungszeitplan für importiertes Modell

RefreshScheduleRequest

Power BI-Aktualisierungszeitplananforderung

ScheduleNotifyOption

Die Benachrichtigungsoption beim Beenden einer geplanten Aktualisierung. Dienstprinzipale unterstützen nur den NoNotification Wert.

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

ScheduleNotifyOption

Die Benachrichtigungsoption beim Beenden einer geplanten Aktualisierung. Dienstprinzipale unterstützen nur den NoNotification Wert.

times

string[]

Die Tageszeiten, um die Aktualisierung auszuführen

RefreshScheduleRequest

Power BI-Aktualisierungszeitplananforderung

Name Typ Beschreibung
value

RefreshSchedule

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.