Dataflows - Update Refresh Schedule

Hizmet:

Power BI REST APIs

API Sürümü:

v1.0

Belirtilen veri akışı için yenileme zamanlamasını oluşturur veya güncelleştirir.

Permissions

Bu API çağrısı bir hizmet sorumlusu profili tarafından çağrılabilir. Daha fazla bilgi için bkz. Power BI Embedded'de hizmet sorumlusu profilleri.

Gerekli Kapsam

Dataflow.ReadWrite.All

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
dataflowId	path	True	string (uuid)	Veri akışı kimliği
groupId	path	True	string (uuid)	Çalışma alanı 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

Daily refresh schedule example

Disable refresh schedule example

Update refresh schedule times example

Daily refresh schedule example

Örnek isteği

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

İstek Gövdesi

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

Örnek yanıt

Durum kodu:

200

Disable refresh schedule example

Örnek isteği

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

İstek Gövdesi

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

Örnek yanıt

Durum kodu:

200

Update refresh schedule times example

Örnek isteği

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

İstek Gövdesi

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

Ö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