Bagikan melalui

Datasets - Get Refresh History

  • Referensi
Layanan:
Power BI REST APIs
Versi API:
v1.0

Mengembalikan riwayat refresh untuk himpunan data yang ditentukan dari Ruang kerja saya.

Cakupan yang Diperlukan

Dataset.ReadWrite.All atau Dataset.Read.All

Batasan

Riwayat refresh OneDrive tidak dikembalikan.

Selalu ada antara 20–60 entri riwayat refresh yang tersedia untuk setiap himpunan data, tergantung pada jumlah refresh dalam 3 hari terakhir.
60 terbaru disimpan jika semuanya berusia kurang dari 3 hari. Entri yang berusia lebih dari 3 hari dihapus ketika ada lebih dari 20 entri. 

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes
Dengan parameter opsional: 
GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes?$top={$top}

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
datasetId
 path True

string

ID himpunan data
$top
 query

integer

Jumlah entri yang diminta dalam riwayat refresh. Jika tidak disediakan, defaultnya adalah 60 entri terakhir yang tersedia.

Respons

Nama Jenis Deskripsi
200 OK

Refreshes

OK

Contoh

Completed refresh example
Failed refresh example
In-progress refresh example

Completed refresh example

Permintaan sampel

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

Respon sampel

Kode status:
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

Permintaan sampel

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

Respon sampel

Kode status:
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

Permintaan sampel

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

Respon sampel

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

Definisi

Nama Deskripsi
Refresh

Entri riwayat refresh Power BI
RefreshAttempt

Power BI secara otomatis melakukan beberapa upaya untuk me-refresh himpunan data jika mengalami kegagalan refresh. Obyek ini berisi informasi tentang setiap upaya penyegaran.
RefreshAttemptType

Jenis upaya refresh.
Refreshes

Pembungkus respons OData untuk daftar riwayat refresh Power BI
RefreshType

Jenis permintaan refresh

Refresh

Entri riwayat refresh Power BI

Nama Jenis Deskripsi
endTime

string

Tanggal akhir dan waktu refresh (mungkin kosong jika refresh sedang berlangsung)
refreshAttempts

RefreshAttempt[]

Daftar upaya refresh.
refreshType

RefreshType

Jenis permintaan refresh
requestId

string

Pengidentifikasi permintaan refresh. Berikan pengidentifikasi ini di semua permintaan layanan.
serviceExceptionJson

string

Kode kesalahan kegagalan dalam format JSON (kosong jika tidak ada kesalahan)
startTime

string

Tanggal mulai dan waktu refresh
status

string

  • Unknown jika status penyelesaian tidak diketahui atau refresh sedang berlangsung.
  • Completed untuk refresh yang berhasil diselesaikan.
  • Failed untuk refresh yang gagal (serviceExceptionJson akan berisi kode kesalahan).
  • Disabled jika refresh dinonaktifkan oleh refresh selektif.

RefreshAttempt

Power BI secara otomatis melakukan beberapa upaya untuk me-refresh himpunan data jika mengalami kegagalan refresh. Obyek ini berisi informasi tentang setiap upaya penyegaran.

Nama Jenis Deskripsi
attemptId

integer

Indeks upaya refresh.
endTime

string

Tanggal akhir dan waktu upaya refresh. Nilai batal jika upaya refresh sedang berlangsung.
serviceExceptionJson

string

Kode kesalahan kegagalan dalam format JSON. Batalkan jika tidak ada kesalahan.
startTime

string

Tanggal mulai dan waktu upaya refresh.
type

RefreshAttemptType

Jenis upaya refresh.

RefreshAttemptType

Jenis upaya refresh.

Nama Jenis Deskripsi
Data

string

Refresh mencoba memuat data ke dalam himpunan data.
Query

string

Upaya untuk menyegarkan cache kueri premium dan petak dasbor.u

Refreshes

Pembungkus respons OData untuk daftar riwayat refresh Power BI

Nama Jenis Deskripsi
odata.context

string

value

Refresh[]

Daftar riwayat refresh

RefreshType

Jenis permintaan refresh

Nama Jenis Deskripsi
OnDemand

string

Refresh dipicu secara interaktif melalui portal Power BI
OnDemandTraining

string

Refresh dipicu secara interaktif melalui portal Power BI dengan pelatihan agregasi otomatis
Scheduled

string

Refresh dipicu oleh pengaturan jadwal refresh himpunan data
ViaApi

string

Refresh dipicu oleh panggilan API
ViaEnhancedApi

string

Refresh dipicu oleh panggilan REST API refresh yang disempurnakan
ViaXmlaEndpoint

string

Refresh dipicu melalui titik akhir XMLA publik Power BI