Datasets - Update Refresh Schedule In Group

Service:

Power BI REST APIs

API Version:

v1.0

Updates jadwal refresh untuk himpunan data yang ditentukan dari ruang kerja yang ditentukan.

Permintaan yang menonaktifkan jadwal refresh tidak boleh berisi perubahan lain.

Setidaknya satu hari harus ditentukan. Jika tidak ada waktu yang ditentukan, Power BI akan menggunakan satu waktu default per hari.

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

Batasan

Batas jumlah slot waktu per hari tergantung pada apakah kapasitas Premium atau Bersama digunakan.

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

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	RefreshSchedule	Objek yang berisi detail jadwal refresh

Respons

Nama	Jenis	Deskripsi
200 OK		OK

Contoh

Change the days and times of a refresh schedule example

Change the notification option of a refresh schedule example

Disable a scheduled refresh example

Update the times of a refresh schedule example

Change the days and times of a refresh schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule

Request Body

{
  "value": {
    "days": [
      "Sunday",
      "Tuesday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "07:00",
      "11:30",
      "16:00",
      "23:30"
    ],
    "localTimeZoneId": "UTC"
  }
}

Sample Response

Status code:

200

Change the notification option of a refresh schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule

Request Body

{
  "value": {
    "notifyOption": "NoNotification"
  }
}

Sample Response

Status code:

200

Disable a scheduled refresh example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule

Request Body

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

Sample Response

Status code:

200

Update the times of a refresh schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule

Request Body

{
  "value": {
    "times": [
      "08:00",
      "16:00"
    ]
  }
}

Sample Response

Status code:

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 NoNotification nilai .

days

Hari-hari untuk menjalankan refresh

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

RefreshSchedule

Jadwal refresh Power BI untuk model yang diimpor

Nama	Jenis	Deskripsi
NotifyOption	ScheduleNotifyOption	Opsi pemberitahuan tentang penghentian refresh terjadwal. Perwakilan layanan hanya mendukung NoNotification nilai .
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.
times	string[]	Waktu hari untuk menjalankan refresh

RefreshScheduleRequest

Permintaan jadwal refresh Power BI

Nama	Jenis	Deskripsi
value	RefreshSchedule	Objek yang berisi detail jadwal refresh

ScheduleNotifyOption

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

Nama	Jenis	Deskripsi
MailOnFailure	string	Pemberitahuan surat akan dikirim saat kegagalan refresh
NoNotification	string	Tidak ada pemberitahuan yang akan dikirim