Aracılığıyla paylaş

Datasets - Get Refresh History

  • Başvuru
Hizmet:
Power BI REST APIs
API Sürümü:
v1.0

Çalışma alanım'dan belirtilen veri kümesinin yenileme geçmişini döndürür.

Gerekli Kapsam

Dataset.ReadWrite.All veya Dataset.Read.All

Sınırlamalar

OneDrive yenileme geçmişi döndürülmüyor.

Son 3 gün içindeki yenileme sayısına bağlı olarak her veri kümesi için her zaman 20-60 arasında kullanılabilir yenileme geçmişi girişi vardır.
En son 60, hepsi 3 günden azsa tutulur. 3 günden daha eski girdiler, 20'den fazla giriş olduğunda silinir. 

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes
İsteğe bağlı parametrelerle: 
GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes?$top={$top}

URI Parametreleri

Name İçinde Gerekli Tür Description
datasetId
 path True

string

Veri kümesi kimliği
$top
 query

integer

Yenileme geçmişinde istenen girdi sayısı. Sağlanmadıysa, varsayılan değer kullanılabilir son 60 giriştir.

Yanıtlar

Name Tür Description
200 OK

Refreshes

Tamam

Örnekler

Completed refresh example
Failed refresh example
In-progress refresh example

Completed refresh example

Örnek isteği

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

Örnek yanıt

Durum kodu:
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

Örnek isteği

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

Örnek yanıt

Durum kodu:
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

Örnek isteği

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

Örnek yanıt

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

Tanımlar

Name Description
Refresh

Power BI yenileme geçmişi girdisi
RefreshAttempt

Power BI, yenileme hatasıyla karşılaştığında otomatik olarak bir veri kümesini yenilemek için birden çok girişimde bulunur. Bu nesne her yenileme girişimi hakkında bilgi içerir.
RefreshAttemptType

Yenileme denemesinin türü.
Refreshes

Power BI yenileme geçmişi listesi için OData yanıt sarmalayıcısı
RefreshType

Yenileme isteğinin türü

Refresh

Power BI yenileme geçmişi girdisi

Name Tür Description
endTime

string

Yenilemenin bitiş tarihi ve saati (yenileme devam ederse boş olabilir)
refreshAttempts

RefreshAttempt[]

Yenileme denemesi listesi.
refreshType

RefreshType

Yenileme isteğinin türü
requestId

string

Yenileme isteğinin tanımlayıcısı. Bu tanımlayıcıyı tüm hizmet isteklerinde sağlayın.
serviceExceptionJson

string

JSON biçiminde hata hata kodu (hata yoksa boş)
startTime

string

Yenilemenin başlangıç tarihi ve saati
status

string

  • Unknown tamamlanma durumu bilinmiyorsa veya yenileme devam ediyorsa.
  • Completed başarıyla tamamlanan bir yenileme için.
  • Failed başarısız bir yenileme için (serviceExceptionJson hata kodunu içerir).
  • Disabled yenileme seçmeli yenileme tarafından devre dışı bırakılırsa.

RefreshAttempt

Power BI, yenileme hatasıyla karşılaştığında otomatik olarak bir veri kümesini yenilemek için birden çok girişimde bulunur. Bu nesne her yenileme girişimi hakkında bilgi içerir.

Name Tür Description
attemptId

integer

Yenileme denemesinin dizini.
endTime

string

Yenileme denemesinin bitiş tarihi ve saati. Yenileme denemesi devam ederse değer geçersiz olur.
serviceExceptionJson

string

JSON biçiminde hata hatası kodu. Hata yoksa geçersiz olur.
startTime

string

Yenileme denemesinin başlangıç tarihi ve saati.
type

RefreshAttemptType

Yenileme denemesinin türü.

RefreshAttemptType

Yenileme denemesinin türü.

Name Tür Description
Data

string

Yenileme işlemi veri kümesine veri yüklemeyi dener.
Query

string

Premium sorgu önbelleklerini ve pano kutucuklarını yenileme girişimi.u

Refreshes

Power BI yenileme geçmişi listesi için OData yanıt sarmalayıcısı

Name Tür Description
odata.context

string

value

Refresh[]

Yenileme geçmişi listesi

RefreshType

Yenileme isteğinin türü

Name Tür Description
OnDemand

string

Yenileme, Power BI portalı aracılığıyla etkileşimli olarak tetiklendi
OnDemandTraining

string

Yenileme, otomatik toplama eğitimiyle Power BI portalı üzerinden etkileşimli olarak tetiklendi
Scheduled

string

Yenileme, veri kümesi yenileme zamanlaması ayarı tarafından tetiklendi
ViaApi

string

Yenileme bir API çağrısı tarafından tetiklendi
ViaEnhancedApi

string

Yenileme, geliştirilmiş bir yenileme REST API çağrısı tarafından tetiklendi
ViaXmlaEndpoint

string

Yenileme, Power BI genel XMLA uç noktası aracılığıyla tetiklendi