次の方法で共有

Datasets - Get Refresh History

  • リファレンス
サービス:
Power BI REST APIs
API バージョン:
v1.0

[マイ ワークスペース]から、指定したデータセット 更新履歴を返します。

必要なスコープ

Dataset.ReadWrite.All または Dataset.Read.All

制限

OneDrive の更新履歴は返されません。

過去 3 日間の更新の数に応じて、データセットごとに 20 から 60 個の更新履歴エントリが常に存在します。
最新の 60 は、すべて 3 日未満の場合に保持されます。 3 日を超えるエントリは、20 を超えるエントリがある場合に削除されます。 

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 パラメーター

名前 / 必須 型 説明
datasetId
 path True

string

データセット ID
$top
 query

integer

minimum: 1

更新履歴で要求されたエントリの数。 指定しない場合、既定値は最後に使用可能な 60 個のエントリです。

応答

名前 型 説明
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"
    }
  ]
}

定義

名前 説明
Refresh

Power BI の更新履歴エントリ
RefreshAttempt

Power BI では、更新エラーが発生した場合に、データセットの更新が複数回試行されます。 このオブジェクトには、各更新の試行に関する情報が含まれています。
RefreshAttemptType

更新の試行の種類。
Refreshes

Power BI 更新履歴リストの OData 応答ラッパー
RefreshType

更新要求の種類

Refresh

Object

Power BI の更新履歴エントリ

名前 型 説明
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 では、更新エラーが発生した場合に、データセットの更新が複数回試行されます。 このオブジェクトには、各更新の試行に関する情報が含まれています。

名前 型 説明
attemptId

integer

更新の試行のインデックス。
endTime

string (date-time)

更新の試行の終了日時。 更新の試行が進行中の場合、値は void です。
serviceExceptionJson

string

JSON 形式のエラー エラー コード。 エラーがない場合は Void。
startTime

string (date-time)

更新の試行の開始日時。
type

RefreshAttemptType

更新の試行の種類。

RefreshAttemptType

列挙

更新の試行の種類。

値 説明
Data

更新によってデータセットにデータが読み込まれます。
Query

Premium クエリ キャッシュとダッシュボード タイルの更新の試行。u

Refreshes

Object

Power BI 更新履歴リストの OData 応答ラッパー

名前 型 説明
@odata.context

string

value

Refresh[]

更新履歴の一覧

RefreshType

列挙

更新要求の種類

値 説明
OnDemand

Power BI ポータルを使用して対話形式で更新がトリガーされました
OnDemandTraining

更新は、自動集計トレーニングを使用して Power BI ポータルを介して対話形式でトリガーされました
Scheduled

データセットの更新スケジュール設定によって更新がトリガーされました
ViaApi

更新は API 呼び出しによってトリガーされました
ViaEnhancedApi

更新は、強化された更新 REST API 呼び出しによってトリガーされました
ViaXmlaEndpoint

Power BI パブリック XMLA エンドポイントを介して更新がトリガーされました