Dataflows - Update Refresh Schedule

Service:

Power BI REST APIs

API Version:

v1.0

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

Oprávnění

Toto volání rozhraní API může volat profil instančního objektu. Další informace najdete v tématu Profily instančních objektů 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

Sample Request

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

Request Body

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

Sample Response

Status code:

200

Disable refresh schedule example

Sample Request

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

Request Body

{
  "value": {
    "enabled": false
  }
}

Sample Response

Status code:

200

Update refresh schedule times example

Sample Request

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

Request Body

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

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í doby provádění aktualizace

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.