Datasets - Update Direct Query Refresh Schedule In Group

Service:

Power BI REST APIs

API Version:

v1.0

Aktualizace 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ů bez zadání času, Power BI použije výchozí jeden čas za den. Nastavení frekvence automaticky přepíše nastavení dnů a časů.

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

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

Sample Request

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

Request Body

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

Sample Response

Status code:

200

Set a frequency based schedule example

Sample Request

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

Request Body

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

Sample Response

Status code:

200

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

Sample Request

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

Request Body

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

Sample Response

Status code:

200

Definice

Name	Description
days	Dny, ve kterých 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

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

DirectQueryRefreshSchedule

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

Name	Typ	Description
days	days[]	Dny, ve kterých 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í časy, kdy se má aktualizace provést

DirectQueryRefreshScheduleRequest

Žá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