Dataflows - Update Refresh Schedule

Layanan:

Power BI REST APIs

Versi API:

v1.0

Membuat atau memperbarui jadwal refresh untuk aliran data tertentu.

Permissions

Panggilan API ini dapat dipanggil oleh profil perwakilan layanan. Untuk informasi selengkapnya lihat: Profil perwakilan layanan di Power BI Embedded.

Cakupan yang Diperlukan

Dataflow.ReadWrite.All

PATCH https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dataflows/{dataflowId}/refreshSchedule

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
dataflowId	path	True	string (uuid)	ID aliran data
groupId	path	True	string (uuid)	ID ruang kerja

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
value	True	RefreshSchedule	Objek yang berisi detail jadwal refresh

Respons

Nama	Jenis	Deskripsi
200 OK		OK

Contoh

Daily refresh schedule example

Disable refresh schedule example

Update refresh schedule times example

Daily refresh schedule example

Permintaan sampel

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshSchedule

Isi Permintaan

{
  "value": {
    "days": [
      "Sunday",
      "Monday",
      "Tuesday",
      "Wednesday",
      "Thursday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "10:00",
      "16:00"
    ],
    "enabled": true,
    "localTimeZoneId": "UTC",
    "notifyOption": "NoNotification"
  }
}

Respon sampel

Kode status:

200

Disable refresh schedule example

Permintaan sampel

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshSchedule

Isi Permintaan

{
  "value": {
    "enabled": false,
    "times": [],
    "localTimeZoneId": "UTC"
  }
}

Respon sampel

Kode status:

200

Update refresh schedule times example

Permintaan sampel

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshSchedule

Isi Permintaan

{
  "value": {
    "times": [
      "10:30",
      "16:30"
    ],
    "enabled": true,
    "localTimeZoneId": "UTC"
  }
}

Respon sampel

Kode status:

200

Definisi

Nama	Deskripsi
days	Hari-hari untuk menjalankan refresh
RefreshSchedule	Jadwal refresh Power BI untuk model yang diimpor
RefreshScheduleRequest	Permintaan jadwal refresh Power BI
ScheduleNotifyOption	Opsi pemberitahuan tentang penghentian refresh terjadwal. Perwakilan layanan hanya mendukung nilai .NoNotification

days

Enumeration

Hari-hari untuk menjalankan refresh

Nilai	Deskripsi
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday

RefreshSchedule

Objek

Jadwal refresh Power BI untuk model yang diimpor

Nama	Jenis	Deskripsi
days	days[]	Hari-hari untuk menjalankan refresh
enabled	boolean	Apakah refresh diaktifkan
localTimeZoneId	string	ID zona waktu yang akan digunakan. Untuk informasi selengkapnya, lihat Info zona waktu.
notifyOption	ScheduleNotifyOption	Opsi pemberitahuan tentang penghentian refresh terjadwal. Perwakilan layanan hanya mendukung nilai .NoNotification
times	string[]	Waktu hari untuk menjalankan refresh

RefreshScheduleRequest

Objek

Permintaan jadwal refresh Power BI

Nama	Jenis	Deskripsi
value	RefreshSchedule	Objek yang berisi detail jadwal refresh

ScheduleNotifyOption

Enumeration

Opsi pemberitahuan tentang penghentian refresh terjadwal. Perwakilan layanan hanya mendukung nilai .NoNotification

Nilai	Deskripsi
NoNotification	Tidak ada pemberitahuan yang akan dikirim
MailOnFailure	Pemberitahuan email akan dikirim saat kegagalan refresh