Bagikan melalui

Datasets - Update Refresh Schedule

  • Referensi
Service:
Power BI REST APIs
API Version:
v1.0

Updates jadwal refresh untuk himpunan data yang ditentukan dari Ruang kerja saya.

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.

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/datasets/{datasetId}/refreshSchedule

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
datasetId
 path True

string

ID himpunan data

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/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/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/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/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