Dataflows - Update Refresh Schedule

Služba:

Power BI REST APIs

Verze rozhraní API:

v1.0

Vytvoří nebo aktualizuje plán aktualizace pro zadaný tok dat.

Povolení

Toto volání rozhraní API může volat instanční profil. Další informace najdete v tématu: Profily instančního objektu v Power BI Embedded.

Požadovaný obor

Dataflow.ReadWrite.All

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
dataflowId	path	True	string (uuid)	ID toku dat
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

Daily refresh schedule example

Disable refresh schedule example

Update refresh schedule times example

Daily refresh schedule example

Ukázkový požadavek

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshSchedule

Text požadavku

{
  "value": {
    "days": [
      "Sunday",
      "Monday",
      "Tuesday",
      "Wednesday",
      "Thursday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "10:00",
      "16:00"
    ],
    "enabled": true,
    "localTimeZoneId": "UTC",
    "notifyOption": "NoNotification"
  }
}

Ukázková odpověď

Stavový kód:

200

Disable refresh schedule example

Ukázkový požadavek

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshSchedule

Text požadavku

{
  "value": {
    "enabled": false,
    "times": [],
    "localTimeZoneId": "UTC"
  }
}

Ukázková odpověď

Stavový kód:

200

Update refresh schedule times example

Ukázkový požadavek

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshSchedule

Text požadavku

{
  "value": {
    "times": [
      "10:30",
      "16:30"
    ],
    "enabled": true,
    "localTimeZoneId": "UTC"
  }
}

Ukázková odpověď

Stavový kód:

200

Definice

Name	Description
days	Dny, kdy 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í při ukončení plánované aktualizace. Instanční objekty podporují NoNotification pouze hodnotu.

days

Výčet

Dny, kdy se má aktualizace spustit

Hodnota	Description
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday

RefreshSchedule

Objekt

Plán aktualizace Power BI pro importovaný model

Name	Typ	Description
days	days[]	Dny, kdy 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.
notifyOption	ScheduleNotifyOption	Možnost oznámení při ukončení plánované aktualizace. Instanční objekty podporují NoNotification pouze hodnotu.
times	string[]	Denní doba provádění aktualizace

RefreshScheduleRequest

Objekt

Žádost o plán aktualizace Power BI

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

ScheduleNotifyOption

Výčet

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

Hodnota	Description
NoNotification	Nebudou odeslána žádná oznámení.
MailOnFailure	Při selhání aktualizace se odešle e-mailové oznámení.