Dataflows - Refresh Dataflow

Service:

Power BI REST APIs

API Version:

v1.0

觸發指定資料流程的重新整理。

支援的電子郵件通知選項為 MailOnFailure 和 NoNotification。 不支援MailOnCompletion。

權限

此 API 呼叫可由服務主體設定檔呼叫。 如需詳細資訊，請參閱：Power BI Embedded中的服務主體設定檔。

必要範圍

Dataflow.ReadWrite.All

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

With optional parameters:

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

URI 參數

名稱	位於	必要	類型	Description
dataflowId	path	True	string uuid	資料流程識別碼
groupId	path	True	string uuid	工作區識別碼
processType	query		string uuid	要使用的重新整理程式類型。

要求本文

名稱	必要	類型	Description
notifyOption	True	NotifyOption	郵件通知選項

回應

名稱	類型	Description
200 OK		確定

範例

Example

Sample Request

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

Request Body

{
  "notifyOption": "MailOnFailure"
}

Sample Response

Status code:

200

定義

名稱	Description
NotifyOption	郵件通知選項
RefreshRequest	Power BI 重新整理要求

NotifyOption

郵件通知選項

名稱	類型	Description
MailOnCompletion	string	指出重新整理完成時將傳送成功或失敗的郵件通知
MailOnFailure	string	重新整理失敗時，將會傳送郵件通知
NoNotification	string	不會傳送任何通知

RefreshRequest

Power BI 重新整理要求

名稱	類型	Description
notifyOption	NotifyOption	郵件通知選項