Datasets - Update Direct Query Refresh Schedule In Group

Service:

Power BI REST APIs

API Version:

v1.0

Aktualizacje harmonogram odświeżania określonego zestawu danych DirectQuery lub LiveConnection z określonego obszaru roboczego.

Żądanie powinno zawierać zestaw dni i godziny lub prawidłową częstotliwość, ale nie obie. Jeśli wybierzesz zestaw dni bez określenia jakichkolwiek godzin, usługa Power BI będzie używać domyślnego pojedynczego czasu dziennie. Ustawienie częstotliwości spowoduje automatyczne zastąpienie ustawień dni i godzin.

Uprawnienia

• Użytkownik musi być właścicielem zestawu danych.
• To wywołanie interfejsu API może być wywoływane przez profil jednostki usługi. Aby uzyskać więcej informacji, zobacz: Profile jednostki usługi w Power BI Embedded.

Wymagany zakres

Dataset.ReadWrite.All

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
datasetId	path	True	string	Identyfikator zestawu danych
groupId	path	True	string uuid	Identyfikator obszaru roboczego

Treść żądania

Nazwa	Wymagane	Typ	Opis
value	True	DirectQueryRefreshSchedule	Obiekt zawierający szczegóły harmonogramu odświeżania dla trybu DirectQuery lub LiveConnection

Odpowiedzi

Nazwa	Typ	Opis
200 OK		OK

Przykłady

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

Definicje

Nazwa	Opis
days	Dni, w których należy wykonać odświeżanie
DirectQueryRefreshSchedule	Harmonogram odświeżania usługi Power BI dla trybu DirectQuery lub LiveConnection, określając częstotliwość lub kombinację dni i godzin.
DirectQueryRefreshScheduleRequest	Żądanie harmonogramu odświeżania usługi Power BI dla trybu DirectQuery lub LiveConnection

days

Dni, w których należy wykonać odświeżanie

Nazwa	Typ	Opis
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

DirectQueryRefreshSchedule

Harmonogram odświeżania usługi Power BI dla trybu DirectQuery lub LiveConnection, określając częstotliwość lub kombinację dni i godzin.

Nazwa	Typ	Opis
days	days[]	Dni, w których należy wykonać odświeżanie
frequency	integer	Interwał w minutach między kolejnymi odświeżeniami. Obsługiwane wartości to 15, 30, 60, 120 i 180.
localTimeZoneId	string	Identyfikator strefy czasowej do użycia. Aby uzyskać więcej informacji, zobacz Informacje o strefie czasowej
times	string[]	Czasy dnia do wykonania odświeżania

DirectQueryRefreshScheduleRequest

Żądanie harmonogramu odświeżania usługi Power BI dla trybu DirectQuery lub LiveConnection

Nazwa	Typ	Opis
value	DirectQueryRefreshSchedule	Obiekt zawierający szczegóły harmonogramu odświeżania dla trybu DirectQuery lub LiveConnection