Dataflows - Refresh Dataflow

服务:: Power BI REST APIs

API 版本:: v1.0

触发指定数据流的刷新。

支持的电子邮件通知选项为 MailOnFailure 和 NoNotification。不支持 MailOnCompletion。

Permissions

此 API 调用可由服务主体配置文件调用。有关详细信息，请参阅： Power BI Embedded 中的服务主体配置文件。

所需范围

Dataflow.ReadWrite.All

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

具有可选参数:

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

URI 参数

名称	在	必需	类型	说明
dataflowId	path	True	string (uuid)	数据流 ID
groupId	path	True	string (uuid)	工作区 ID
processType	query		string	要使用的刷新过程的类型。

请求正文

名称	必需	类型	说明
notifyOption	True	NotifyOption	邮件通知选项

响应

名称	类型	说明
200 OK		好的

示例

Example

示例请求

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

请求正文

{
  "notifyOption": "MailOnFailure"
}

示例响应

状态代码:: 200

定义

名称	说明
NotifyOption	邮件通知选项
RefreshRequest	Power BI 刷新请求

NotifyOption

枚举

邮件通知选项

值	说明
NoNotification	不会发送通知
MailOnFailure	刷新失败时将发送邮件通知
MailOnCompletion	一条邮件通知，指示刷新完成时将发送成功或失败

RefreshRequest

Object

Power BI 刷新请求

名称	类型	说明
notifyOption	NotifyOption	邮件通知选项

通过