共用方式為

Datasets - Get Refresh History

  • 參考
服務:
Power BI REST APIs
API 版本:
v1.0

從 [我的工作區]傳回指定數據集的重新整理記錄。

必要範圍

Dataset.ReadWrite.All 或 Dataset.Read.All

局限性

不會傳回 OneDrive 重新整理記錄。

根據過去 3 天內的重新整理次數，每個數據集一律會有 20 到 60 個可用的重新整理記錄專案。
最近的60個被保留下來，如果他們都不到3天。 有 20 個以上的專案時，會刪除超過 3 天的專案。 

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes
含選擇性參數: 
GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes?$top={$top}

URI 參數

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

string

數據集標識碼
$top
 query

integer

minimum: 1

重新整理記錄中所要求的項目數目。 如果未提供，則預設值為最後一個可用的60個專案。

回應

名稱 類型 Description
200 OK

Refreshes

還行

範例

Completed refresh example
Failed refresh example
In-progress refresh example

Completed refresh example

範例要求

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes?$top=1

範例回覆

狀態碼:
200 
{
  "value": [
    {
      "refreshType": "ViaApi",
      "startTime": "2017-06-13T09:25:43.153Z",
      "endTime": "2017-06-13T09:31:43.153Z",
      "status": "Completed",
      "requestId": "9399bb89-25d1-44f8-8576-136d7e9014b1",
      "refreshAttempts": [
        {
          "attemptId": 1,
          "startTime": "2017-06-13T09:25:43.153Z",
          "endTime": "2017-06-13T09:31:40.153Z",
          "type": "Data"
        },
        {
          "attemptId": 1,
          "startTime": "2017-06-13T09:31:40.156Z",
          "endTime": "2017-06-13T09:31:43.153Z",
          "type": "Query"
        }
      ]
    }
  ]
}

Failed refresh example

範例要求

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes?$top=1

範例回覆

狀態碼:
200 
{
  "value": [
    {
      "refreshType": "ViaApi",
      "startTime": "2017-06-13T09:25:43.153Z",
      "endTime": "2017-06-13T09:31:43.153Z",
      "serviceExceptionJson": "{\"errorCode\":\"ModelRefreshFailed_CredentialsNotSpecified\"}",
      "status": "Failed",
      "requestId": "11bf290a-346b-48b7-8973-c5df149337ff",
      "refreshAttempts": [
        {
          "attemptId": 1,
          "startTime": "2017-06-13T09:25:43.153Z",
          "endTime": "2017-06-13T09:31:43.153Z",
          "serviceExceptionJson": "{\"errorCode\":\"ModelRefreshFailed_CredentialsNotSpecified\"}",
          "type": "Data"
        }
      ]
    }
  ]
}

In-progress refresh example

範例要求

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes?$top=1

範例回覆

狀態碼:
200 
{
  "value": [
    {
      "refreshType": "ViaApi",
      "startTime": "2017-06-13T09:25:43.153Z",
      "status": "Unknown",
      "requestId": "9399bb89-25d1-44f8-8576-136d7e9014b1"
    }
  ]
}

定義

名稱 Description
Refresh

Power BI 重新整理記錄專案
RefreshAttempt

如果數據集發生重新整理失敗，Power BI 會自動多次嘗試重新整理數據集。 此物件包含每個重新整理嘗試的相關信息。
RefreshAttemptType

重新整理嘗試的類型。
Refreshes

Power BI 重新整理記錄清單的 OData 回應包裝函式
RefreshType

重新整理要求的類型

Refresh

Object

Power BI 重新整理記錄專案

名稱 類型 Description
endTime

string (date-time)

重新整理的結束日期和時間（如果重新整理正在進行中則為空白），格式為 UTC 格式。
refreshAttempts

RefreshAttempt[]

重新整理嘗試清單。
refreshType

RefreshType

重新整理要求的類型
requestId

string

要求的重新整理識別碼。 在所有服務要求中提供此標識碼。
serviceExceptionJson

string

JSON 格式的失敗錯誤碼（如果沒有錯誤則為空白）
startTime

string (date-time)

以UTC格式重新整理的開始日期和時間。
status

string

  • 如果完成狀態未知或重新整理正在進行中，Unknown。
  • Completed 成功完成的重新整理。
  • Failed 失敗的重新整理（serviceExceptionJson 將包含錯誤碼）。
  • 如果選擇性重新整理已停用重新整理，Disabled。

RefreshAttempt

Object

如果數據集發生重新整理失敗，Power BI 會自動多次嘗試重新整理數據集。 此物件包含每個重新整理嘗試的相關信息。

名稱 類型 Description
attemptId

integer

重新整理嘗試的索引。
endTime

string (date-time)

重新整理嘗試的結束日期和時間。 如果重新整理嘗試正在進行中，此值會是 void。
serviceExceptionJson

string

JSON 格式的錯誤碼失敗。 如果沒有任何錯誤，則為 Void。
startTime

string (date-time)

重新整理嘗試的開始日期和時間。
type

RefreshAttemptType

重新整理嘗試的類型。

RefreshAttemptType

列舉型別

重新整理嘗試的類型。

值 Description
Data

重新整理嘗試將數據載入數據集。
Query

嘗試重新整理進階查詢快取和儀錶板磚.u

Refreshes

Object

Power BI 重新整理記錄清單的 OData 回應包裝函式

名稱 類型 Description
@odata.context

string

value

Refresh[]

重新整理記錄清單

RefreshType

列舉型別

重新整理要求的類型

值 Description
OnDemand

重新整理是透過Power BI入口網站以互動方式觸發的
OnDemandTraining

重新整理是透過Power BI入口網站以互動方式觸發的自動匯總訓練
Scheduled

重新整理是由數據集重新整理排程設定所觸發
ViaApi

重新整理是由 API 呼叫所觸發
ViaEnhancedApi

重新整理是由增強式重新整理 REST API 呼叫所觸發
ViaXmlaEndpoint

重新整理是透過Power BI公用 XMLA 端點觸發的