Bagikan melalui

Datasets - Get Refresh History In Group

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

Mengembalikan riwayat refresh untuk himpunan data yang ditentukan dari ruang kerja yang ditentukan.

Izin

Panggilan API ini dapat dipanggil oleh profil perwakilan layanan. Untuk informasi selengkapnya lihat: Profil perwakilan layanan di Power BI Embedded.

Cakupan yang Diperlukan

Dataset.ReadWrite.All atau Dataset.Read.All

Batasan

Riwayat refresh OneDrive tidak dikembalikan. 

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/refreshes
With optional parameters: 
GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/refreshes?$top={$top}

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
datasetId
 path True

string

ID himpunan data
groupId
 path True

string

uuid

ID ruang kerja
$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

Sample Request

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

Sample Response

Status code:
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

Sample Request

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

Sample Response

Status code:
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

Sample Request

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

Sample Response

Status code:
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 merefresh himpunan data jika mengalami kegagalan refresh. Obyek ini memuat 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 dan waktu mulai 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 merefresh himpunan data jika mengalami kegagalan refresh. Obyek ini memuat 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 dan waktu mulai 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