通过

Datasets - Update Refresh Schedule In Group

  • 参考
服务:
Power BI REST APIs
API 版本:
v1.0

汇报指定工作区中指定数据集的刷新计划。

禁用刷新计划的请求不应包含任何其他更改。

必须至少指定一天。 如果未指定时间，则 Power BI 将每天使用默认的一次时间。

权限

所需范围

Dataset.ReadWrite.All

限制

每天的时间段数限制取决于是使用 高级 容量还是共享容量。 

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

URI 参数

名称 在 必需 类型 说明
datasetId
 path True

string

数据集 ID
groupId
 path True

string

uuid

工作区 ID

请求正文

名称 必需 类型 说明
value True

RefreshSchedule

一个对象，其中包含刷新计划的详细信息

响应

名称 类型 说明
200 OK

OK

示例

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

示例请求

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
请求正文
{
  "value": {
    "days": [
      "Sunday",
      "Tuesday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "07:00",
      "11:30",
      "16:00",
      "23:30"
    ],
    "localTimeZoneId": "UTC"
  }
}

示例响应

状态代码:
200

Change the notification option of a refresh schedule example

示例请求

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
请求正文
{
  "value": {
    "notifyOption": "NoNotification"
  }
}

示例响应

状态代码:
200

Disable a scheduled refresh example

示例请求

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
请求正文
{
  "value": {
    "enabled": false
  }
}

示例响应

状态代码:
200

Update the times of a refresh schedule example

示例请求

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
请求正文
{
  "value": {
    "times": [
      "08:00",
      "16:00"
    ]
  }
}

示例响应

状态代码:
200

定义

名称 说明
days

执行刷新的日期
RefreshSchedule

导入模型的 Power BI 刷新计划
RefreshScheduleRequest

Power BI 刷新计划请求
ScheduleNotifyOption

终止计划刷新的通知选项。 服务主体仅支持 NoNotification 值。

days

Enumeration

执行刷新的日期

值 说明
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

RefreshSchedule

Object

导入模型的 Power BI 刷新计划

名称 类型 说明
days

days[]

执行刷新的日期
enabled

boolean

是否启用刷新
localTimeZoneId

string

要使用的时区的 ID。 有关详细信息，请参阅 时区信息。
notifyOption

ScheduleNotifyOption

终止计划刷新的通知选项。 服务主体仅支持 NoNotification 值。
times

string[]

每天执行刷新的时间

RefreshScheduleRequest

Object

Power BI 刷新计划请求

名称 类型 说明
value

RefreshSchedule

一个对象，其中包含刷新计划的详细信息

ScheduleNotifyOption

Enumeration

终止计划刷新的通知选项。 服务主体仅支持 NoNotification 值。

值 说明
MailOnFailure

刷新失败时将发送邮件通知
NoNotification

不会发送通知