Datasets - Update Direct Query Refresh Schedule

Service:

Power BI REST APIs

API Version:

v1.0

Updates den Aktualisierungszeitplan für ein angegebenes DirectQuery- oder LiveConnection-Dataset aus Meinem Arbeitsbereich aus.

Eine Anforderung sollte entweder eine Reihe von Tagen und Uhrzeiten oder eine gültige Häufigkeit enthalten, aber nicht beides. Wenn Sie eine Reihe von Tagen ohne Angabe von Uhrzeiten auswählen, verwendet Power BI standardmäßig eine einzelne Uhrzeit pro Tag. Wenn Sie die Häufigkeit festlegen, werden die Einstellungen für Tage und Uhrzeiten automatisch überschrieben.

Berechtigungen

Der Benutzer muss der Besitzer des Datasets sein.

Erforderlicher Bereich

Dataset.ReadWrite.All

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
datasetId	path	True	string	Die Dataset-ID

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
value	True	DirectQueryRefreshSchedule	Ein Objekt mit den Details zum Aktualisierungszeitplan für DirectQuery oder LiveConnection

Antworten

Name	Typ	Beschreibung
200 OK		OK

Beispiele

Disable a scheduled refresh example

Set a days and times based schedule example

Set a frequency based schedule example

Update the times of a days and times based schedule example

Disable a scheduled refresh example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule

Request Body

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

Sample Response

Status code:

200

Set a days and times based schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/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/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule

Request Body

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

Sample Response

Status code:

200

Update the times of a days and times based schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule

Request Body

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

Sample Response

Status code:

200

Definitionen

Name	Beschreibung
days	Die Tage, an denen die Aktualisierung ausgeführt werden soll
DirectQueryRefreshSchedule	Ein Power BI-Aktualisierungszeitplan für DirectQuery oder LiveConnection, der entweder die Häufigkeit oder eine Kombination aus Tagen und Zeiten angibt.
DirectQueryRefreshScheduleRequest	Power BI-Aktualisierungszeitplananforderung für DirectQuery oder LiveConnection

days

Die Tage, an denen die Aktualisierung ausgeführt werden soll

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

DirectQueryRefreshSchedule

Ein Power BI-Aktualisierungszeitplan für DirectQuery oder LiveConnection, der entweder die Häufigkeit oder eine Kombination aus Tagen und Zeiten angibt.

Name	Typ	Beschreibung
days	days[]	Die Tage, an denen die Aktualisierung ausgeführt werden soll
frequency	integer	Das Intervall in Minuten zwischen aufeinander folgenden Aktualisierungen. Unterstützte Werte sind 15, 30, 60, 120 und 180.
localTimeZoneId	string	Die ID der zu verwendenden Zeitzone. Weitere Informationen finden Sie unter Zeitzoneninformationen.
times	string[]	Die Tageszeiten, zu denen die Aktualisierung ausgeführt werden soll

DirectQueryRefreshScheduleRequest

Power BI-Aktualisierungszeitplananforderung für DirectQuery oder LiveConnection

Name	Typ	Beschreibung
value	DirectQueryRefreshSchedule	Ein Objekt mit den Details zum Aktualisierungszeitplan für DirectQuery oder LiveConnection