Share via

Datasets - Get Refresh History In Group

  • Başvuru
Service:
Power BI REST APIs
API Version:
v1.0

Belirtilen çalışma alanından belirtilen veri kümesinin yenileme geçmişini döndürür.

İzinler

Bu API çağrısı bir hizmet sorumlusu profili tarafından çağrılabilir. Daha fazla bilgi için bkz. Power BI Embedded hizmet sorumlusu profilleri.

Gerekli Kapsam

Dataset.ReadWrite.All veya Dataset.Read.All

Sınırlamalar

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

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}

URI Parametreleri

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

string

Veri kümesi kimliği
groupId
 path True

string

uuid

Çalışma alanı 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

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"
    }
  ]
}

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 yenilemeye yönelik 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 yenilemeye yönelik 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 hata 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, 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ı üzerinden etkileşimli olarak tetiklendi
OnDemandTraining

string

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

string

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

string

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

string

Yenileme, gelişmiş bir yenileme REST API çağrısıyla tetiklendi
ViaXmlaEndpoint

string

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