共用方式為

Datasets - Update Refresh Schedule

  • 參考
Service:
Power BI REST APIs
API Version:
v1.0

更新 [我的工作區] 中指定資料集的重新整理排程。

停用重新整理排程的要求不應包含其他變更。

至少必須指定一天。 如果未指定任何時間，則 Power BI 會每天使用預設單一時間。

權限

使用者必須是資料集擁有者。

必要範圍

Dataset.ReadWrite.All

限制

每日時間位置數目的限制取決於使用 Premium 或共用容量。 

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

URI 參數

名稱 位於 必要 類型 Description
datasetId
 path True

string

資料集識別碼

要求本文

名稱 必要 類型 Description
value True

RefreshSchedule

物件，包含重新整理排程的詳細資料

回應

名稱 類型 Description
200 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

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
Request Body
{
  "value": {
    "days": [
      "Sunday",
      "Tuesday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "07:00",
      "11:30",
      "16:00",
      "23:30"
    ],
    "localTimeZoneId": "UTC"
  }
}

Sample Response

Status code:
200

Change the notification option of a refresh schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
Request Body
{
  "value": {
    "notifyOption": "NoNotification"
  }
}

Sample Response

Status code:
200

Disable a scheduled refresh example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
Request Body
{
  "value": {
    "enabled": false
  }
}

Sample Response

Status code:
200

Update the times of a refresh schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
Request Body
{
  "value": {
    "times": [
      "08:00",
      "16:00"
    ]
  }
}

Sample Response

Status code:
200

定義

名稱 Description
days

要執行重新整理的天數
RefreshSchedule

匯入模型的Power BI 重新整理排程
RefreshScheduleRequest

Power BI 重新整理排程要求
ScheduleNotifyOption

排程重新整理終止的通知選項。 服務主體僅支援 NoNotification 值。

days

要執行重新整理的天數

名稱 類型 Description
Friday

string

Monday

string

Saturday

string

Sunday

string

Thursday

string

Tuesday

string

Wednesday

string

RefreshSchedule

匯入模型的Power BI 重新整理排程

名稱 類型 Description
NotifyOption

ScheduleNotifyOption

排程重新整理終止的通知選項。 服務主體僅支援 NoNotification 值。
days

days[]

要執行重新整理的天數
enabled

boolean

是否啟用重新整理
localTimeZoneId

string

要使用的時區識別碼。 如需詳細資訊，請參閱 時區資訊。
times

string[]

執行重新整理的一天時間

RefreshScheduleRequest

Power BI 重新整理排程要求

名稱 類型 Description
value

RefreshSchedule

物件，包含重新整理排程的詳細資料

ScheduleNotifyOption

排程重新整理終止的通知選項。 服務主體僅支援 NoNotification 值。

名稱 類型 Description
MailOnFailure

string

重新整理失敗時，將會傳送郵件通知
NoNotification

string

不會傳送任何通知