Datasets - Update Direct Query Refresh Schedule In Group

Service:

Power BI REST APIs

API Version:

v1.0

Updates jadwal refresh untuk himpunan data DirectQuery atau LiveConnection tertentu dari ruang kerja yang ditentukan.

Permintaan harus berisi satu set hari dan waktu atau frekuensi yang valid, tetapi tidak keduanya. Jika Anda memilih sekumpulan hari tanpa menentukan kapan saja, Maka Power BI akan menggunakan satu waktu default per hari. Mengatur frekuensi akan secara otomatis menimpa pengaturan hari dan waktu.

Izin

• Pengguna harus menjadi pemilik himpunan data.
• Panggilan API ini dapat dipanggil oleh profil perwakilan layanan. Untuk informasi selengkapnya lihat: Profil perwakilan layanan di Power BI Embedded.

Cakupan yang Diperlukan

Dataset.ReadWrite.All

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
datasetId	path	True	string	ID himpunan data
groupId	path	True	string uuid	ID ruang kerja

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
value	True	DirectQueryRefreshSchedule	Objek yang berisi detail jadwal refresh untuk DirectQuery atau LiveConnection

Respons

Nama	Jenis	Deskripsi
200 OK		OK

Contoh

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

Definisi

Nama	Deskripsi
days	Hari-hari untuk menjalankan refresh
DirectQueryRefreshSchedule	Jadwal refresh Power BI untuk DirectQuery atau LiveConnection, menentukan frekuensi atau kombinasi hari dan waktu.
DirectQueryRefreshScheduleRequest	Permintaan jadwal refresh Power BI untuk DirectQuery atau LiveConnection

days

Hari-hari untuk menjalankan refresh

Nama	Jenis	Deskripsi
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

DirectQueryRefreshSchedule

Jadwal refresh Power BI untuk DirectQuery atau LiveConnection, menentukan frekuensi atau kombinasi hari dan waktu.

Nama	Jenis	Deskripsi
days	days[]	Hari-hari untuk menjalankan refresh
frequency	integer	Interval dalam menit di antara refresh berturut-turut. Nilai yang didukung adalah 15, 30, 60, 120, dan 180.
localTimeZoneId	string	ID zona waktu yang akan digunakan. Untuk informasi selengkapnya, lihat Info zona waktu
times	string[]	Waktu hari untuk menjalankan refresh

DirectQueryRefreshScheduleRequest

Permintaan jadwal refresh Power BI untuk DirectQuery atau LiveConnection

Nama	Jenis	Deskripsi
value	DirectQueryRefreshSchedule	Objek yang berisi detail jadwal refresh untuk DirectQuery atau LiveConnection