Datasets - Update Refresh Schedule

Service:

Power BI REST APIs

API Version:

v1.0

Aktualizacje harmonogram odświeżania dla określonego zestawu danych z obszaru Mój obszar roboczy.

Żądanie, które wyłącza 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.

Uprawnienia

Użytkownik musi być właścicielem zestawu danych.

Zakres wymagany

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
datasetId	path	True	string	Identyfikator zestawu danych

Treść żądania

Nazwa	Wymagane	Typ	Opis
value	True	RefreshSchedule	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

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/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/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/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/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule

Request Body

{
  "value": {
    "times": [
      "08:00",
      "16:00"
    ]
  }
}

Sample Response

Status code:

200

Definicje

Nazwa	Opis
days	Dni, w których należy wykonać odświeżanie
RefreshSchedule	Harmonogram odświeżania usługi Power BI dla zaimportowanego modelu
RefreshScheduleRequest	Żądanie harmonogramu odświeżania usługi Power BI
ScheduleNotifyOption	Opcja powiadomienia po zakończeniu zaplanowanego odświeżania. Jednostki usługi obsługują NoNotification tylko wartość .

days

Dni, w których należy wykonać odświeżanie

Nazwa	Typ	Opis
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

RefreshSchedule

Harmonogram odświeżania usługi Power BI dla zaimportowanego modelu

Nazwa	Typ	Opis
NotifyOption	ScheduleNotifyOption	Opcja powiadomienia po zakończeniu zaplanowanego odświeżania. Jednostki usługi obsługują NoNotification tylko wartość .
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.
times	string[]	Czasy dnia do wykonania odświeżania

RefreshScheduleRequest

Żądanie harmonogramu odświeżania usługi Power BI

Nazwa	Typ	Opis
value	RefreshSchedule	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ść .

Nazwa	Typ	Opis
MailOnFailure	string	Powiadomienie e-mail zostanie wysłane po niepowodzeniu odświeżania
NoNotification	string	Żadne powiadomienie nie zostanie wysłane