Udostępnij przez


Datasets - Update Refresh Schedule In Group

Aktualizuje harmonogram odświeżania określonego zestawu danych z określonego obszaru roboczego.

Żą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

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/groups/{groupId}/datasets/{datasetId}/refreshSchedule

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
datasetId
path True

string

Identyfikator zestawu danych

groupId
path True

string (uuid)

Identyfikator obszaru roboczego

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

Przykładowe żądanie

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"
  }
}

Przykładowa odpowiedź

Change the notification option of a refresh schedule example

Przykładowe żądanie

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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

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

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

ScheduleNotifyOption

Opcja powiadomienia po zakończeniu zaplanowanego odświeżania. Jednostki usługi obsługują NoNotification tylko wartość .

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ść .

Wartość Opis
NoNotification

Powiadomienie nie zostanie wysłane

MailOnFailure

Powiadomienie e-mail zostanie wysłane po niepowodzeniu odświeżania