Datasets - Update Refresh Schedule In Group

Service:

Power BI REST APIs

API Version:

v1.0

Aktualizace plán aktualizace pro zadanou datovou sadu ze zadaného pracovního prostoru.

Požadavek, který zakáže plán aktualizace, by neměl obsahovat žádné další změny.

Musí být zadán alespoň jeden den. Pokud nejsou zadané žádné časy, Power BI použije výchozí jednorázový čas za den.

Oprávnění

• Uživatel musí být vlastníkem datové sady.
• Toto volání rozhraní API lze volat pomocí profilu instančního objektu. Další informace najdete v tématu Profily instančního objektu v Power BI Embedded.

Požadovaný obor

Dataset.ReadWrite.All

Omezení

Limit počtu časových úseků za den závisí na tom, jestli se používá kapacita Premium nebo Shared.

PATCH https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/refreshSchedule

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
datasetId	path	True	string	ID datové sady
groupId	path	True	string uuid	ID pracovního prostoru

Text požadavku

Name	Vyžadováno	Typ	Description
value	True	RefreshSchedule	Objekt, který obsahuje podrobnosti plánu aktualizace

Odpovědi

Name	Typ	Description
200 OK		OK

Příklady

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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule

Request Body

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

Sample Response

Status code:

200

Definice

Name	Description
days	Dny, ve kterých se má aktualizace spustit
RefreshSchedule	Plán aktualizace Power BI pro importovaný model
RefreshScheduleRequest	Žádost o plán aktualizace Power BI
ScheduleNotifyOption	Možnost oznámení o ukončení plánované aktualizace Instanční objekty podporují NoNotification pouze hodnotu.

days

Dny, ve kterých se má aktualizace spustit

Name	Typ	Description
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

RefreshSchedule

Plán aktualizace Power BI pro importovaný model

Name	Typ	Description
NotifyOption	ScheduleNotifyOption	Možnost oznámení o ukončení plánované aktualizace Instanční objekty podporují NoNotification pouze hodnotu.
days	days[]	Dny, ve kterých se má aktualizace spustit
enabled	boolean	Jestli je aktualizace povolená
localTimeZoneId	string	ID časového pásma, které se má použít. Další informace najdete v tématu Informace o časovém pásmu.
times	string[]	Denní časy, kdy se má aktualizace provést

RefreshScheduleRequest

Žádost o plán aktualizace Power BI

Name	Typ	Description
value	RefreshSchedule	Objekt, který obsahuje podrobnosti plánu aktualizace

ScheduleNotifyOption

Možnost oznámení o ukončení plánované aktualizace Instanční objekty podporují NoNotification pouze hodnotu.

Name	Typ	Description
MailOnFailure	string	Při selhání aktualizace se odešle e-mailové oznámení.
NoNotification	string	Žádné oznámení se nepošlou.