Datasets - Update Direct Query Refresh Schedule In Group

Služba:

Power BI REST APIs

Verze rozhraní API:

v1.0

Aktualizuje plán aktualizace pro zadanou datovou sadu DirectQuery nebo LiveConnection ze zadaného pracovního prostoru.

Požadavek by měl obsahovat buď sadu dní a časů , nebo platnou frekvenci, ale ne obojí. Pokud zvolíte sadu dnů, aniž byste museli zadávat časy, použije Power BI výchozí jednorázovou dobu za den. Nastavení frekvence automaticky přepíše nastavení dnů a časů.

Povolení

• Uživatel musí být vlastníkem datové sady.
• 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

Dataset.ReadWrite.All

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

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	DirectQueryRefreshSchedule	Objekt obsahující podrobnosti plánu aktualizace pro DirectQuery nebo LiveConnection

Odpovědi

Name	Typ	Description
200 OK		OK

Příklady

Set a days and times based schedule example

Set a frequency based schedule example

Update the times of an existing days and times based schedule example

Set a days and times based schedule example

Ukázkový požadavek

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule

Text požadavku

{
  "value": {
    "days": [
      "Sunday",
      "Tuesday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "07:00",
      "11:30",
      "16:00",
      "23:30"
    ],
    "localTimeZoneId": "UTC"
  }
}

Ukázková odpověď

Stavový kód:

200

Set a frequency based schedule example

Ukázkový požadavek

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule

Text požadavku

{
  "value": {
    "frequency": 30
  }
}

Ukázková odpověď

Stavový kód:

200

Update the times of an existing days and times based schedule example

Ukázkový požadavek

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule

Text požadavku

{
  "value": {
    "times": [
      "07:00",
      "16:30",
      "23:30"
    ]
  }
}

Ukázková odpověď

Stavový kód:

200

Definice

Name	Description
days	Dny, kdy se má aktualizace spustit
DirectQueryRefreshSchedule	Plán aktualizace Power BI pro DirectQuery nebo LiveConnection, který určuje frekvenci nebo kombinaci dnů a časů.
DirectQueryRefreshScheduleRequest	Žádost o plán aktualizace Power BI pro DirectQuery nebo LiveConnection

days

Výčet

Dny, kdy se má aktualizace spustit

Hodnota	Description
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday

DirectQueryRefreshSchedule

Objekt

Plán aktualizace Power BI pro DirectQuery nebo LiveConnection, který určuje frekvenci nebo kombinaci dnů a časů.

Name	Typ	Description
days	days[]	Dny, kdy se má aktualizace spustit
frequency	integer	Interval v minutách mezi po sobě jdoucími aktualizacemi. Podporované hodnoty jsou 15, 30, 60, 120 a 180.
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í doba provádění aktualizace

DirectQueryRefreshScheduleRequest

Objekt

Žádost o plán aktualizace Power BI pro DirectQuery nebo LiveConnection

Name	Typ	Description
value	DirectQueryRefreshSchedule	Objekt obsahující podrobnosti plánu aktualizace pro DirectQuery nebo LiveConnection