Freigeben über

Datasets - Update Direct Query Refresh Schedule In Group

  • Referenz
Dienst:
Power BI REST APIs
API-Version:
v1.0

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

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

Berechtigungen

Erforderlicher Bereich

Dataset.ReadWrite.All

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
datasetId
 path True

string

Die Dataset-ID
groupId
 path True

string

uuid

Arbeitsbereich-ID

Anforderungstext

Name Erforderlich Typ Beschreibung
value True

DirectQueryRefreshSchedule

Ein Objekt, das die Aktualisierungszeitplandetails für DirectQuery oder LiveConnection enthält

Antworten

Name Typ Beschreibung
200 OK

OK

Beispiele

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

Beispielanforderung

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
Anforderungstext
{
  "value": {
    "days": [
      "Sunday",
      "Tuesday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "07:00",
      "11:30",
      "16:00",
      "23:30"
    ],
    "localTimeZoneId": "UTC"
  }
}

Beispiel für eine Antwort

Statuscode:
200

Set a frequency based schedule example

Beispielanforderung

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
Anforderungstext
{
  "value": {
    "frequency": 30
  }
}

Beispiel für eine Antwort

Statuscode:
200

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

Beispielanforderung

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
Anforderungstext
{
  "value": {
    "times": [
      "07:00",
      "16:30",
      "23:30"
    ]
  }
}

Beispiel für eine Antwort

Statuscode:
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

Enumeration

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

Wert Beschreibung
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

DirectQueryRefreshSchedule

Object

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 zum Ausführen der Aktualisierung

DirectQueryRefreshScheduleRequest

Object

Power BI-Aktualisierungszeitplananforderung für DirectQuery oder LiveConnection

Name Typ Beschreibung
value

DirectQueryRefreshSchedule

Ein Objekt, das die Aktualisierungszeitplandetails für DirectQuery oder LiveConnection enthält