Datasets - Update Refresh Schedule

Hizmet:

Power BI REST APIs

API Sürümü:

v1.0

Çalışma alanım bölümünden belirtilen veri kümesi için yenileme zamanlamasını güncelleştirir.

Yenileme zamanlamasını devre dışı getiren bir istek başka değişiklik içermemelidir.

En az bir gün belirtilmelidir. Hiçbir zaman belirtilmezse, Power BI günde varsayılan tek bir zaman kullanır.

Permissions

Kullanıcının veri kümesi sahibi olması gerekir.

Gerekli Kapsam

Veri Kümesi.OkumaYazma.Tümü

Sınırlamalar

Günlük zaman aralığı sayısı sınırı , Premium veya Paylaşılan kapasitenin kullanılıp kullanılmadığına bağlıdır.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
datasetId	path	True	string	Veri kümesi kimliği

İstek Gövdesi

Name	Gerekli	Tür	Description
value	True	RefreshSchedule	Yenileme zamanlamasının ayrıntılarını içeren nesne

Yanıtlar

Name	Tür	Description
200 OK		Tamam

Örnekler

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

Örnek isteği

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule

İstek Gövdesi

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

Örnek yanıt

Durum kodu:

200

Change the notification option of a refresh schedule example

Örnek isteği

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule

İstek Gövdesi

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

Örnek yanıt

Durum kodu:

200

Disable a scheduled refresh example

Örnek isteği

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule

İstek Gövdesi

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

Örnek yanıt

Durum kodu:

200

Update the times of a refresh schedule example

Örnek isteği

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule

İstek Gövdesi

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

Örnek yanıt

Durum kodu:

200

Tanımlar

Name	Description
days	Yenilemenin yürütülecek gün sayısı
RefreshSchedule	İçeri aktarılan model için Power BI yenileme zamanlaması
RefreshScheduleRequest	Power BI yenileme zamanlaması isteği
ScheduleNotifyOption	Zamanlanmış yenilemenin sonlandırılmasına ilişkin bildirim seçeneği. Hizmet sorumluları yalnızca değeri destekler NoNotification .

days

Listeleme

Yenilemenin yürütülecek gün sayısı

Değer	Description
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday

RefreshSchedule

Object

İçeri aktarılan model için Power BI yenileme zamanlaması

Name	Tür	Description
days	days[]	Yenilemenin yürütülecek gün sayısı
enabled	boolean	Yenilemenin etkinleştirilip etkinleştirilmediği
localTimeZoneId	string	Kullanılacak saat diliminin kimliği. Daha fazla bilgi için bkz . Saat dilimi bilgileri.
notifyOption	ScheduleNotifyOption	Zamanlanmış yenilemenin sonlandırılmasına ilişkin bildirim seçeneği. Hizmet sorumluları yalnızca değeri destekler NoNotification .
times	string[]	Yenilemenin yürütülmek için günün saatleri

RefreshScheduleRequest

Object

Power BI yenileme zamanlaması isteği

Name	Tür	Description
value	RefreshSchedule	Yenileme zamanlamasının ayrıntılarını içeren nesne

ScheduleNotifyOption

Listeleme

Zamanlanmış yenilemenin sonlandırılmasına ilişkin bildirim seçeneği. Hizmet sorumluları yalnızca değeri destekler NoNotification .

Değer	Description
NoNotification	Bildirim gönderilmez
MailOnFailure	Yenileme hatasında bir posta bildirimi gönderilecek