Dataflows - Refresh Dataflow

Layanan:

Power BI REST APIs

Versi API:

v1.0

Memicu refresh untuk aliran data yang ditentukan.

Opsi pemberitahuan email yang didukung adalah MailOnFailure dan NoNotification. MailOnCompletion tidak didukung.

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

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

Dengan parameter opsional:

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dataflows/{dataflowId}/refreshes?processType={processType}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
dataflowId	path	True	string (uuid)	ID aliran data
groupId	path	True	string (uuid)	ID ruang kerja
processType	query		string	Jenis proses refresh yang akan digunakan.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
notifyOption	True	NotifyOption	Opsi pemberitahuan email

Respons

Nama	Jenis	Deskripsi
200 OK		OK

Contoh

Example

Permintaan sampel

POST https://api.powerbi.com/v1.0/myorg/groups/51e47fc5-48fd-4826-89f0-021bd3a80abd/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshes?processType=default

Isi Permintaan

{
  "notifyOption": "MailOnFailure"
}

Respon sampel

Kode status:

200

Definisi

Nama	Deskripsi
NotifyOption	Opsi pemberitahuan email
RefreshRequest	Permintaan refresh Power BI

NotifyOption

Enumeration

Opsi pemberitahuan email

Nilai	Deskripsi
NoNotification	Tidak ada pemberitahuan yang akan dikirim
MailOnFailure	Pemberitahuan email akan dikirim saat kegagalan refresh
MailOnCompletion	Pemberitahuan email yang menunjukkan keberhasilan atau kegagalan akan dikirim pada penyelesaian refresh

RefreshRequest

Objek

Permintaan refresh Power BI

Nama	Jenis	Deskripsi
notifyOption	NotifyOption	Opsi pemberitahuan email